From 38bb2db2fd4761a420271409cbd1149babf695f9 Mon Sep 17 00:00:00 2001 From: Mauricio Villegas <5780272+mauvilsa@users.noreply.github.com> Date: Fri, 17 Oct 2025 11:05:02 +0200 Subject: [PATCH] parse_optionals_as_positionals and applied_instantiation_links no longer marked as experimental. --- CHANGELOG.rst | 12 ++++++++++-- jsonargparse/_common.py | 12 ++++++------ jsonargparse/_core.py | 8 ++++---- 3 files changed, 20 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index e9e2b306..0f42c178 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -11,15 +11,23 @@ The semantic versioning only considers the public API as described in :ref:`api-ref`. Components not mentioned in :ref:`api-ref` or different import paths are considered internals and can change in minor and patch releases. -v4.42.1 (unreleased) + +v4.43.0 (unreleased) -------------------- Fixed ^^^^^ - Prevent extra environment variables in helptext when default_env=True, for - version actions and subcommands(`#787 + version actions and subcommands (`#787 `__). +Changed +^^^^^^^ +- ``parse_optionals_as_positionals`` and ``applied_instantiation_links`` no + longer marked as experimental (`#788 + `__). + + v4.42.0 (2025-10-14) -------------------- diff --git a/jsonargparse/_common.py b/jsonargparse/_common.py index 4467e67f..c6358979 100644 --- a/jsonargparse/_common.py +++ b/jsonargparse/_common.py @@ -130,12 +130,12 @@ def set_parsing_settings( DocstringStyle.AUTO. docstring_parse_attribute_docstrings: Whether to parse attribute docstrings (slower). Default is False. - parse_optionals_as_positionals: [EXPERIMENTAL] If True, the parser will - take extra positional command line arguments as values for optional - arguments. This means that optional arguments can be given by name - --key=value as usual, but also as positional. The extra positionals - are applied to optionals in the order that they were added to the - parser. By default, this is False. + parse_optionals_as_positionals: If True, the parser will take extra + positional command line arguments as values for optional arguments. + This means that optional arguments can be given by name --key=value + as usual, but also as positional. The extra positionals are applied + to optionals in the order that they were added to the parser. By + default, this is False. stubs_resolver_allow_py_files: Whether the stubs resolver should search in ``.py`` files in addition to ``.pyi`` files. omegaconf_absolute_to_relative_paths: If True, when loading configs diff --git a/jsonargparse/_core.py b/jsonargparse/_core.py index 9f6d58c6..68182f8a 100644 --- a/jsonargparse/_core.py +++ b/jsonargparse/_core.py @@ -775,8 +775,9 @@ def dump( Args: cfg: The configuration object to dump. - format: The output format: ``'yaml'``, ``'json'``, ``'json_indented'``, ``'parser_mode'`` or ones added via - :func:`.set_dumper`. + format: The output format: ``'yaml'``, ``'json'``, + ``'json_indented'``, ``'toml'``, ``'parser_mode'`` or ones added + via :func:`.set_dumper`. skip_none: Whether to exclude entries whose value is None. skip_default: Whether to exclude entries whose value is the same as the default. skip_validation: Whether to skip parser checking. @@ -1199,8 +1200,7 @@ def add_instantiator( have an additional keyword parameter ``applied_instantiation_links: dict``. This parameter will be populated with a dictionary having as keys the targets of the instantiation links and corresponding values - that were applied. Support for ``applied_instantiation_links`` parameter - is EXPERIMENTAL and subject to change or removal in future versions. + that were applied. Args: instantiator: Function that instantiates a class.