Skip to content
Home » Python: run shell commands using the subprocess package

Python: run shell commands using the subprocess package


In this article, you’ll learn how to execute shell commands using the subprocess package in Python.

This article is part of a two-part series related to running shell commands from within Python.

As I explained in part 1 of this series, the popen method of the os package uses the subprocess package to run shell commands. In this article, we’ll use the subprocess package ourselves.

The popen method of the subprocess package executes a child program in a new subprocess. This process can then be accessed (i.e.) via the communicate method. This method waits for the process to finish and finally prints the stdout and stderr as a tuple.

import subprocess
process = subprocess.Popen(['echo', '"Hello World!"'],
                     stdout = subprocess.PIPE, 
                     stderr = subprocess.PIPE,
                     text = True,
                     shell = True)
std_out, std_err = process.communicate()
std_out.strip(), std_err

❗ If you don’t set the shell parameter to True for the echo command, you’ll run into the following error:

FileNotFoundError: [WinError 2] The system cannot find the file specified

This is because the command/program takes arguments. Running the Popen method requires that you specify a single string (the path to the program), or explicitly set shell to True if your command contains spaces (e.g. arguments).

Instead of waiting for a command to finish, you could also use poll(). This method checks if a process is finished. The following script will run a command (in this case ping) and keep printing the output if it hasn’t finished. If an error is encountered, it will print the process exit code and the error message.

process = subprocess.Popen(['ping', ''], 
                           stdout = subprocess.PIPE,
                           stderr = subprocess.PIPE,
                           text = True,
                           shell = True)

while True:
    output = process.stdout.readline().strip()
    if output != '':
    return_code = process.poll()
    if return_code is not None:
        print(f'Returned the following return code: {return_code}')
        for std_output in process.stdout.readlines():
        for std_err in process.stderr.readlines():

Finally, if splitting your command in separate strings is too cumbersome, use the split function of the shlex package.

import shlex
import subprocess
shell_cmd = shlex.split('echo "Hello, World!"')

import subprocess
process = subprocess.Popen(shell_cmd,
                     stdout = subprocess.PIPE, 
                     stderr = subprocess.PIPE,
                     text = True,
                     shell = True
std_out, std_err = process.communicate()
std_out.strip(), std_err

Great success!

Say thanks, ask questions or give feedback

Technologies get updated, syntax changes and honestly… I make mistakes too. If something is incorrect, incomplete or doesn’t work, let me know in the comments below and help thousands of visitors.

5 thoughts on “Python: run shell commands using the subprocess package”

  1. Helloǃ
    Pеrhaрs mу mеsѕаge іѕ tоo speсіfіc.
    Βut my оlder sіster found a wondеrful mаn hеrе аnd theу have а great rеlatіоnѕhір, but whаt abоut mе?
    I аm 23 yеаrs old, Νatаliа, frоm thе Czech Reрubliс, knоw Εnglіsh languagе alsо
    And… bеttеr tо sаy it immediatеly. Ι аm bіѕеxuаl. Ι am not jeаlouѕ оf аnоther woman… еspeciаllу іf we make lovе togethеr.
    Ah yeѕ, I cоok vеrу tastу! and Ι love nоt оnlу cооk ;))
    Ιm reаl girl and loоking fоr sеrіouѕ and hоt relаtiоnshіp…
    Αnywaу, уоu сan fіnd my рrоfіle here:

  2. Hеllo!
    I арolоgіzе fоr thе overlу sрecifіc mеssаgе.
    Μy gіrlfrіend аnd Ι lоve еасh othеr. Аnd we аre all greаt.
    But… we neеd а man.
    Ԝе are 28 уеarѕ old, from Rоmаnіa, we also knоw englіѕh.
    Ԝе nеver get bоrеd! Аnd nоt оnlу in talk…
    Μy name іs Саtherinа, mу prоfilе іѕ hеrе:

  3. Ηiǃ
    Ι’vе nоtiсed thаt manу guyѕ рrеfеr rеgular girls.
    Ι aррlаudе thе men оut thеrе who hаd the ballѕ tо еnϳоy the lоve оf manу women аnd chооse thе оne that he knew wоuld be his bеst frіеnd during thе bumpy and сrаzy thіng саllеd life.
    I wаntеd tо bе that friеnd, nоt just а ѕtablе, rеliаble and bоrіng hоusewifе.
    I аm 24 уeаrѕ old, Каrina, from thе Czесh Reрublіc, knоw Εnglіѕh lаnguаgе аlsо.
    Αnywaу, you can fіnd my рrоfіle here:

Leave a Reply

Your email address will not be published. Required fields are marked *