Metadata-Version: 2.1
Name: runcmd
Version: 0.0.3
Summary: run command
Home-page: https://github.com/looking-for-a-job/runcmd.py
License: UNKNOWN
Description: [![](https://img.shields.io/pypi/pyversions/runcmd.svg?longCache=True)](https://pypi.org/pypi/runcmd/)
        
        ### Install
        ```bash
        $ [sudo] pip install runcmd
        ```
        
        ### Examples
        ```python
        >>> import runcmd
        >>> r = runcmd.run(["echo", "hello world"])
        >>> r.code  # exit status code
        0
        >>> r.out  # stdout
        'hello world'
        >>> r.err  # stderr
        ''
        >>> r.pid  # process pid
        1234
        ```
        
        background - add `background=True`
        ```python
        >>> r = runcmd.run(["sleep","5"],background=True)
        >>> while r.running:  # True if process is running and not "zombie process"
        >>>     print("running")
        ```
        
        `_raise()` - raise exception if code is not `0`
        ```python
        >>> runcmd.run(["ls"])._raise()             # code 0, ok
        >>> runcmd.run(["mkdir", "/"])._raise()      # code 1, error
        ...
        OSError: exited with code 1
        mkdir: /: Is a directory
        ```
        
        `ok` - `True` if code is `0`
        ```python
        >>> if r.ok:
        ```
        
        `text` - out+err
        ```python
        >>> r.text
        ```
Keywords: run command
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development
Description-Content-Type: text/markdown
