Jsonargparse

-------------------

Fixed
^^^^^
- Make ``import_docstring_parse`` backward compatible to support released
versions of ``LightningCLI`` (`lightning12918
<https://github.com/Lightning-AI/lightning/pull/12918>`__).

-------------------

Fixed
^^^^^
- Properly catch exceptions when parsing docstrings (`lightning12883
<https://github.com/Lightning-AI/lightning/issues/12883>`__).

-------------------

Fixed
^^^^^
- Failing to parse strings that look like timestamps (`135
<https://github.com/omni-us/jsonargparse/issues/135>`__).
- Correctly consider nested mapping type without args as supported.
- New registered types incorrectly considered as class type.

Changed
^^^^^^^
- Final classes now added as group of actions instead of one typehint action.
- ``final`` decorator now an import from typing_extensions if available.
- Exporting ``ActionsContainer`` to show respective methods in documentation.
- Raise ValueError when logger property given dict with unexpected key.

-------------------

Added
^^^^^
- Dump option to exclude entries whose value is the same as the default (`91
<https://github.com/omni-us/jsonargparse/issues/91>`__).
- Support specifying ``class_path`` only by name for known subclasses (`84
<https://github.com/omni-us/jsonargparse/issues/84>`__).
- ``add_argument`` with subclass type now also adds ``--*.help`` option.
- Support shorter subclass command line arguments by not requiring to have
``.init_args.``.
- Support for ``Literal`` backport from typing_extensions on python 3.7.
- Support nested subclass ``--*.help CLASS`` options.

Changed
^^^^^^^
- ``class_path``'s on parse are now normalized to shortest form.

-------------------

Added
^^^^^
- ``capture_parser`` function to get the parser object from a cli function.
- ``dump_header`` property to set header for yaml/jsonnet dumpers (`79
<https://github.com/omni-us/jsonargparse/issues/79>`__).
- ``Callable`` type now supports callable classes (`110
<https://github.com/omni-us/jsonargparse/issues/110>`__).

Fixed
^^^^^
- Bug in check for ``class_path``, ``init_args`` dicts.
- Module mocks in cli_tests.py.

Changed
^^^^^^^
- Moved argcomplete code from core to optionals module.
- ``Callable`` no longer a simple registered type.
- Import paths are now serialized as its shortest form.
- ``Callable`` default now shown in help as full import path.
- Moved typehint code from core to typehint module.
- Ignore argument links when source/target subclass does not have parameter
(`129 <https://github.com/omni-us/jsonargparse/issues/129>`__).
- Swapped order of argument links in help to ``source --> target``.

Deprecated
^^^^^^^^^^
- ``CLI``'s ``return_parser`` parameter will be removed in v5.0.0.

-------------------

Added
^^^^^
- Environment variables to enable features without code change:
- ``JSONARGPARSE_DEFAULT_ENV`` to enable environment variable parsing.
- ``JSONARGPARSE_DEBUG`` to print of stack trace on parse failure.

Fixed
^^^^^
- No error message for unrecognized arguments (`lightning12303
<https://github.com/Lightning-AI/lightning/issues/12303>`__).

Changed
^^^^^^^
- Use yaml.CSafeLoader for yaml loading if available.