subproces
Ознайомтеся з нашим покроковим посібником із виконання зовнішніх команд за допомогою модуля підпроцесів subprocess разом із прикладами
Ви можете використовувати модуль subprocess
Python для створення нових процесів, підключення до їх входу та виходу та отримання їхніх кодів повернення та/або виводу процесу. У цій статті ми розглянемо основи модуля subprocess
, зокрема те, як запускати зовнішні команди, перенаправляти вхідні та вихідні дані та обробляти помилки. Незалежно від того, початківець ви чи досвідчений розробник Python, цей підручник надасть вам знання, необхідні для ефективного використання модуля підпроцесу у ваших проектах.
What is Python Subprocess
Модуль subprocess
Python — це інструмент, який дозволяє запускати інші програми або команди з вашого коду Python. Його можна використовувати для відкриття нових програм, надсилання їм даних і отримання результатів.
Це як надавати команди своєму комп’ютеру за допомогою Python замість того, щоб вводити їх безпосередньо в командний рядок. Цей модуль дозволяє легко автоматизувати завдання та інтегрувати інші програми з вашим кодом Python.
Наприклад, ви можете використовувати модуль subprocess
, щоб запустити команду оболонки, наприклад ls
або ping
, і отримати результат цієї команди у своєму коді Python. Ви також можете використовувати його для запуску інших сценаріїв Python або виконуваних файлів, як-от файлів .exe
у Windows.
Крім того, модуль subprocess
може перенаправляти вхідні та вихідні дані процесу, тобто ви можете контролювати, які дані надсилаються процесу та які дані отримуються від нього.
Однією з найбільш корисних можливостей модуля підпроцесу є те, що він дозволяє користувачеві обробляти вхідні дані, виходи та навіть помилки, які генеруються дочірнім процесом із коду Python.
Ця функція вважається однією з найпотужніших аспектів модуля. Завдяки цій функції тепер можна зробити процес виклику підпроцесів більш потужним і універсальним. Наприклад, тепер можна використовувати вихідні дані підпроцесу як змінну в решті сценарію Python.
У цьому підручнику ми дізнаємося, як використовувати модуль subprocess
для запуску інших програм із нашого коду Python, як надсилати їм дані та як повертати результати. Це буде корисно як початківцям, так і досвідченим розробникам Python.
Коли використовувати subprocess
Автоматизація системних завдань
Модуль підпроцесу можна використовувати для автоматизації різних системних завдань, таких як запуск резервних копій, запуск і зупинка служб і планування завдань cron. Наприклад, ви можете використовувати модуль subprocess для запуску команди cp
для створення резервної копії файлу або команди service
для запуску та зупинки служб у системах Linux.
Ви також можете використовувати модуль підпроцесу для планування виконання завдань через певні проміжки часу за допомогою cron або інших інструментів планування.
Запуск інструментів командного рядка
Модуль subprocess
можна використовувати для запуску інструментів командного рядка, таких як grep, sed і awk, і обробки їх виводу у вашому коді Python. Наприклад, ви можете використовувати модуль підпроцесу, щоб запустити команду grep
для пошуку певного шаблону у файлі, а потім обробити вихід у вашому коді Python. Це може бути корисним для таких завдань, як аналіз журналів, обробка даних і маніпулювання текстом.
Запуск зовнішніх виконуваних файлів
The subprocess module can run other executables, such as .exe files on Windows, and control their behavior. For example, you can use the subprocess module to run an executable that performs a specific task and then use the output of that executable in your own code. This can be useful for image processing, data analysis, and machine learning tasks.
Running scripts as background processes
You can use the subprocess module to run scripts as background processes so that they continue running after the main program exits. For example, you can use the subprocess module to run a script that performs a specific task and exit the main program without waiting for the script to complete. This can be useful for monitoring, logging, and data collection.
Running scripts with non-Python interpreter
The subprocess module can help you run scripts written in other languages like Perl, Ruby, and Bash. For example, you can use the subprocess module to run a Perl script that performs a specific task and then use the output of that script in your own code. This can be useful for data processing, text manipulation, and system administration.
Parallel processing
The subprocess module can be used to run multiple processes in parallel, which can be useful for tasks such as image processing, data analysis, and machine learning. For example, you can use the subprocess module to run multiple instances of the same script, each processing a different part of the data and then combine the results.
Python Subprocess Examples
subprocess.run()
Метод subprocess.run()
— це зручний спосіб запустити підпроцес і дочекатися його завершення. Він дозволяє вибрати команду для запуску та додати такі параметри, як аргументи, змінні середовища та переспрямування введення/виведення. Після запуску підпроцесу метод run()
блокується, доки підпроцес не завершиться та не поверне об’єкт CompletedProcess, який містить код повернення та вихідні дані підпроцесу.
The subprocess.run()
method takes several arguments, some of which are:
args
: The command to run and its arguments, passed as a list of strings.capture_output
: When set to True, will capture the standard output and standard error.text
: When set to True, will return the stdout and stderr as string, otherwise as bytes.check
: a boolean value that indicates whether to check the return code of the subprocess, if check is true and the return code is non-zero, then subprocess `CalledProcessError` is raised.timeout
: A value in seconds that specifies how long to wait for the subprocess to complete before timing out.shell
: A boolean value that indicates whether to run the command in a shell. This means that the command is passed as a string, and shell-specific features, such as wildcard expansion and variable substitution, can be used.
The subprocess.run() method також повертає об’єкт CompletedProcess, який містить такі атрибути:
args
: The command and arguments that were run.returncode
: The return code of the subprocess.stdout
: The standard output of the subprocess, as a bytes object.stderr
: The standard error of the subprocess, as a bytes object.
Example 1: Running shell commands:
Output:
Linux or mac users replace “dir” to “ls” and get rid of the `shell` argument.
Example 2: Running Python scripts:
Ви також можете запустити сценарій python за допомогою методу subprocess.run(). Почнемо зі створення простого сценарію Python у файлі .py
Save this file as `my_python_file.py`
Now you can use subprocess module to run this file:
Output:
Example 3: Running Python code directly from a function:
For simple use-cases, you can directly pass a python command in the subprocess.run() function. Here is how:
Output:
In the args
list, the first element `C:/Users/owner/anaconda3/python` is a path to executable Python (your path may be different). The second element, `-c` is a Python tag that allows the user to write Python code as text to the command line. The third element, `print(...)` is the Python command itself.
Example 4: Using the check argument
The check argument is an optional argument of the subprocess.run() function in the Python subprocess module. It is a boolean value that controls whether the function should check the return code of the command being run.
When check is set to True, the function will check the return code of the command and raise a CalledProcessError exception if the return code is non-zero. The exception will have the return code, stdout, stderr, and command as attributes.
When check is set to False (default), the function will not check the return code and will not raise an exception, even if the command fails.
Output:
Notice that the command failed because `file_donot_exist.py` does not exist. As opposed to when you set `check=True`, your process won’t fail; instead, you will get the error message in `stdout`.
Output:
python subprocess Popen
`subprocess.Popen` is a lower-level interface to running subprocesses, while subprocess.run is a higher-level wrapper around Popen that is intended to be more convenient to use.
Popen allows you to start a new process and interact with its standard input, output, and error streams. It returns a handle to the running process that can be used to wait for the process to complete, check its return code, or terminate it.
run is a more convenient function that allows you to run a command and capture its output in a single call, without having to create a Popen object and manage the streams yourself. It also allows you to specify various options for running the command, such as whether to raise an exception if the command fails.
In general, you should use run if you just need to run a command and capture its output and Popen if you need more control over the process, such as interacting with its input and output streams.
The Popen class takes the same arguments as run(), including the args that specify the command to be run and other optional arguments such as stdin, stdout, stderr, shell, cwd, and env.
The Popen class has several methods that allow you to interact with the process, such as communicate(), poll(), wait(), terminate(), and kill().
Output:
This will run the command `python –help` and create a new Popen object, which is stored in the variable p. The standard output and error of the command are captured using the communicate() method and stored in the variables output and errors, respectively.
`subprocess.Popen` is useful when you want more control over the process, such as sending input to it, receiving output from it, or waiting for it to complete.
python subprocess call
`subprocess.call()` is a function in the Python subprocess module that is used to run a command in a separate process and wait for it to complete. It returns the return code of the command, which is zero if the command was successful, and non-zero if it failed.
The call() function takes the same arguments as run(), including the args which specify the command to be run, and other optional arguments, such as stdin, stdout, stderr, shell, cwd, and env.
The standard output and error of the command are sent to the same stdout and stderr as the parent process unless you redirect them using stdout and stderr arguments.
Output:
This will run the command `python –version` in a separate process and wait for it to complete. The command's return code will be stored in the return_code variable, which will be zero if the command was successful, and non-zero if it failed.
subprocess.call() is useful when you want to run a command and check the return code, but do not need to capture the output.
python subprocess check_output
check_output
— це функція в модулі підпроцесу, подібна до run()
, але вона повертає лише стандартний вихід команди та викликає виняток CalledProcessError
, якщо код повернення ненульовий.
The check_output
функція приймає ті самі аргументи, що й run()
, включаючи аргументи, які вказують команду, яку потрібно виконати, та інші додаткові аргументи, такі як stdin, stderr, shell, cwd, and env.
Функція check_output
повертає стандартний вихід команди як об’єкт bytes або рядок, якщо передається text=True
.
Output:
Python Subprocess Pipe
Python subprocess module provides a way to create and interact with child processes, which can be used to run other programs or commands. One of the features of the subprocess module is the ability to create pipes, which allow communication between the parent and child processes.
A pipe is a unidirectional communication channel that connects one process's standard output to another's standard input. A pipe can connect the output of one command to the input of another, allowing the output of the first command to be used as input to the second command.
Pipes can be created using the subprocess module with the Popen class by specifying the stdout or stdin argument as subprocess.PIPE.
For example, the following code creates a pipe that connects the output of the ls command to the input of the grep command, which filters the output to show only the lines that contain the word "file":
Output:
In this example, the Popen class is used to create two child processes, one for the ls command and one for the grep command. The stdout of the ls command is connected to the stdin of the grep command using subprocess.PIPE, which creates a pipe between the two processes. The communicate() method is used to send the output of the ls command to the grep command and retrieve the filtered output.
Conclusion
The Python `subprocess` module provides a powerful and flexible way to create and interact with child processes, allowing you to run other programs or issue commands from within your Python script. From simple commands like subprocess.call() to more advanced features like pipes, redirecting input and output, and passing environment variables, the subprocess module has something to offer for almost every use case. It is a great way to automate repetitive tasks, run system commands, and even interact with other programming languages and platforms.
While working with the subprocess module, it's important to remember that running external commands poses a security risk, especially when using the shell=True parameter or passing unsanitized input. It's always a good practice to use the subprocess.run() function that allows you to specify various options for how the command should be run, such as whether to raise an exception if the command fails.
If you are interested in doing a deep dive into endless possibilities for command line automation through Python, check out our Command Line Automation in Python course. In this course, you will learn to write an automation code that will browse a filesystem, look for files that follow a pattern, and then determine whether files are duplicates in one of the numerous cases. After finishing the course, you'll be able to manage and interact with Unix processes as well as automate a variety of routine file system activities.
Python Subprocess FAQs
What is the difference between subprocess.call() and subprocess.run()?
subprocess.call() is a function that runs a command and waits for it to complete, returning the return code of the command. subprocess.run() is a more powerful function that allows you to run a command, capture its output, and specify various options for how the command should be run, such as whether to raise an exception if the command fails.
How can I run a command and capture its output in Python using subprocess?
You can use the subprocess.run() function to run a command and capture its output in a single call. For example, the following code runs the "ls" command and captures its output in the "result" variable:
How can I pass variables as arguments to a command in a subprocess?
You can pass variables as arguments to a command in the subprocess by including them in the list passed to the subprocess.run() or subprocess.Popen() functions. For example, the following code runs the "echo" command and passes the value of the "message" variable as an argument:
How can I redirect the output of a command to a file using subprocess?
You can redirect the output of a command to a file using the ">" operator in the command. For example, the following code runs the "ls" command and redirects its output to a file named "ls.txt":
How can I run a command in the background using subprocess?
You can run a command in the background by setting the start_new_session parameter to True when creating a new process using subprocess.Popen(). This will create a new process group, allowing you to run the command in the background.
How can I check the return code of a command run using subprocess?
You can check the return code of a command by accessing the returncode attribute of the subprocess.CompletedProcess object returned by subprocess.run(). For example, the following code runs the "ls" command and checks its return code:
How can I pass environment variables to a command run using subprocess?
You can pass environment variables to a command by including them in a dictionary and passing that dictionary as the env parameter when creating a new process using subprocess.Popen() or subprocess.run(). For example, the following code sets the "TEST_VAR" environment variable and runs the "printenv" command:
Last updated