by amoffat

Python process launching

5.5K Stars 431 Forks Last release: Not found MIT License 1.2K Commits 50 Releases

Available items

5 consulting hours

Developer services

.. image:: :target: :alt: Logo


.. image:: :target: :alt: Version .. image:: :target: :alt: Downloads Status .. image:: :target: :alt: Python Versions .. image:: :target: :alt: Build Status .. image:: :target: :alt: Coverage Status


sh is a full-fledged subprocess replacement for Python 2.6 - 3.8, PyPy and PyPy3 that allows you to call any program as if it were a function:

.. code:: python

from sh import ifconfig

sh is not a collection of system commands implemented in Python.

Complete documentation here 



$> pip install sh


  • Andrew Moffat 
    _ - author/maintainer
  • Erik Cederstrand 
    _ - maintainer


Updating the docs

Check out the

_ branch and follow the


I've included a Docker test suite in the

folder. To build the image,
into that directory and run::
$> ./

This will install ubuntu 18.04 LTS and all python versions from 2.6-3.8. Once it's done, stay in that directory and run::

$> ./

This will mount your local code directory into the container and start the test suite, which will take a long time to run. If you wish to run a single test, you may pass that test to

$> ./ FunctionalTests.test_unicode_arg

To run a single test for a single environment::

$> ./ -e 3.4 FunctionalTests.test_unicode_arg


First run all of the tests::

$> python test

This will aggregate a

. You may then visualize the report with::
$> coverage report

Or generate visual html files with::

$> coverage html

Which will create

that you may open in a web browser.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.