Skip to content

Commit e1828e2

Browse files
authored
parse_optionals_as_positionals and applied_instantiation_links no longer marked as experimental (#788)
1 parent 685c3c4 commit e1828e2

File tree

3 files changed

+17
-11
lines changed

3 files changed

+17
-11
lines changed

CHANGELOG.rst

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The semantic versioning only considers the public API as described in
1212
paths are considered internals and can change in minor and patch releases.
1313

1414

15-
v4.42.1 (unreleased)
15+
v4.43.0 (unreleased)
1616
--------------------
1717

1818
Fixed
@@ -25,6 +25,12 @@ Fixed
2525
- Misleading error message for invalid value for ``Literal`` strings (`#790
2626
<https://github.com/omni-us/jsonargparse/pull/790>`__).
2727

28+
Changed
29+
^^^^^^^
30+
- ``parse_optionals_as_positionals`` and ``applied_instantiation_links`` no
31+
longer marked as experimental (`#788
32+
<https://github.com/omni-us/jsonargparse/pull/788>`__).
33+
2834

2935
v4.42.0 (2025-10-14)
3036
--------------------

jsonargparse/_common.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -130,12 +130,12 @@ def set_parsing_settings(
130130
DocstringStyle.AUTO.
131131
docstring_parse_attribute_docstrings: Whether to parse attribute
132132
docstrings (slower). Default is False.
133-
parse_optionals_as_positionals: [EXPERIMENTAL] If True, the parser will
134-
take extra positional command line arguments as values for optional
135-
arguments. This means that optional arguments can be given by name
136-
--key=value as usual, but also as positional. The extra positionals
137-
are applied to optionals in the order that they were added to the
138-
parser. By default, this is False.
133+
parse_optionals_as_positionals: If True, the parser will take extra
134+
positional command line arguments as values for optional arguments.
135+
This means that optional arguments can be given by name --key=value
136+
as usual, but also as positional. The extra positionals are applied
137+
to optionals in the order that they were added to the parser. By
138+
default, this is False.
139139
stubs_resolver_allow_py_files: Whether the stubs resolver should search
140140
in ``.py`` files in addition to ``.pyi`` files.
141141
omegaconf_absolute_to_relative_paths: If True, when loading configs

jsonargparse/_core.py

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -775,8 +775,9 @@ def dump(
775775
776776
Args:
777777
cfg: The configuration object to dump.
778-
format: The output format: ``'yaml'``, ``'json'``, ``'json_indented'``, ``'parser_mode'`` or ones added via
779-
:func:`.set_dumper`.
778+
format: The output format: ``'yaml'``, ``'json'``,
779+
``'json_indented'``, ``'toml'``, ``'parser_mode'`` or ones added
780+
via :func:`.set_dumper`.
780781
skip_none: Whether to exclude entries whose value is None.
781782
skip_default: Whether to exclude entries whose value is the same as the default.
782783
skip_validation: Whether to skip parser checking.
@@ -1199,8 +1200,7 @@ def add_instantiator(
11991200
have an additional keyword parameter ``applied_instantiation_links:
12001201
dict``. This parameter will be populated with a dictionary having as
12011202
keys the targets of the instantiation links and corresponding values
1202-
that were applied. Support for ``applied_instantiation_links`` parameter
1203-
is EXPERIMENTAL and subject to change or removal in future versions.
1203+
that were applied.
12041204
12051205
Args:
12061206
instantiator: Function that instantiates a class.

0 commit comments

Comments
 (0)