Metadata-Version: 2.1
Name: pycolt
Version: 0.5.3
Summary: Command Line Tool for Python
Home-page: https://github.com/mfsjmenger/colt
Author: Maximilian F.S.J. Menger
Author-email: m.f.s.j.menger@rug.nl
License: Apache License v2.0
Keywords: pycolt
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
License-File: LICENSE
License-File: AUTHORS.rst

=======================
COLT: COmmand Line Tool
=======================

Simple, extensible tool to create out of the box input files and commandline
interfaces for Python, that are type validated.
For the input file the `ini` file-format is used around Python's configparser_.


* Free software: Apache License 2.0


Features
--------

1. Build simple commandline interfaces using the FromCommandline-decorator

.. code:: python

   # examples/commandline_xrange.py
   from colt import from_commandline


   @from_commandline("""
   # start of the range
   xstart = :: int :: >0
   # end of the range
   xstop = :: int :: >1
   # step size
   step = 1 :: int 
   """)
   def x_range(xstart, xstop, step):
      for i in range(xstart, xstop, step):
         print(i)

   if __name__ == '__main__':
      x_range()

.. code:: python

   usage: commandline_xrange.py [-h] [-step step] xstart xstop

   positional arguments:
      xstart      int, Range(>0)
                  start of the range
      xstop       int, Range(>1)
                  end of the range

   optional arguments:
      -h, --help  show this help message and exit
      -step step  int,
                  step size


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _configparser: https://docs.python.org/3/library/configparser.html


=======
History
=======

0.4.0 (2021-6-9)
------------------
 * New commandline parser instead of argparse:
    * correct handling of multiple subparser
    * correct parsing of infinit arguments using the `list(typ)` syntax
    * fully customizable help settings

0.1.0 (2020-8-1)
------------------

* First release on PyPI.




