# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-jsonargparse
VERSION=		4.28.0
KEYWORDS=		python
VARIANTS=		v11 v12
SDESC[v11]=		JSON argument and config file parser (3.11)
SDESC[v12]=		JSON argument and config file parser (3.12)
HOMEPAGE=		none
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/2a/0a/07d4b188de1b0016452a2496ee9deb0eb944e0b31fb01f04a7153478589b
DISTFILE[1]=		jsonargparse-4.28.0-py3-none-any.whl:main
DF_INDEX=		1
SPKGS[v11]=		single
SPKGS[v12]=		single

OPTIONS_AVAILABLE=	PY311 PY312
OPTIONS_STANDARD=	none
VOPTS[v11]=		PY311=ON PY312=OFF
VOPTS[v12]=		PY311=OFF PY312=ON

DISTNAME=		jsonargparse-4.28.0.dist-info

GENERATED=		yes

[PY311].RUN_DEPENDS_ON=			python-PyYAML:single:v11
[PY311].USES_ON=			python:v11,wheel

[PY312].RUN_DEPENDS_ON=			python-PyYAML:single:v12
[PY312].USES_ON=			python:v12,wheel

[FILE:2641:descriptions/desc.single]


jsonargparse
============

Docs: https://jsonargparse.readthedocs.io/ | Source:
https://github.com/omni-us/jsonargparse/

jsonargparse is a library for creating command-line interfaces (CLIs) and
making Python apps easily configurable. It is a well-maintained project
with
frequent releases, adhering to high standards of development: semantic
versioning, deprecation periods, changelog, automated testing, and full
test
coverage.

Although jsonargparse might not be widely recognized yet, it already boasts
a [substantial user base
]. Most notably,
it serves as the framework behind pytorch-lightning's [LightningCLI
].

Features
--------

jsonargparse is user-friendly and encourages the development of **clean,
high-quality code**. It encompasses numerous powerful features, some unique
to
jsonargparse, while also combining advantages found in similar packages:

- **Automatic** creation of CLIs, like [Fire
 ], [Typer
 ], [Clize
 ] and [Tyro
 ].

- Use **type hints** for argument validation, like [Typer
 ], [Tap
 ] and [Tyro
 ].

- Use of **docstrings** for automatic generation of help, like [Tap
 ], [Tyro
 ] and [SimpleParsing
 ].

- Parse from **configuration files** and **environment variables**, like
  [OmegaConf], [dynaconf
 ], [confuse
 ] and [configargparse
 ].

- **Dataclasses** support, like [SimpleParsing
 ] and [Tyro
 ].

Other notable features include:

- **Extensive type hint support:** nested types (union, optional),
containers
  (list, dict, etc.), user-defined generics, restricted types (regex,
numbers),
  paths, URLs, types from stubs (``*.pyi``), future annotations (PEP [563
 ]), and backports (PEPs [604
 ]/[585
 ]).

- **Keyword arguments introspection:** resolving of parameters used via
  ``**kwargs``.

- **Dependency injection:** support types that expect a class instance and
  callables that return a class instance.

- **Structured configs:** parse config files with more understandable
non-flat
  hierarchies.

- **Config file formats:** [json], [yaml
 ], [jsonnet] and extendible to
  more formats.

- **Relative paths:** within config files and parsing of config paths
referenced
  inside other configs.

- **Argument linking:** directing parsed values to multiple parameters,
  preventing unnecessary interpolation in configs.

Design principles
-----------------

- **Non-intrusive/decoupled:**

  There is no requirement for unrelated modifications throughout a
codebase,
  maintaining the [separation of concerns principle
 ]. In simpler terms,
  changes should make sense even without the CLI. No need to inherit from a
  special class, add decorators, or use CLI-specific type hints.



[FILE:115:distinfo]
9dcda241349547e8035c630d51de73b8b4ba67bdc2b014d7f76734d404e82518       195327 jsonargparse-4.28.0-py3-none-any.whl