17.1.1.1 Convenience Functions

17.1.1.1 Convenience Functions

This module also defines two shortcut functions:

call(

*popenargs, **kwargs)

Run command with arguments. Wait for command to complete, then return the returncode attribute.

The arguments are the same as for the Popen constructor. Example:

    retcode = call(["ls", "-l"])

check_call(

*popenargs, **kwargs)

Run command with arguments. Wait for command to complete. If the exit code was zero then return, otherwise raise CalledProcessError. The CalledProcessError object will have the return code in the returncode attribute.

The arguments are the same as for the Popen constructor. Example:

    check_call(["ls", "-l"])

---

Python Library Reference

Previous: 17.1.1 Using the subprocess Up: 17.1.1 Using the subprocess Next: 17.1.1.2 Exceptions

---

Release 2.5, documentation updated on 19th September, 2006.