Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Python to shell script transcompiler

Project Description

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

한국어로 보기

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 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 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
  • command package
  • documentation
  • support windows batch and powershell script
  • more test…

License

  • MIT © 2017 Luavis
  • Icon designed by cyoh, Sherlock Holmes graphic by Matthew Davis from the Noun Project
Release History

Release History

This version
History Node

0.3.0

History Node

0.2.0

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sherlock.py-0.3.0.tar.gz (12.2 kB) Copy SHA256 Checksum SHA256 Source Feb 16, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting