An easy and Pythonic way to create your POSIX command line interface
Project description
An easy and Pythonic way to create your POSIX command line
View on: HomePage / GitHub / PyPi
ChangeLog
version 0.2.3:
[fix] when “Usage” stack as -a<val> and “Options” annouced as -a <val> an option it will raise an error
Summary
How do you define your command line interface? Write a parse by yourself or spend hours learning optparse / argparse , and modify both code side and document every time you update the interface?
Life is short, man! You can simply do it this way:
"""
My copy script
Usage:
cp.py [options] <source_file> <target_file>
cp.py [options] <source_file>... <target_directory> <log_file>
Options:
-h -? --help print this screen
--version print the version of this script
-v --verbose print more information while running
"""
from docpie import docpie
args = docpie(__doc__)
print(args)
Now run it
$ python cp.py a.txt b.txt c.txt /tmp cp.log
{'--': False,
'--help': False,
'--verbose': False,
'--version': False,
'-?': False,
'-h': False,
'-v': False,
'<log_file>': 'cp.log',
'<source_file>': ['a.txt', 'b.txt', 'c.txt'],
'<target_directory>': '/tmp',
'<target_file>': None}
Write a __doc__, pass it to a function, DONE! Isn’t it simple?
Installation
Install release version:
pip install docpie
Install nightly/dev version:
pip install git+git://github.com/TylerTemp/docpie.git
docpie has been tested with Python:
2.6, 2.7
3.2, 3.3, 3.4, 3.5
pypy-2.0, pypy-2.6, pypy3-2.4
Get Start!
Interested? Visit Document and get start!
Or you can try it in your browser
Why docpie?
See here for more reasons.
Reference
the code in bashlog.py is taken from tornado, and tracemore.py is from python Cookbook
License
docpie is released under MIT-License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for docpie-0.2.3.macosx-10.10-x86_64.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 23110ef87fd587344c2d61b9402d0d988cb5cc04f4d20fa43f7d49c56428c153 |
|
MD5 | 5188f9f87cc2c5a8bd9952cb70a28a09 |
|
BLAKE2b-256 | a04da47ed41c16514638acaeeb576e8736acb9d78f9be33bcc4de39baa6c44a2 |
Hashes for docpie-0.2.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ee197b75944bcb484a75fc64af2c203128794cc34522a34fbf0f99c02c1d2946 |
|
MD5 | f2f7bc9b513c5d2bc26ba015eb994ceb |
|
BLAKE2b-256 | 51eebd0ada5c115ec307a722887f169aa92143f8485491fe3e505735fcff1a25 |