lsst-pex-config 30.0.0rc2__tar.gz → 30.0.1__tar.gz

{lsst_pex_config-30.0.0rc2/python/lsst_pex_config.egg-info → lsst_pex_config-30.0.1}/PKG-INFO

@@ -1,20 +1,21 @@
 Metadata-Version: 2.4
 Name: lsst-pex-config
-Version: 30.0.0rc2
+Version: 30.0.1
 Summary: A flexible configuration system using Python files.
 Author-email: Rubin Observatory Data Management <dm-admin@lists.lsst.org>
 License-Expression: BSD-3-Clause OR GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/lsst/pex_config
+Project-URL: Source, https://github.com/lsst/pex_config
 Keywords: lsst
 Classifier: Intended Audience :: Science/Research
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Astronomy
-Requires-Python: >=3.10.0
+Requires-Python: >=3.11.0
 Description-Content-Type: text/x-rst
 License-File: COPYRIGHT
 License-File: LICENSE
@@ -22,6 +23,7 @@ License-File: gpl-v3.0.txt
 License-File: bsd_license.txt
 Requires-Dist: pyyaml>=5.1
 Requires-Dist: numpy>=1.17
+Requires-Dist: lsst-resources
 Provides-Extra: test
 Requires-Dist: pytest>=3.2; extra == "test"
 Requires-Dist: pytest-openfiles>=0.5.0; extra == "test"

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/doc/lsst.pex.config/CHANGES.rst

@@ -1,3 +1,26 @@
+lsst-pex-config v30.0.0 (2026-01-15)
+====================================
+
+Python 3.11 is now the minimum supported version.
+Tested on Python 3.14.
+
+New Features
+------------
+
+- Added a ``copy`` method that unfreezes. (`DM-16523 <https://rubinobs.atlassian.net/browse/DM-16523>`_)
+- * Changed the config loader method such that if a relative path is specified inside another config it is treated as being relative to that original config file.
+  * Modified the config loader to support URI schemes ``file``, ``resource``, and ``eups`` supported by ``lsst-resources``.
+    This change means that in some cases ``__file__`` can be a URI string and not a simple path. (`DM-33226 <https://rubinobs.atlassian.net/browse/DM-33226>`_)
+
+
+Bug Fixes
+---------
+
+- Fixed a bug that caused history-printing to fail when the initial value for a field was `None`. (`DM-51850 <https://rubinobs.atlassian.net/browse/DM-51850>`_)
+- Fixed copying of ``ConfigDictField``. (`DM-53767 <https://rubinobs.atlassian.net/browse/DM-53767>`_)
+- Fixed copying of ``ConfigChoiceField`` and ``RegistryField``. (`DM-53791 <https://rubinobs.atlassian.net/browse/DM-53791>`_)
+
+
 lsst-pex-config v29.0.0 (2025-03-25)
 ====================================
 

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lsst-pex-config"
-requires-python = ">=3.10.0"
+requires-python = ">=3.11.0"
 description = "A flexible configuration system using Python files."
 license = "BSD-3-Clause OR GPL-3.0-or-later"
 license-files = ["COPYRIGHT", "LICENSE", "gpl-v3.0.txt", "bsd_license.txt"]
@@ -16,7 +16,7 @@ classifiers = [
     "Intended Audience :: Science/Research",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -26,11 +26,13 @@ keywords = ["lsst"]
 dependencies = [
     "pyyaml >=5.1",
     "numpy >= 1.17",
+    "lsst-resources",
 ]
 dynamic = ["version"]
 
 [project.urls]
 "Homepage" = "https://github.com/lsst/pex_config"
+"Source" = "https://github.com/lsst/pex_config"
 
 [project.optional-dependencies]
 test = [

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/callStack.py

@@ -102,7 +102,7 @@ class StackFrame:
     getStackFrame
     """
 
-    _STRIP = "/python/lsst/"
+    _STRIP = "/python/"
     """String to strip from the ``filename`` in the constructor."""
 
     def __init__(self, filename, lineno, function, content=None):

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/choiceField.py

@@ -42,7 +42,7 @@ class ChoiceField(Field[FieldTypeVar]):
     ----------
     doc : `str`
         Documentation string that describes the configuration field.
-    dtype : class
+    dtype : `type`
         The type of the field's choices. For example, `str` or `int`.
     allowed : `dict`
         The allowed values. Keys are the allowed choices (of ``dtype``-type).
@@ -52,9 +52,9 @@ class ChoiceField(Field[FieldTypeVar]):
         choices.
     optional : `bool`, optional
         If `True`, this configuration field is *optional*. Default is `True`.
-    deprecated : None or `str`, optional
+    deprecated : `None` or `str`, optional
         A description of why this Field is deprecated, including removal date.
-        If not None, the string is appended to the docstring for this Field.
+        If not `None`, the string is appended to the docstring for this Field.
 
     See Also
     --------

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/comparison.py

@@ -70,18 +70,18 @@ def compareScalars(name, v1, v2, output, rtol=1e-8, atol=1e-8, dtype=None):
         Name to use when reporting differences, typically created by
         `getComparisonName`.  This will always appear as the beginning of any
         messages reported via ``output``.
-    v1 : object
+    v1 : `object`
         Left-hand side value to compare.
-    v2 : object
+    v2 : `object`
         Right-hand side value to compare.
-    output : callable or `None`
+    output : `collections.abc.Callable` or `None`
         A callable that takes a string, used (possibly repeatedly) to report
         inequalities (for example, `print`). Set to `None` to disable output.
     rtol : `float`, optional
         Relative tolerance for floating point comparisons.
     atol : `float`, optional
         Absolute tolerance for floating point comparisons.
-    dtype : class, optional
+    dtype : `type`, optional
         Data type of values for comparison. May be `None` if values are not
         floating-point.
 
@@ -130,7 +130,7 @@ def compareConfigs(name, c1, c2, shortcut=True, rtol=1e-8, atol=1e-8, output=Non
         Relative tolerance for floating point comparisons.
     atol : `float`, optional
         Absolute tolerance for floating point comparisons.
-    output : callable, optional
+    output : `collections.abc.Callable`, optional
         A callable that takes a string, used (possibly repeatedly) to report
         inequalities. For example: `print`.
 

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/config.py

@@ -38,6 +38,7 @@ __all__ = (
 import copy
 import importlib
 import io
+import logging
 import math
 import numbers
 import os
@@ -47,9 +48,13 @@ import sys
 import tempfile
 import warnings
 from collections.abc import Mapping
+from contextlib import contextmanager
+from contextvars import ContextVar
 from types import GenericAlias
 from typing import Any, ForwardRef, Generic, TypeVar, cast, overload
 
+from lsst.resources import ResourcePath, ResourcePathExpression
+
 # if YAML is not available that's fine and we simply don't register
 # the yaml representer since we know it won't be used.
 try:
@@ -74,6 +79,25 @@ else:
     YamlLoaders = ()
     doImport = None
 
+_LOG = logging.getLogger(__name__)
+
+
+# Tracks the current config directory for the current context.
+_config_dir_stack: ContextVar[ResourcePath | None] = ContextVar("_config_dir_stack", default=None)
+
+
+def _get_config_root() -> ResourcePath | None:
+    return _config_dir_stack.get()
+
+
+@contextmanager
+def _push_config_root(dirname: ResourcePath):
+    token = _config_dir_stack.set(dirname)
+    try:
+        yield
+    finally:
+        _config_dir_stack.reset(token)
+
 
 class _PexConfigGenericAlias(GenericAlias):
     """A Subclass of python's GenericAlias used in defining and instantiating
@@ -124,14 +148,14 @@ def _autocast(x, dtype):
 
     Parameters
     ----------
-    x : object
+    x : `object`
         A value.
     dtype : type
         Data type, such as `float`, `int`, or `str`.
 
     Returns
     -------
-    values : object
+    values : `object`
         If appropriate, the returned value is ``x`` cast to the given type
         ``dtype``. If the cast cannot be performed the original value of
         ``x`` is returned.
@@ -276,7 +300,7 @@ class FieldValidationError(ValueError):
 
         See also
         --------
-        lsst.pex.config.Field.name
+        ``lsst.pex.config.Field.name``
         """
 
         self.fullname = _joinNamePath(config._name, field.name)
@@ -297,7 +321,7 @@ class FieldValidationError(ValueError):
         error = (
             f"{self.fieldType.__name__} '{self.fullname}' failed validation: {msg}\n"
             f"For more information see the Field definition at:\n{self.fieldSource.format()}"
-            f" and the Config definition at:\n{self.configSource.format()}"
+            f" and the Config definition for {_typeStr(config)} at:\n{self.configSource.format()}"
         )
         super().__init__(error)
 
@@ -310,14 +334,14 @@ class Field(Generic[FieldTypeVar]):
     ----------
     doc : `str`
         A description of the field for users.
-    dtype : type, optional
+    dtype : `type`, optional
         The field's data type. ``Field`` only supports basic data types:
         `int`, `float`, `complex`, `bool`, and `str`. See
         `Field.supportedTypes`. Optional if supplied as a typing argument to
         the class.
-    default : object, optional
+    default : `object`, optional
         The field's default value.
-    check : callable, optional
+    check : `collections.abc.Callable`, optional
         A callable that is called with the field's value. This callable should
         return `False` if the value is invalid. More complex inter-field
         validation can be written as part of the
@@ -326,7 +350,7 @@ class Field(Generic[FieldTypeVar]):
         This sets whether the field is considered optional, and therefore
         doesn't need to be set by the user. When `False`,
         `lsst.pex.config.Config.validate` fails if the field's value is `None`.
-    deprecated : None or `str`, optional
+    deprecated : `None` or `str`, optional
         A description of why this Field is deprecated, including removal date.
         If not None, the string is appended to the docstring for this Field.
 
@@ -350,7 +374,7 @@ class Field(Generic[FieldTypeVar]):
 
     Notes
     -----
-    ``Field`` instances (including those of any subclass of ``Field``) are used
+    `Field` instances (including those of any subclass of `Field`) are used
     as class attributes of `~lsst.pex.config.Config` subclasses (see the
     example, below). ``Field`` attributes work like the `property` attributes
     of classes that implement custom setters and getters. `Field` attributes
@@ -361,15 +385,15 @@ class Field(Generic[FieldTypeVar]):
     When you access a `Field` attribute on a `Config` instance, you don't
     get the `Field` instance itself. Instead, you get the value of that field,
     which might be a simple type (`int`, `float`, `str`, `bool`) or a custom
-    container type (like a `lsst.pex.config.List`) depending on the field's
-    type. See the example, below.
+    container type (like a `lsst.pex.config.ListField`) depending on the
+    field's type. See the example, below.
 
     Fields can be annotated with a type similar to other python classes (python
     specification `here <https://peps.python.org/pep-0484/#generics>`_ ).
     See the name field in the Config example below for an example of this.
     Unlike most other uses in python, this has an effect at type checking *and*
     runtime. If the type is specified with a class annotation, it will be used
-    as the value of the ``dtype`` in the ``Field`` and there is no need to
+    as the value of the ``dtype`` in the `Field` and there is no need to
     specify it as an argument during instantiation.
 
     There are Some notes on dtype through type annotation syntax. Type
@@ -377,19 +401,20 @@ class Field(Generic[FieldTypeVar]):
     name. i.e. "float", but this cannot be used to resolve circular references.
     Type annotation syntax can be used on an identifier in addition to Class
     assignment i.e. ``variable: Field[str] = Config.someField`` vs
-    ``someField = Field[str](doc="some doc"). However, this syntax is only
+    ``someField = Field[str](doc="some doc")``. However, this syntax is only
     useful for annotating the type of the identifier (i.e. variable in previous
-    example) and does nothing for assigning the dtype of the ``Field``.
+    example) and does nothing for assigning the dtype of the `Field`.
 
     Examples
     --------
-    Instances of ``Field`` should be used as class attributes of
+    Instances of `Field` should be used as class attributes of
     `lsst.pex.config.Config` subclasses:
 
     >>> from lsst.pex.config import Config, Field
     >>> class Example(Config):
     ...     myInt = Field("An integer field.", int, default=0)
     ...     name = Field[str](doc="A string Field")
+    >>> config = Example()
     >>> print(config.myInt)
     0
     >>> config.myInt = 5
@@ -600,7 +625,7 @@ class Field(Generic[FieldTypeVar]):
 
         Parameters
         ----------
-        value : object
+        value : `object`
             The value being validated.
 
         Raises
@@ -642,8 +667,8 @@ class Field(Generic[FieldTypeVar]):
 
         Parameters
         ----------
-        outfile : file-like object
-            A writeable field handle.
+        outfile : `typing.IO`
+            A writeable file handle.
         instance : `~lsst.pex.config.Config`
             The `~lsst.pex.config.Config` instance that contains this field.
 
@@ -684,7 +709,7 @@ class Field(Generic[FieldTypeVar]):
 
         Returns
         -------
-        value : object
+        value : `object`
             The field's value. See *Notes*.
 
         Notes
@@ -843,7 +868,7 @@ class Field(Generic[FieldTypeVar]):
             Relative tolerance for floating point comparisons.
         atol : `float`, optional
             Absolute tolerance for floating point comparisons.
-        output : callable, optional
+        output : `collections.abc.Callable`, optional
             A callable that takes a string, used (possibly repeatedly) to
             report inequalities.
 
@@ -1171,15 +1196,51 @@ class Config(metaclass=ConfigMeta):  # type: ignore
                 e.add_note(f"No field of name {name} exists in config type {_typeStr(self)}")
                 raise
 
+    def _filename_to_resource(
+        self, filename: ResourcePathExpression | None = None
+    ) -> tuple[ResourcePath | None, str]:
+        """Create resource path from filename.
+
+        Parameters
+        ----------
+        filename : `lsst.resources.ResourcePathExpression` or `None`
+            The URI expression associated with this config. Can be `None`
+            if no file URI is known.
+
+        Returns
+        -------
+        resource : `lsst.resources.ResourcePath` or `None`
+            The resource version of the filename. Returns `None` if no filename
+            was given or refers to unspecified value.
+        file_string : `str`
+            String form of the resource for use in ``__file__``
+        """
+        if filename is None or filename in ("?", "<unknown>"):
+            return None, "<unknown>"
+        base = _get_config_root()
+        resource = ResourcePath(filename, forceAbsolute=True, forceDirectory=False, root=base)
+
+        # Preferred definition of __file__ is the full OS path. If a config
+        # is loaded with a relative path it must be converted to the absolute
+        # path to avoid confusion with later relative paths referenced inside
+        # the config.
+        if resource.scheme == "file":
+            file_string = resource.ospath
+        else:
+            file_string = str(resource)
+
+        return resource, file_string
+
     def load(self, filename, root="config"):
         """Modify this config in place by executing the Python code in a
         configuration file.
 
         Parameters
         ----------
-        filename : `str`
-            Name of the configuration file. A configuration file is Python
-            module.
+        filename : `lsst.resources.ResourcePathExpression`
+            Name of the configuration URI. A configuration file is a Python
+            module. Since configuration files are Python code, remote URIs
+            are not allowed.
         root : `str`, optional
             Name of the variable in file that refers to the config being
             overridden.
@@ -1199,9 +1260,21 @@ class Config(metaclass=ConfigMeta):  # type: ignore
         lsst.pex.config.Config.saveToStream
         lsst.pex.config.Config.saveToString
         """
-        with open(filename) as f:
-            code = compile(f.read(), filename=filename, mode="exec")
-            self.loadFromString(code, root=root, filename=filename)
+        resource, file_string = self._filename_to_resource(filename)
+        if resource is None:
+            # A filename is required.
+            raise ValueError(f"Undefined URI provided to load command: {filename}.")
+
+        if resource.scheme not in ("file", "eups", "resource"):
+            raise ValueError(f"Remote URI ({resource}) can not be used to load configurations.")
+
+        # Push the directory of the file we are now reading onto the stack
+        # so that nested loads are relative to this file.
+        with _push_config_root(resource.dirname()):
+            _LOG.debug("Updating config from URI %s", str(resource))
+            with resource.open("r") as f:
+                code = compile(f.read(), filename=file_string, mode="exec")
+            self._loadFromString(code, root=root, filename=file_string)
 
     def loadFromStream(self, stream, root="config", filename=None, extraLocals=None):
         """Modify this Config in place by executing the Python code in the
@@ -1209,7 +1282,7 @@ class Config(metaclass=ConfigMeta):  # type: ignore
 
         Parameters
         ----------
-        stream : file-like object, `str`, `bytes`, or `~types.CodeType`
+        stream : `typing.IO`, `str`, `bytes`, or `~types.CodeType`
             Stream containing configuration override code.  If this is a
             code object, it should be compiled with ``mode="exec"``.
         root : `str`, optional
@@ -1224,7 +1297,8 @@ class Config(metaclass=ConfigMeta):  # type: ignore
             Then this config's field ``myField`` is set to ``5``.
         filename : `str`, optional
             Name of the configuration file, or `None` if unknown or contained
-            in the stream. Used for error reporting.
+            in the stream. Used for error reporting and to set ``__file__``
+            variable in config.
         extraLocals : `dict` of `str` to `object`, optional
             Any extra variables to include in local scope when loading.
 
@@ -1244,7 +1318,7 @@ class Config(metaclass=ConfigMeta):  # type: ignore
         """
         if hasattr(stream, "read"):
             if filename is None:
-                filename = getattr(stream, "name", "?")
+                filename = getattr(stream, "name", "<unknown>")
             code = compile(stream.read(), filename=filename, mode="exec")
         else:
             code = stream
@@ -1268,9 +1342,11 @@ class Config(metaclass=ConfigMeta):  # type: ignore
                 config.myField = 5
 
             Then this config's field ``myField`` is set to ``5``.
-        filename : `str`, optional
-            Name of the configuration file, or `None` if unknown or contained
-            in the stream. Used for error reporting.
+        filename : `lsst.resources.ResourcePathExpression`, optional
+            URI of the configuration file, or `None` if unknown or contained
+            in the stream. Used for error reporting and to set ``__file__``
+            variable. Required to be set if the string config attempts to
+            load other configs using either relative path or ``__file__``.
         extraLocals : `dict` of `str` to `object`, optional
             Any extra variables to include in local scope when loading.
 
@@ -1291,7 +1367,24 @@ class Config(metaclass=ConfigMeta):  # type: ignore
         if filename is None:
             # try to determine the file name; a compiled string
             # has attribute "co_filename",
-            filename = getattr(code, "co_filename", "?")
+            filename = getattr(code, "co_filename", "<unknown>")
+
+        resource, file_string = self._filename_to_resource(filename)
+        if resource is None:
+            # No idea where this config came from so no ability to deal with
+            # relative paths. No reason to use context.
+            self._loadFromString(code, root=root, filename=filename, extraLocals=extraLocals)
+        else:
+            # Push the directory of the file we are now reading onto the stack
+            # so that nested loads are relative to this file.
+            with _push_config_root(resource.dirname()):
+                self._loadFromString(code, root=root, filename=file_string, extraLocals=extraLocals)
+
+    def _loadFromString(self, code, root="config", filename=None, extraLocals=None):
+        """Update config from string.
+
+        Assumes relative directory path context has been setup by caller.
+        """
         with RecordingImporter() as importer:
             globals = {"__file__": filename}
             local = {root: self}
@@ -1374,7 +1467,7 @@ class Config(metaclass=ConfigMeta):  # type: ignore
 
         Parameters
         ----------
-        outfile : file-like object
+        outfile : `typing.TextIO`
             Destination file object write the config into. Accepts strings not
             bytes.
         root : `str`, optional
@@ -1428,7 +1521,7 @@ class Config(metaclass=ConfigMeta):  # type: ignore
 
         Parameters
         ----------
-        outfile : file-like object
+        outfile : `typing.TextIO`
             Destination file object write the config into. Accepts strings not
             bytes.
         """
@@ -1663,7 +1756,7 @@ class Config(metaclass=ConfigMeta):  # type: ignore
             Relative tolerance for floating point comparisons.
         atol : `float`, optional
             Absolute tolerance for floating point comparisons.
-        output : callable, optional
+        output : `collections.abc.Callable`, optional
             A callable that takes a string, used (possibly repeatedly) to
             report inequalities.
 
@@ -1784,7 +1877,7 @@ def unreduceConfig(cls_, stream):
     cls_ : `lsst.pex.config.Config`-type
         A `lsst.pex.config.Config` type (not an instance) that is instantiated
         with configurations in the ``stream``.
-    stream : file-like object, `str`, or `~types.CodeType`
+    stream : `typing.IO`, `str`, or `~types.CodeType`
         Stream containing configuration override code.
 
     Returns

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/configChoiceField.py

@@ -192,7 +192,7 @@ class ConfigInstanceDict(collections.abc.Mapping[str, Config]):
         result._typemap = self._typemap
         if self._selection is not None:
             if self._field.multi:
-                result._selection = SelectionSet(result._dict, self._selection._set)
+                result._selection = SelectionSet(self, self._selection._set)
             else:
                 result._selection = self._selection
         return result
@@ -412,9 +412,9 @@ class ConfigChoiceField(Field[ConfigInstanceDict]):
         If `False`, the field allows only a single selection. In this case,
         set the active config by assigning the config's key from the
         ``typemap`` to the field's ``name`` attribute (see *Examples*).
-    deprecated : None or `str`, optional
+    deprecated : `None` or `str`, optional
         A description of why this Field is deprecated, including removal date.
-        If not None, the string is appended to the docstring for this Field.
+        If not `None`, the string is appended to the docstring for this Field.
 
     See Also
     --------
@@ -650,7 +650,7 @@ class ConfigChoiceField(Field[ConfigInstanceDict]):
             Relative tolerance for floating point comparisons.
         atol : `float`
             Absolute tolerance for floating point comparisons.
-        output : callable
+        output : `collections.abc.Callable`
             A callable that takes a string, used (possibly repeatedly) to
             report inequalities.
 

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/configDictField.py

@@ -76,7 +76,7 @@ class ConfigDict(Dict[str, Config]):
         return type(self)(
             config,
             self._field,
-            {k: v._copy() for k, v in self._dict.items()},
+            {k: v.copy() for k, v in self._dict.items()},
             at=None,
             label="copy",
             setHistory=False,
@@ -148,7 +148,7 @@ class ConfigDictField(DictField):
     itemtype : `lsst.pex.config.Config`-type
         The type of the values in the mapping. This must be
         `~lsst.pex.config.Config` or a subclass.
-    default : optional
+    default : `typing.Any`, optional
         Unknown.
     default : ``itemtype``-dtype, optional
         Default value of this field.
@@ -161,9 +161,9 @@ class ConfigDictField(DictField):
         Callable to check a key.
     itemCheck : `~collections.abc.Callable` or `None`, optional
         Callable to check an item.
-    deprecated : None or `str`, optional
+    deprecated : `None` or `str`, optional
         A description of why this Field is deprecated, including removal date.
-        If not None, the string is appended to the docstring for this Field.
+        If not `None`, the string is appended to the docstring for this Field.
 
     Raises
     ------
@@ -171,7 +171,7 @@ class ConfigDictField(DictField):
         Raised if the inputs are invalid:
 
         - ``keytype`` or ``itemtype`` arguments are not supported types
-          (members of `ConfigDictField.supportedTypes`.
+          (members of `Field.supportedTypes`.
         - ``dictCheck``, ``keyCheck`` or ``itemCheck`` is not a callable
           function.
 
@@ -326,7 +326,7 @@ class ConfigDictField(DictField):
             Relative tolerance for floating point comparisons.
         atol : `float`
             Absolute tolerance for floating point comparisons.
-        output : callable
+        output : `collections.abc.Callable`
             A callable that takes a string, used (possibly repeatedly) to
             report inequalities.
 

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/configField.py

@@ -52,12 +52,12 @@ class ConfigField(Field[FieldTypeVar]):
         considered equivalent to assigning a default-constructed sub-config.
         This means that the argument default can be ``dtype``, as well as an
         instance of ``dtype``.
-    check : callable, optional
+    check : `collections.abc.Callable`, optional
         A callback function that validates the field's value, returning `True`
         if the value is valid, and `False` otherwise.
-    deprecated : None or `str`, optional
+    deprecated : `None` or `str`, optional
         A description of why this Field is deprecated, including removal date.
-        If not None, the string is appended to the docstring for this Field.
+        If not `None`, the string is appended to the docstring for this Field.
 
     See Also
     --------
@@ -178,7 +178,7 @@ class ConfigField(Field[FieldTypeVar]):
 
         Parameters
         ----------
-        outfile : file-like object
+        outfile : `typing.IO`
             A writeable field handle.
         instance : `~lsst.pex.config.Config`
             The `~lsst.pex.config.Config` instance that contains this field.
@@ -226,7 +226,7 @@ class ConfigField(Field[FieldTypeVar]):
 
         Returns
         -------
-        value : object
+        value : `object`
             The field's value. See *Notes*.
 
         Notes
@@ -299,7 +299,7 @@ class ConfigField(Field[FieldTypeVar]):
             Relative tolerance for floating point comparisons.
         atol : `float`
             Absolute tolerance for floating point comparisons.
-        output : callable
+        output : `collections.abc.Callable`
             A callable that takes a string, used (possibly repeatedly) to
             report inequalities.
 

{lsst_pex_config-30.0.0rc2 → lsst_pex_config-30.0.1}/python/lsst/pex/config/configurableActions/_configurableActionStructField.py

@@ -446,7 +446,7 @@ class ConfigurableActionStructField(Field[ActionTypeVar]):
             Relative tolerance for floating point comparisons.
         atol : `float`
             Absolute tolerance for floating point comparisons.
-        output : callable
+        output : `collections.abc.Callable`
             A callable that takes a string, used (possibly repeatedly) to
             report inequalities.