Cyclopts

Latest version: v3.11.2

Safety actively analyzes 722525 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 1 of 12

3.11.2

Bug Fixes
* Respect individual class field annotated converters. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/386


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.11.1...v3.11.2

3.11.1

Bug Fixes
* Improve `App` subclassing by thejcannon in https://github.com/BrianPugh/cyclopts/pull/384


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.11.0...v3.11.1

3.11.0

Lots of pydantic-specific improvements in this release.

Features
* Completely **disable** cyclopts conversion mechanisms for `pydantic` type hints and defer responsibility to pydantic. Notably, pydantic union discriminators now work correctly. By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/379
* Add pydantic `Field.description` to the help-resolution-hierarchy. By pablospe in https://github.com/BrianPugh/cyclopts/pull/375
* If pydantic is used in your project (detected as pydantic being imported), pydantic will additionally validate coerced data. This means that pydantic validator types (e.g. `pydantic.PositiveInt`) now work.

Bug Fixes
* Do not catch `pydantic.ValidationError` from calling user's command. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/378
* Fix empty space in HelpPanel when combining panels (introduced in v3.10.0). by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/380

New Contributors
* pablospe made their first contribution in https://github.com/BrianPugh/cyclopts/pull/375

**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.10.1...v3.11.0

3.10.1

What's Changed
* Fix `Config.search_parents` when used on relative paths. By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/371


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.10.0...v3.10.1

3.10.0

Features
* By default, registering a subapp will set it's help and version "show" attribute to `False`, making `--help` and `--version` not show up in the subapp's help page. This is done because the previous behavior (showing these flags) mostly cluttered the help-page and wasn't particularly useful. By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/363
* Always apply `Parameter.validator` to command-signature default-values. Consider the following code:

import cyclopts
from pathlib import Path

def command(file: cyclopts.types.ExistingFile = Path("foo.bin")):
pass

cyclopts.run(command)

Previously, if no file was specified, `file` would be `Path("foo.bin")`, but the validator that checks if the file exists would have **not** ran. This is unintuitive/unexpected to the developer. Now Cyclopts always runs validators, even on default values.
* By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/364
* Render default/choices/required styling (colors!) in the help page. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/365
* More types: `uint64`/`int64`/`Email`/`URL`/`Port` by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/366

Bug Fixes
* Fix some situations where `InvalidCommandError` didn't result in printing command suggestions. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/358

**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.9.3...v3.10.0

3.9.3

Bug Fixes
* Fix `from __future__ import annotations` type-resolution. By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/355
* This does not solve issues when the annotated class is defined in a closure, but this should be pretty uncommon for Cyclopts use-cases.

Docs
* Add cookbook example for reading from path or stdin. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/354

**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.9.2...v3.9.3

Page 1 of 12

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.