معرفی شرکت ها
declarative-parser-0.1b0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Modern, declarative argument parser for Python 3.6+
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | declarative-parser-0.1b0 |
| نام | declarative-parser |
| نسخه کتابخانه | 0.1b0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Michal Krassowski |
| ایمیل نویسنده | krassowski.michal+pypi@gmail.com |
| آدرس صفحه اصلی | https://github.com/krassowski/declarative-parser |
| آدرس اینترنتی | https://pypi.org/project/declarative-parser/ |
| مجوز | MIT |
Declarative Parser
==================
|Build Status| |Code Climate| |Coverage Status| |Documentation Status|
Modern, declarative argument parser for Python 3.6+. Powerful like
click, integrated like argparse, declarative as sqlalchemy. MIT
licenced. `Documented on
RTD <http://declarative-parser.readthedocs.io/en/latest/>`__. Install
with:
.. code:: bash
python3 -m pip install declarative_parser
As simple as argparse
~~~~~~~~~~~~~~~~~~~~~
It's built on top of argparse - everything you already know stays valid!
.. code:: python
from declarative_parser import Parser, Argument
class MyParser(Parser):
square = Argument(help='display a square of a given number')
parser = MyParser()
args = parser.parse_args()
print(args.square**2)
Nested and Parallel
~~~~~~~~~~~~~~~~~~~
Everyone knows about nested args. What about parallel groups?
.. code:: python
supported_formats = ['png', 'jpeg', 'gif']
class InputOptions(Parser):
path = Argument(type=argparse.FileType('rb'), optional=False)
format = Argument(default='png', choices=supported_formats)
class OutputOptions(Parser):
format = Argument(default='jpeg', choices=supported_formats)
scale = Argument(type=int, default=100, help='Rescale image to %% of original size')
class ImageConverter(Parser):
description = 'This app converts images'
verbose = Argument(action='store_true')
input = InputOptions()
output = OutputOptions()
parser = ImageConverter()
commands = '--verbose input image.png output --format gif --scale 50'.split()
namespace = parser.parse_args(commands)
assert namespace.input.format == 'png'
assert namespace.output.format == 'gif'
Intelligent
~~~~~~~~~~~
Make use of Python 3 type hints to reduce tedious task of parsers
writing to two or three lines. Positional, keyword arguments, type
hints, docstrings - everything can be meaningfully transformed into a
parser. And if you decide to take control, just overwrite the
automatically deduced arguments with an ``Argument()`` defined as a
class variable.
.. code:: python
import argparse
from declarative_parser import Argument
from declarative_parser.constructor_parser import ConstructorParser
class MyProgram:
database = Argument(
type=argparse.FileType('r'),
help='Path to file with the database'
)
def __init__(self, text: str, threshold: float=0.05, database=None):
"""My program does XYZ.
Arguments:
threshold: a floating-point value defining threshold, default 0.05
database: file object to the database if any
"""
print(text, threshold, None)
parser = ConstructorParser(MyProgram)
options = parser.parse_args()
program = parser.constructor(**vars(options))
And it works quite intuitively:
.. code:: bash
$ ./my_program.py test --threshold 0.6
test 0.6 None
$ ./my_program.py test --threshold f
usage: my_program.py [-h] [--database DATABASE] [--threshold THRESHOLD] text {} ...
my_program.py: error: argument --threshold: invalid float value: 'f'
$ ./my_program.py --threshold 0.6
usage: my_program.py [-h] [--database DATABASE] [--threshold THRESHOLD] text {} ...
my_program.py: error: the following arguments are required: text
Three docstring formats are supported: Google, NumPy and
reStructuredText, with the default being Google.
PS. It works with functions too; see the documentation of
`FunctionParser <http://declarative-parser.readthedocs.io/en/latest/constructor_parser.html#declarative_parser.constructor_parser.FunctionParser>`__.
Practical
~~~~~~~~~
What if you only want to show licence of your program? or version? Is
there a need to write a separate logic? DeclarativeParser gives you
utility decorator: ``@action`` which utilizes the power of
``argparse.Action``, leaving behind the otherwise necessary boilerplate
code.
.. code:: python
__version__ = 2.0
import argparse
from declarative_parser import action
from declarative_parser.constructor_parser import ConstructorParser
class MyProgram:
def __init__(self, threshold: float=0.05):
"""My program does XYZ.
Arguments:
threshold: a floating-point value, default 0.05
"""
pass
@action
def version(options):
print(__version__)
parser = ConstructorParser(MyProgram)
options = parser.parse_args()
program = parser.constructor(**vars(options))
The execution of an action will (by default) cause the program to exit
immediately when finished.
See following run as example:
.. code:: bash
$ ./my_program.py --version
2.0
See more examples in `the
documentation <http://declarative-parser.readthedocs.io/en/latest/>`__.
.. |Build Status| image:: https://travis-ci.org/krassowski/declarative-parser.svg?branch=master
:target: https://travis-ci.org/krassowski/declarative-parser
.. |Code Climate| image:: https://codeclimate.com/github/krassowski/declarative-parser/badges/gpa.svg
:target: https://codeclimate.com/github/krassowski/declarative-parser
.. |Coverage Status| image:: https://coveralls.io/repos/github/krassowski/declarative-parser/badge.svg
:target: https://coveralls.io/github/krassowski/declarative-parser
.. |Documentation Status| image:: https://readthedocs.org/projects/declarative-parser/badge/?version=latest
:target: http://declarative-parser.readthedocs.io/en/latest/?badge=latest
نحوه نصب
نصب پکیج whl declarative-parser-0.1b0:
pip install declarative-parser-0.1b0.whl
نصب پکیج tar.gz declarative-parser-0.1b0:
pip install declarative-parser-0.1b0.tar.gz