Metadata-Version: 2.1
Name: shellshock
Version: 0.0.1
Summary: Write your shell scripts using Python
Home-page: https://github.com/mattdodge/shellshock
Author: Matt Dodge
Author-email: mattedgod@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Description-Content-Type: text/markdown

<p align="center">
<img src="logo.png" />
<em><strong>Write and test your shell scripts using Python</strong></em>
</p>
<hr/>
Shell scripts are great - they run on most *nix machines, they allow you interact with the file system easily, and they are light weight and don't require a massive runtime. However, the syntax is error prone and they are difficult to manage and test. Shellshock lets you write and test your shell scripts using the Python syntax and test cases you already know and love.

## Installation

Writing with Shellshock requires Python. The shell scripts it outputs do not require Python to run though.
```bash
pip install shellshock
```

## Usage
To convert a Python shellshock script to a regular shell script:
```bash
shellshock my_script.py -o my_script.sh
```

## Starting with an existing shell script
Let's say you have an existing shell script you want to convert that looks like this:

**oldscript.sh**
```bash
if [ -f "file" ]; then
  echo "ok"
fi
```

You can easily make this a shellshock script using the `ss.shell` method and a multiline string at the top of the file:

**oldscript.py**
```python
import shellshock as ss
ss.shell("""
if [ -f "file" ]; then
  echo "ok"
fi
""")
```

Then you could convert it to full Python shellscript syntax like so:

**newscript.py**
```python
import shellshock as ss
if ss.isfile("file"):
    print("ok")
```


