Metadata-Version: 2.1
Name: arcon
Version: 0.4.0
Summary: Persistent runtime config
Home-page: https://pypi.org/project/arcon/
License: MIT
Keywords: arguments,config,params,parser,runtime
Author: jshwi
Author-email: stephen@jshwisolutions.com
Maintainer: jshwi
Maintainer-email: stephen@jshwisolutions.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: mergedeep (>=1.3.4,<2.0.0)
Requires-Dist: tomli (>=2.0.1,<3.0.0)
Project-URL: Documentation, https://arcon.readthedocs.io/en/latest
Project-URL: Repository, https://github.com/jshwi/arcon
Description-Content-Type: text/x-rst

arcon
=====
.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
    :target: https://opensource.org/licenses/MIT
    :alt: License
.. image:: https://img.shields.io/pypi/v/arcon
    :target: https://pypi.org/project/arcon/
    :alt: PyPI
.. image:: https://github.com/jshwi/arcon/actions/workflows/build.yaml/badge.svg
    :target: https://github.com/jshwi/arcon/actions/workflows/build.yaml
    :alt: Build
.. image:: https://github.com/jshwi/arcon/actions/workflows/codeql-analysis.yml/badge.svg
    :target: https://github.com/jshwi/arcon/actions/workflows/codeql-analysis.yml
    :alt: CodeQL
.. image:: https://results.pre-commit.ci/badge/github/jshwi/arcon/master.svg
   :target: https://results.pre-commit.ci/latest/github/jshwi/arcon/master
   :alt: pre-commit.ci status
.. image:: https://codecov.io/gh/jshwi/arcon/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/jshwi/arcon
    :alt: codecov.io
.. image:: https://readthedocs.org/projects/arcon/badge/?version=latest
    :target: https://arcon.readthedocs.io/en/latest/?badge=latest
    :alt: readthedocs.org
.. image:: https://img.shields.io/badge/python-3.8-blue.svg
    :target: https://www.python.org/downloads/release/python-380
    :alt: python3.8
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black
    :alt: Black
.. image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
    :target: https://pycqa.github.io/isort/
    :alt: isort
.. image:: https://img.shields.io/badge/%20formatter-docformatter-fedcba.svg
    :target: https://github.com/PyCQA/docformatter
    :alt: docformatter
.. image:: https://img.shields.io/badge/linting-pylint-yellowgreen
    :target: https://github.com/PyCQA/pylint
    :alt: pylint
.. image:: https://img.shields.io/badge/security-bandit-yellow.svg
    :target: https://github.com/PyCQA/bandit
    :alt: Security Status
.. image:: https://snyk.io/test/github/jshwi/arcon/badge.svg
    :target: https://snyk.io/test/github/jshwi/arcon/badge.svg
    :alt: Known Vulnerabilities
.. image:: https://snyk.io/advisor/python/arcon/badge.svg
  :target: https://snyk.io/advisor/python/arcon
  :alt: arcon

Persistent runtime config
-------------------------

Child class of ``argparse.ArgumentParser``

Includes version argument as a default

Default values are defined through pyproject.toml

Includes additional argument adding methods

.. code-block:: python

    >>> __version__ = "0.1.0"
    >>> from arcon import ArgumentParser

Parsing comma separated list

.. code-block:: python

    >>> parser = ArgumentParser(__version__)
    >>> parser.add_list_argument("-l", "--list")
    >>> parser.parse_args(["--list", "comma,separated,list"])
    Namespace(list=['comma', 'separated', 'list'])

Parsing dict of comma separated lists

.. code-block:: python

    >>> parser = ArgumentParser(__version__)
    >>> parser.add_dict_argument("-d", "--dict")
    >>> parser.parse_args(["--dict", "key=comma,separated,list"])
    Namespace(dict={'key': ['comma', 'separated', 'list']})

