Cyclopts

New Features
* Allow parsing of json data if object is dict-like. Works for both environment variables, as well as cli variables. For example, the following are equivalent:
bash
$ movie-maintainer add --movie.title 'Furiosa: A Mad Max Saga' --movie.year 2024
$ movie-maintainer add --movie='{"title": "Mad Max: Fury Road", "year": 2024}'
$ MOVIE='{"title": "Mad Max: Fury Road", "year": 2024}' movie-maintainer add

By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/285


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.5.1...v3.6.0

Bug Fixes
* `cyclopts.run`: fix type-hints for coroutines by Tinche in https://github.com/BrianPugh/cyclopts/pull/323


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.5.0...v3.5.1

Features
* Add argument/attribute `App.help_on_error` that will print the command's help-page before printing any Cyclopts runtime error. Disabled by default by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/316
* Add "did you mean" suggestions to `MissingArgumentError`. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/317

Bug Fixes
* Fairly big bugfix: Fix Pydantic attribute annotations. Previously any `Annotated[..., Parameter(...)]` on a pydantic `BaseModel` attribute was accidentally not applied. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/321
* fix obj check in `Parameter.__call__`; only fixes an unnecessary copy and code semantics. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/322


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.4.1...v3.5.0

Bug Fixes
* Further improve config-file-caching that was introduced in v3.4.0. by BrianPugh in https://github.com/BrianPugh/cyclopts/pull/315
* Unit tests should "just work" when chdir after a configuration has been initially read. Configurations will be automatically re-read if a change in path or contents has been detected. Calling `importlib.reload` is no longer required.


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.4.0...v3.4.1

Feature
* `cyclopts.run` convenience function for terser, simpler short scripts by Tinche in https://github.com/BrianPugh/cyclopts/pull/305
Simple applications can now be written like:
python
import cyclopts

def main(name: str, age: int):
print(f"Hello {name}, you are {age} years old.")

cyclopts.run(main)


Bug Fixes
* Fix incorrect cache-hits for config-reads. This would happen if the cwd changes after initial config file read (highly uncommon except in unit-tests). By BrianPugh in https://github.com/BrianPugh/cyclopts/pull/310

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

**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.3.1...v3.4.0

Breaking Changes / Bug Fixes
The breaking changes **are minimal and probably negatively impacts 0 users**, but are listed here for completeness.
* Cyclopts now properly resolves aliases (and similar) for `attrs` and `pydantic`.

* The `cyclopts.field_info.FieldInfo` no longer is a subclass of `inspect.Parameter`; it is now an independent class that mimics many of `inspect.Parameter` attributes. The class's `__init__` now takes `names: tuple[str, ...]` instead of a single `name: str`. This is because certain-dataclass-like objects (namely, pydantic) allows for multiple python-variables to be mapped to the same attribute. The class still maintains a `name: str` property that returns the first element of the `names` attribute. This single name is used whenever an arbitrary choice for selecting a field's name needs to be used.

It was never intended for users to directly instantiate this class, and the `name` property makes it backwards compatible for those accessing the object. Probably noone actually accesses `FieldInfo` objects outside of Cyclopts' internals.

* In some situations, an `ArgumentOrderError` could be erroneously raised when an `UnknownOptionError` would have been more appropriate. In those situations, an `UnknownOptionError` is now raised.


**Full Changelog**: https://github.com/BrianPugh/cyclopts/compare/v3.3.0...v3.3.1