sherlock.py: A Python repository from Luavis

Sherlock.py is transpiler that translate python to bash shell script language.

Contents

Motivation
Install
Usage
Library
Todo
License

Motivation

< Ditective who program with Shell script >

Shell script is well known script language which is used in most of unix-like OS. Shell script lanuage garuntee to run in most unix-like OS. So many software developers are using this language when they program install script or configuration script. Because this language is really old, There are several problems. and it is hard to maintain program which is writted by shell script language.

Install

$ pip install sherlock.py

Sherlock.py supports python version over 2.6 or 3.3. and support linux and macOS. If there is error in install please write issue.

Usage

usage: sherlock [-h] [-o output] [-c] [-v] [--version] [file | command]

Python to bash trans-compiler.

positional arguments:
  [file | command]  program read from script file

optional arguments:
  -h, --help        show this help message and exit
  -o output         output file path
  -c, --command     program passed in as string
  -v, --verbose     program run in verbose mode
  --version         show program's version number and exit

Following is basic usage.

$ sherlock target.py

Using this command, target.py file is translated into bash shell sciprt. after, it is automatically run with sh. We can find out bug from the running result.

$ sherlock target.py -o output.sh

Using -o flag, you can save sherlock result in file. In this case script isn't run automatically.

$ sherlock -c "echo 'Hello World.'"

Using -c flag, input command is immediately translated to bash shell script language and executed.

If you want to details. Please check sample codes

Library

sherlock.cmd package

You can use general shell command importing from sherlock.cmd. When you import package, it check user already installed command and create wrap function which return stdout output.

from sherlock.cmd import ls
ls('-al')

pipe function

In shell script, you can combine command with | operator. To do same thing in python, Sherlock.py support pipe function.

from sherlock.cmd import wc
pipe(print('./test'), wc('-c'))

Todo

import syntax
support ksh/POSIX-strict
command package
documentation
support windows batch and powershell script
more test...

License