subprocess.run()

System

Runs a command as a subprocess and waits for it to complete.

Signature

subprocess.run(args, capture_output=False)

Returns

CompletedProcess

Example

import subprocess
result = subprocess.run(
    ['ls', '-la'],
    capture_output=True, text=True
)
print(result.stdout)

About subprocess.run()

subprocess.run is a Python system function with the signature subprocess.run(args, capture_output=False). Runs a command as a subprocess and waits for it to complete. It returns a value of type CompletedProcess.

Python provides a rich set of built-in functions and standard library modules that cover common programming tasks. Understanding these functions helps you write more idiomatic, efficient Python code. The subprocess.runfunction is commonly used in data processing, web development, scripting, and automation tasks.

When working with subprocess.run(), consider edge cases like empty inputs, None values, and type mismatches. Python's duck typing means many built-in functions work with any object that implements the required protocol (e.g., __len__ for len(), __iter__ for iteration). This flexibility is a key strength of Python's design philosophy.

Related Functions

os.path.join()open()os.listdir()exec()