If you are migrating from 1.* to 2.*, please see MIGRATION.md
sh is a full-fledged subprocess replacement for Python 3.8 - 3.10, PyPy and PyPy3 that allows you to call any program as if it were a function:
from sh import ifconfig
print(ifconfig("eth0"))
sh is not a collection of system commands implemented in Python.
sh relies on various Unix system calls and only works on Unix-like operating systems - Linux, macOS, BSDs etc. Specifically, Windows is not supported.
Installation
$> pip install sh
Support
Andrew Moffat - author/maintainer
Erik Cederstrand - maintainer
Developers
Updating the docs
Check out the gh-pages branch and follow the README.rst there.
Testing
Tests are run in a docker container against all supported Python versions. To run, make the following target:
$> make test
To run a single test:
$> make test='FunctionalTests.test_background' test_one
Coverage
First run all of the tests:
$> SH_TESTS_RUNNING=1 coverage run --source=sh -m unittest
This will aggregate a .coverage. You may then visualize the report with:
$> coverage report
Or generate visual html files with:
$> coverage html
Which will create ./htmlcov/index.html that you may open in a web browser.
Release files for sh 2.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sh-2.0.3.tar.gz | 345.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sh-2.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 383.7 kB
Release files / sh-2.0.3.tar.gz
| Download URL | sh-2.0.3.tar.gz |
|---|---|
| Size | 345.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
800efeda403b63879b0a5625f65a0021fd1ea61ed181954da0346372a7b2a341
|
|
BLAKE2b-256 checksum How to use checksums |
b79618aa20a143e2eaf1f0b4ae41a5ec57fd45b76b4a76cc4a07ffb476161ae3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.2
|
Release files / sh-2.0.3-py3-none-any.whl
| Download URL | sh-2.0.3-py3-none-any.whl |
|---|---|
| Size | 38.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
351f8968a2ed99755665fef62f038d60b5245999d73c2f1b1705f48b22e2a853
|
|
BLAKE2b-256 checksum How to use checksums |
06dd13b1cd87bfcd54e664304718535b33ce93a6ef2ebddb00f8ed0b743d90b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.2
|