experimental/cpu/: tyro-0.8.4 metadata and description

Strongly typed, zero-effort CLI interfaces

author_email	brentyi <brentyi@berkeley.edu>
classifiers	Programming Language :: Python :: 3 Programming Language :: Python :: 3.7 Programming Language :: Python :: 3.8 Programming Language :: Python :: 3.9 Programming Language :: Python :: 3.10 Programming Language :: Python :: 3.11 Programming Language :: Python :: 3.12 License :: OSI Approved :: MIT License Operating System :: OS Independent
description_content_type	text/markdown
license	MIT
project_urls	GitHub, https://github.com/brentyi/tyro
provides_extras	dev
requires_dist	docstring-parser >=0.14.1 typing-extensions >=4.7.0 rich >=11.1.0 shtab >=1.5.6 colorama >=0.4.0 ; platform_system == "Windows" eval-type-backport >=0.1.3 ; python_version < "3.10" backports.cached-property >=1.0.2 ; python_version < "3.8" PyYAML >=6.0 ; extra == 'dev' frozendict >=2.3.4 ; extra == 'dev' pytest >=7.1.2 ; extra == 'dev' pytest-cov >=3.0.0 ; extra == 'dev' omegaconf >=2.2.2 ; extra == 'dev' attrs >=21.4.0 ; extra == 'dev' torch >=1.10.0 ; extra == 'dev' pyright >=1.1.349 ; extra == 'dev' ruff >=0.1.13 ; extra == 'dev' mypy >=1.4.1 ; extra == 'dev' numpy >=1.20.0 ; extra == 'dev' pydantic >=2.5.2 ; extra == 'dev' coverage[toml] >=6.5.0 ; extra == 'dev' eval-type-backport >=0.1.3 ; extra == 'dev' flax >=0.6.9 ; (python_version >= "3.8") and extra == 'dev'
requires_python	>=3.7

File	Tox results	History
tyro-0.8.4-py3-none-any.whl Size 100 KB Type Python Wheel Python 3		Replaced 4 time(s) Uploaded to experimental/cpu by experimental 2024-05-15 14:20:26

Documentation • pip install tyro

tyro is a tool for generating command-line interfaces and configuration objects in Python.

Our core API, tyro.cli(),

Generates CLI interfaces from Python type signatures.
Populates helptext automatically from defaults, annotations, and docstrings.
Understands nesting of dataclasses, pydantic, and attrs structures.
Prioritizes static analysis for type checking and autocompletion with tools like Pylance, Pyright, and mypy.

For advanced users, it also supports:

Subcommands, as well as choosing between and overriding values in configuration objects.
Completion script generation for bash, zsh, and tcsh.
Fine-grained configuration via PEP 529 runtime annotations (tyro.conf.*).

For examples and the API reference, see our documentation.

tyro is designed to be lightweight enough for throwaway scripts, while facilitating type safety and modularity for larger projects. Examples:

nerfstudio-project/nerfstudio	Open-source tools for neural radiance fields.
Sea-Snell/JAXSeq	Library for distributed training of large language models in JAX.
kevinzakka/obj2mjcf	Interface for processing composite Wavefront OBJ files for Mujoco.
blurgyy/jaxngp	CUDA-accelerated implementation of instant-ngp, in JAX.
NVIDIAGameWorks/kaolin-wisp	PyTorch library for neural fields.
autonomousvision/sdfstudio	Unified framework for surface reconstruction.
openrlbenchmark/openrlbenchmark	Collection of tracked experiments for reinforcement learning.

tyro bakes many opinions into its design decisions. If any of them don't make sense, feel free to file an issue!

You might also consider one of many alternative libraries. Some that we particularly like:

simple-parsing and jsonargparse, which provide deeper integration with configuration file formats like YAML and JSON.
clipstick, which focuses on generating CLIs from Pydantic models.
datargs, which provides a minimal API for dataclasses.
fire and clize, which support arguments without type annotations.

We also have some notes on tyro's design goals and other alternatives in the docs here.

devpi