Metadata-Version: 1.0
Name: shelldon
Version: 0.0.1
Summary: UNKNOWN
Home-page: UNKNOWN
Author: Maverick Chan
Author-email: UNKNOWN
License: MIT
Description: Shelldon
        ========
        
        ###Python-wrapper of Bash (whut)
        
        
        Table of Content
        ----------------
        - [Introduction](#intro)
        - [Installation](#install)
        - [Usage](#usage)
        - [License](#license)
        - [Support](#support)
        
        Introduction<a name='intro'></a>
        --------------------------------
        Whuttttt. A Python-wrapper for Bash? You know how you want to sometimes make some shell commands from Python? And then you go for:
        
        ```python
        import subprocess
          
        # Normally you do this from a Python script
        subprocess.call(['git', 'add', '--all']
        ```
        
        I find that way, way too much to type. Also, why put it into a form of a list?
        
        Why can't we just write `subprocess.call('git add --all')`?
        
        Installation<a name='install'></a>
        ----------------------------------
        Just install the Raw shelldon.py. Then, add it to your Python Path, like this:
        ```shell
        export PYTHONPATH=$PYTHONPATH:/~/path/to/the/shelldon.py
        ```
        
        Test it by opening your Python shell.
        
        ```
        >>> import shelldon
        >>> # It works!
        ```
        
        Usage<a name='usage'></a>
        -------------------------
        **Normal script use:**
        ```python
        import shelldon
        
        shelldon.call('git add --all') # So simple isn't it?!
        ```
        
        **Or, if you want to have multiple commands bundled together:**
        ```python
        shelldon.call("""
                      git add --all
                      git commit -m 'Initial commit'
                      git push origin master
                      """)
        ```
        
        **Terminal use:**
        ```python
        >> import shelldon
        >> shelldon.terminal()
        ~$ >> ls
        Desktop         Programs
        Documents       Public
        Downloads
        Music
        Pictures
        ~$ >> cd Desktop
        ~/Desktop$ >> quit # Use this command to quit shelldon's terminal
        >> print 'yay to using shell in Python!' # Back to Python interpreter
        ```
        
        License<a name='license'></a>
        -----------------------------
        The following code is released under the MIT license. See above for it.
        
        Support<a name='support'></a>
        -----------------------------
        If you have any questions/concerns, please feel free to contact me.
        My email address is guanhao3797@gmail.com
        
        **Will update README once project is more substantial.**
        
Platform: UNKNOWN
