backlogops 1.0__tar.gz → 1.2__tar.gz

{backlogops-1.0 → backlogops-1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops
-Version: 1.0
+Version: 1.2
 Summary: Library with backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -21,14 +21,14 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: config-as-json>=1.5
-Requires-Dist: cryptography>=50.0.0
+Requires-Dist: config-as-json>=1.7
+Requires-Dist: cryptography>=50.0.1
 Requires-Dist: jira[cli,opt]>=3.10.5
 Requires-Dist: tableio>=1.1
-Requires-Dist: tableio-cfg-json>=1.3
+Requires-Dist: tableio-cfg-json>=1.4
 Requires-Dist: wizard-ui-bridge[textual]>=1.3
 Requires-Dist: versionreporter>=0.4
-Requires-Dist: edit-cfg-json==0.0.4
+Requires-Dist: edit-cfg-json>=0.2.0
 Dynamic: author
 Dynamic: license-file
 Dynamic: requires-dist
@@ -325,10 +325,10 @@ For the full set of public names see the API documentation linked above.
 
 ## Test summary
 
-- Test result: 2234 passed, 1 deselected in 45s
+- Test result: 2309 passed, 1 deselected in 58s
 - No flake8 warnings.
 - No mypy errors found.
 - No pylint warnings.
 - No python layout warnings.
-- Built version(s): 1.0
+- Built version(s): 1.2
 - Build and test using Python 3.14.7

{backlogops-1.0 → backlogops-1.2}/README_pypi.md

@@ -289,10 +289,10 @@ For the full set of public names see the API documentation linked above.
 
 ## Test summary
 
-- Test result: 2234 passed, 1 deselected in 45s
+- Test result: 2309 passed, 1 deselected in 58s
 - No flake8 warnings.
 - No mypy errors found.
 - No pylint warnings.
 - No python layout warnings.
-- Built version(s): 1.0
+- Built version(s): 1.2
 - Build and test using Python 3.14.7

{backlogops-1.0 → backlogops-1.2}/backlogops.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops
-Version: 1.0
+Version: 1.2
 Summary: Library with backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -21,14 +21,14 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: config-as-json>=1.5
-Requires-Dist: cryptography>=50.0.0
+Requires-Dist: config-as-json>=1.7
+Requires-Dist: cryptography>=50.0.1
 Requires-Dist: jira[cli,opt]>=3.10.5
 Requires-Dist: tableio>=1.1
-Requires-Dist: tableio-cfg-json>=1.3
+Requires-Dist: tableio-cfg-json>=1.4
 Requires-Dist: wizard-ui-bridge[textual]>=1.3
 Requires-Dist: versionreporter>=0.4
-Requires-Dist: edit-cfg-json==0.0.4
+Requires-Dist: edit-cfg-json>=0.2.0
 Dynamic: author
 Dynamic: license-file
 Dynamic: requires-dist
@@ -325,10 +325,10 @@ For the full set of public names see the API documentation linked above.
 
 ## Test summary
 
-- Test result: 2234 passed, 1 deselected in 45s
+- Test result: 2309 passed, 1 deselected in 58s
 - No flake8 warnings.
 - No mypy errors found.
 - No pylint warnings.
 - No python layout warnings.
-- Built version(s): 1.0
+- Built version(s): 1.2
 - Build and test using Python 3.14.7

{backlogops-1.0 → backlogops-1.2}/backlogops.egg-info/requires.txt

@@ -1,8 +1,8 @@
-config-as-json>=1.5
-cryptography>=50.0.0
+config-as-json>=1.7
+cryptography>=50.0.1
 jira[cli,opt]>=3.10.5
 tableio>=1.1
-tableio-cfg-json>=1.3
+tableio-cfg-json>=1.4
 wizard-ui-bridge[textual]>=1.3
 versionreporter>=0.4
-edit-cfg-json==0.0.4
+edit-cfg-json>=0.2.0

{backlogops-1.0 → backlogops-1.2}/setup.py

@@ -5,7 +5,7 @@ from setuptools import setup
 
 setup(
   name='backlogops',
-  version='1.0',
+  version='1.2',
   description='Library with backlog operations.',
   author='Tom Björkholm',
   author_email='klausuler_linnet0q@icloud.com',
@@ -14,13 +14,13 @@ setup(
   package_dir={'backlogops': 'src/backlogops'},
   package_data={'backlogops': ['src/py.typed']},
   install_requires=[
-    'config-as-json >= 1.5',
-    'cryptography >= 50.0.0',
+    'config-as-json >= 1.7',
+    'cryptography >= 50.0.1',
     'jira[cli,opt] >= 3.10.5',
     'tableio >= 1.1',
-    'tableio-cfg-json >= 1.3',
+    'tableio-cfg-json >= 1.4',
     'wizard-ui-bridge[textual] >= 1.3',
     'versionreporter >= 0.4',
-    'edit-cfg-json == 0.0.4'
+    'edit-cfg-json >= 0.2.0',
   ]
 )

{backlogops-1.0 → backlogops-1.2}/src/backlogops/available_teams_config.py

@@ -117,16 +117,20 @@ class _BridgeConfig(Config):
         return {}
 
     def __init__(self, from_json_data_text: Optional[str],
-                 from_json_filename: Optional[PathOrStr],
-                 stderr_file: TextIO) -> None:
+                 from_json_filename: Optional[PathOrStr], stderr_file: TextIO,
+                 *, member_name: Optional[str] = None) -> None:
         """Run the Config lifecycle for a bridge instance.
 
         Each bridge first creates its data class attributes, then calls
         this constructor to read JSON, apply defaults, and validate.
+        ``member_name`` is the path for reaching this object from the top
+        level configuration, so that a diagnostic about a value inside it
+        names the whole path; it is None for a bridge that is a whole
+        configuration file of its own.
         """
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        stderr_file=stderr_file)
+                        stderr_file=stderr_file, member_name=member_name)
 
     @staticmethod
     def _consistency() -> WholeConfigValidationStep:
@@ -154,12 +158,13 @@ class FteExceptionConfig(FteException, _BridgeConfig):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create placeholder defaults, then read one FTE exception."""
         FteException.__init__(self, start_date=date(2000, 1, 1),
                               end_date=date(2000, 1, 1), fte=1.0)
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def get_validation_plan(self, stderr_file: TextIO) -> ValidationPlan:
@@ -179,13 +184,14 @@ class ExceptionWorkHoursConfig(ExceptionWorkHours, _BridgeConfig):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create placeholder defaults, then read one work-hours exception."""
         ExceptionWorkHours.__init__(self, start_date=date(2000, 1, 1),
                                     end_date=date(2000, 1, 1),
                                     hours_per_day=0.0)
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def get_validation_plan(self, stderr_file: TextIO) -> ValidationPlan:
@@ -205,11 +211,12 @@ class MembershipConfig(Membership, _BridgeConfig):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create placeholder defaults, then read one membership."""
         Membership.__init__(self, person_name='person')
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def nested_configs(self) -> NestedConfigs:
@@ -241,12 +248,13 @@ class TeamConfig(Team, _BridgeConfig):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create placeholder defaults, then read one team."""
         Team.__init__(self, name='team', velocity=0.0, sum_fte_at_velocity=1.0,
                       sprint_length=1)
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def nested_configs(self) -> NestedConfigs:
@@ -266,11 +274,12 @@ class PersonConfig(Person, _BridgeConfig):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create placeholder defaults, then read one person."""
         Person.__init__(self, name='person')
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def nested_configs(self) -> NestedConfigs:
@@ -291,12 +300,13 @@ class CompanyWorkHoursConfig(CompanyWorkHours, _BridgeConfig):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create defaults, then read the company work hours."""
         CompanyWorkHours.__init__(self)
         self._unchecked_dicts = ['work_hours']
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def nested_configs(self) -> NestedConfigs:
@@ -328,7 +338,8 @@ class AvailableTeamsConfig(AvailableTeams, _BridgeConfig):
     def __init__(self, *, neutral: Optional[AvailableTeams] = None,
                  from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr,
+                 member_name: Optional[str] = None) -> None:
         """Create the bridge from a neutral workforce or from JSON.
 
         ``AvailableTeams.__init__`` is intentionally not invoked because
@@ -340,7 +351,7 @@ class AvailableTeamsConfig(AvailableTeams, _BridgeConfig):
             neutral = AvailableTeams(persons={}, teams=[])
         Config.copy_initial_data(neutral, self)
         _BridgeConfig.__init__(self, from_json_data_text, from_json_filename,
-                               stderr_file)
+                               stderr_file, member_name=member_name)
 
     @override
     def nested_configs(self) -> NestedConfigs:

{backlogops-1.0 → backlogops-1.2}/src/backlogops/backlog_ops_config.py

@@ -17,7 +17,10 @@ item levels:
   :class:`backlogops.jira_io_config.JiraIOConfig`;
 * ``levels`` is the optional list of backlog item levels. It is omitted
   from the file while it is ``None``; :meth:`BacklogOpsConfig.get_levels`
-  then falls back to :data:`backlogops.levels.DEFAULT_LEVELS`.
+  then falls back to :data:`backlogops.levels.DEFAULT_LEVELS`. An empty
+  list is refused, because it would mean no levels at all where the
+  omitted member means the built-in ones, and the configuration editor
+  offers giving that member an empty list.
 
 Earlier file versions stored the workforce members (``persons``,
 ``teams`` and ``company_work_hours``) at the top level next to the
@@ -36,7 +39,8 @@ from config_as_json import CallingWholeConfigValidator, Config, \
     ConfigAutoChangeHook, ConfigNesting, ConfigNestingKind, ConfigPath, \
     JsonType, MemberValidationStep, MemberValidator, NestedConfigs, \
     PathOrStr, ReadOldConfiguration, RocfKeyMove, SerializeConverter, \
-    SerializeConverters, ValidationPlan, WholeConfigValidationStep
+    SerializeConverters, ValidationPlan, WholeConfigValidationStep, \
+    member_path
 from backlogops.available_teams import AvailableTeams
 from backlogops.available_teams_config import AvailableTeamsConfig
 from backlogops.backlog import Status
@@ -72,19 +76,32 @@ def _as_str_list(name: str, value: object, stderr_file: TextIO) -> list[str]:
     return result
 
 
-def _level_from_dict(data: dict[str, object], stderr_file: TextIO) -> Level:
-    """Return one Level from its JSON object, checking the field shape."""
+def _level_from_dict(name: str, data: dict[str, object],
+                     stderr_file: TextIO) -> Level:
+    """Return one Level from its JSON object, checking the field shape.
+
+    Args:
+        name: Reported path of the level itself, such as ``levels[2]``,
+            which each field name is appended to.
+        data: The JSON object holding the fields of one level.
+        stderr_file: The file to report errors to.
+
+    Returns:
+        The level the JSON object describes.
+    """
     unknown = sorted(set(data) - {'level', 'name', 'aliases'})
     if unknown:
-        report_bad_value('level', data, f'unknown level fields {unknown}',
+        report_bad_value(name, data, f'unknown level fields {unknown}',
                          stderr_file, 'Level')
     if 'level' not in data or 'name' not in data:
-        report_bad_value('level', data, 'requires "level" and "name"',
+        report_bad_value(name, data, 'requires "level" and "name"',
                          stderr_file, 'Level')
-    return Level(level=_as_int('level', data['level'], stderr_file),
-                 name=_as_str('name', data['name'], stderr_file),
-                 aliases=_as_str_list('aliases', data.get('aliases', []),
-                                      stderr_file))
+    return Level(level=_as_int(member_path(name, 'level'), data['level'],
+                               stderr_file),
+                 name=_as_str(member_path(name, 'name'), data['name'],
+                              stderr_file),
+                 aliases=_as_str_list(member_path(name, 'aliases'),
+                                      data.get('aliases', []), stderr_file))
 
 
 def _level_from_obj(name: str, value: object, stderr_file: TextIO) -> Level:
@@ -93,7 +110,13 @@ def _level_from_obj(name: str, value: object, stderr_file: TextIO) -> Level:
         return value
     if not isinstance(value, dict):
         report_wrong_type(name, value, dict, stderr_file, 'Level')
-    return _level_from_dict(value, stderr_file)
+    return _level_from_dict(name, value, stderr_file)
+
+
+_NO_LEVELS = ('no levels at all; a configuration that leaves the levels out '
+              'uses the built-in ones, so take the member away rather than '
+              'emptying it')
+"""Why an empty list of levels is not a configuration with no levels."""
 
 
 # pylint: disable-next=too-few-public-methods
@@ -104,13 +127,23 @@ class _LevelsMember(MemberValidator):
     def validate_member(self, config: Config, member_name: str,
                         member_value: object,
                         stderr_file: TextIO = sys.stderr) -> Optional[object]:
-        """Return the levels as a list of ``Level``, or ``None``."""
+        """Return the levels as a list of ``Level``, or ``None``.
+
+        Raises:
+            TypeError: The member holds something that is no list of
+                levels.
+            ValueError: The member holds an empty list, which is not a
+                configuration of the levels; leaving the member out is.
+        """
         _ = config
         if member_value is None:
             return None
         if not isinstance(member_value, list):
             report_wrong_type(member_name, member_value, list, stderr_file,
                               'BacklogOps config')
+        if not member_value:
+            report_bad_value(member_name, member_value, _NO_LEVELS,
+                             stderr_file, 'BacklogOps config')
         return [_level_from_obj(f'{member_name}[{index}]', element,
                                 stderr_file)
                 for index, element in enumerate(member_value)]
@@ -173,11 +206,15 @@ DEF_STATUS_INPUT_MAP: dict[str, Status] = {
 class BacklogOpsConfig(Config):  # pylint: disable=too-many-instance-attributes
     """Top-level backlog-ops configuration stored as config-as-json."""
 
+    # The library contract fixes five of these; the workforce is the one
+    # argument of this application, and every one of them is keyword only.
+    # pylint: disable-next=too-many-arguments
     def __init__(self, *, available_teams: Optional[AvailableTeams] = None,
                  from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr,
+                 member_name: Optional[str] = None) -> None:
         """Create defaults, or read the configuration from JSON.
 
         The supplied workforce establishes the schema of the nested
@@ -185,7 +222,11 @@ class BacklogOpsConfig(Config):  # pylint: disable=too-many-instance-attributes
         into an :class:`AvailableTeamsConfig`. The presets default to
         empty maps and the levels default to ``None`` (use the defaults).
         The ``auto_ch_hook`` is notified when an old file needed
-        backward-compatible normalization while reading.
+        backward-compatible normalization while reading. The default
+        nested sections are created under the path of the member holding
+        each of them, so that a diagnostic names the whole path even
+        before any file is read; ``member_name`` is None for a whole
+        configuration file, which is a member of nothing.
         """
         self.available_teams: AvailableTeams = (
             AvailableTeams(persons={}, teams=[]) if available_teams is None
@@ -193,14 +234,18 @@ class BacklogOpsConfig(Config):  # pylint: disable=too-many-instance-attributes
         self.input_configs: dict[str, InputFormatConfig] = {}
         self.output_configs: dict[str, OutputFormatConfig] = {}
         self.gui_display: GuiDisplayConfig = GuiDisplayConfig(
-            stderr_file=stderr_file)
+            stderr_file=stderr_file,
+            member_name=member_path(member_name, 'gui_display'))
         self.status_input_map: dict[str, Status] = DEF_STATUS_INPUT_MAP
-        self.jira: JiraIOConfig = JiraIOConfig(stderr_file=stderr_file)
+        self.jira: JiraIOConfig = JiraIOConfig(
+            stderr_file=stderr_file,
+            member_name=member_path(member_name, 'jira'))
         self.levels: Optional[list[Level]] = None
         self._unchecked_dicts = ['status_input_map']
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file)
+                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file,
+                        member_name=member_name)
 
     @override
     def _get_read_old_config(self) -> ReadOldConfiguration:

{backlogops-1.0 → backlogops-1.2}/src/backlogops/config_editing.py

@@ -27,19 +27,39 @@ toolkit mounts the editor itself — ``edit_cfg_json_tk.TkEditorPanel`` in a
 window of the application, ``edit_cfg_json_textual.edit`` in a terminal of
 its own — and hands those two answers to it.
 
-Three things the editor cannot do are worth knowing before it is offered
-instead of the wizard, and all three are of ``edit_cfg_json`` itself rather
-than of this configuration:
-
-* A dict whose keys the application validates for itself cannot gain or
-  lose a key. That is the status map, the column-name maps of a preset and
-  of the display, and the Jira column and issue-type maps: their values are
-  editable, and a new entry is the wizard's to create.
-* A member left out of the file has no row, so the levels can be edited
-  only in a configuration that already states them.
+How many things a member holds is the editor's to change as well, so a
+named preset, a Jira connection, a person, a team, a membership, an
+exception, a level and an entry of any of the maps can each be added beside
+the ones that are there, taken out again, and moved within a list. A new
+element is never invented: it is an object of the class the declaration
+names, a copy of what the container holds now, or the empty value that the
+declared type of the member says an element is. That is what the first of
+the notes below follows from.
+
+Four things are worth knowing before the editor is offered instead of the
+wizard:
+
+* One entry of the Jira column maps and of the issue-type maps is a map of
+  its own, which the class does not name a type for, so there is no pattern
+  for one until the file holds one to copy: an empty map of those offers
+  nothing and says why below itself. Every other container can be given its
+  first element, because the class names the type of one or its declared
+  type says what an element is.
+* The levels keep a row in a configuration that leaves them out, because a
+  member the class omits is still a member. What that row offers is an
+  empty list, which is not what leaving the levels out means and is
+  refused as such: the row's other control puts the member back to holding
+  nothing, which is the built-in levels. Writing the levels the first time
+  is the wizard's.
 * A person is keyed by their own name in lower case, so renaming one means
   adding an entry under the new key and removing the old one; editing the
   name alone leaves a configuration the class refuses.
+* The editor reads the declarations of a class and not the insides of its
+  validators, so it offers a change that this library then refuses where
+  only a validator knows better: a week day taken out of the company
+  schedule, or a level that loses its name, because a level is a plain
+  object in the file rather than a nested configuration class. What the
+  class said is shown at the member it is about.
 """
 
 # Copyright (c) 2026, Tom Björkholm

{backlogops-1.0 → backlogops-1.2}/src/backlogops/io_config.py

@@ -48,7 +48,7 @@ from config_as_json import Config, ConfigAutoChangeHook, ConfigNesting, \
     ConfigNestingKind, ConfigPath, InvalidConfiguration, \
     MemberValidationStep, MemberValidator, NestedConfigs, ParseConverter, \
     PathOrStr, ReadOldConfiguration, RocfKeyMove, RocfValueMigration, \
-    RocfValueWrite, ValidationPlan
+    RocfValueWrite, ValidationPlan, member_path
 from tableio import Capabilities, FileAccess, access_capabilities
 from tableio_cfg_json import TioJsonConfig, tio_json_config_default
 from backlogops.backlog import Status
@@ -195,23 +195,25 @@ def _capabilities(file_access: FileAccess, stderr_file: TextIO
 
 
 def _tio_default(file_access: FileAccess, format_name: Optional[str] = None,
-                 stderr_file: TextIO = sys.stderr) -> TioJsonConfig:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> TioJsonConfig:
     """Return a default TableIO config for a format and file access."""
     return tio_json_config_default(
         capabilities=_capabilities(file_access, stderr_file),
         file_access=file_access, format_name=format_name,
-        stderr_file=stderr_file)
+        stderr_file=stderr_file, member_name=member_name)
 
 
 def _tio_from_json(file_access: FileAccess, from_json_data_text: Optional[str],
                    from_json_filename: Optional[PathOrStr],
-                   stderr_file: TextIO) -> TioJsonConfig:
+                   stderr_file: TextIO,
+                   member_name: Optional[str]) -> TioJsonConfig:
     """Return a TableIO config read from JSON for a file access mode."""
     return TioJsonConfig(capabilities=_capabilities(file_access, stderr_file),
                          file_access=file_access,
                          from_json_data_text=from_json_data_text,
                          from_json_filename=from_json_filename,
-                         stderr_file=stderr_file)
+                         stderr_file=stderr_file, member_name=member_name)
 
 
 class _FormatConfig(Config):
@@ -230,22 +232,31 @@ class _FormatConfig(Config):
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
-        """Create default settings or read them from a JSON source."""
-        self.tableio: TioJsonConfig = _tio_default(self._FILE_ACCESS,
-                                                   stderr_file=stderr_file)
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
+        """Create default settings or read them from a JSON source.
+
+        The default TableIO endpoint is created under the path of the
+        ``tableio`` member of this endpoint, so that a TableIO diagnostic
+        names which preset it is about even before any file is read.
+        """
+        self.tableio: TioJsonConfig = _tio_default(
+            self._FILE_ACCESS, stderr_file=stderr_file,
+            member_name=member_path(member_name, 'tableio'))
         self._unchecked_dicts = list(self._MAP_NAMES) + \
             list(self._UNCHECKED_EXTRA)
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file)
+                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file,
+                        member_name=member_name)
 
     def _tio_factory(self, *, from_json_data_text: Optional[str] = None,
                      from_json_filename: Optional[PathOrStr] = None,
-                     stderr_file: TextIO = sys.stderr) -> TioJsonConfig:
+                     stderr_file: TextIO = sys.stderr,
+                     member_name: Optional[str] = None) -> TioJsonConfig:
         """Construct the nested TableIO config from JSON when reading."""
         return _tio_from_json(self._FILE_ACCESS, from_json_data_text,
-                              from_json_filename, stderr_file)
+                              from_json_filename, stderr_file, member_name)
 
     def _map_validator(self) -> MemberValidator:
         """Return the validator applied to each column-name map member."""
@@ -334,7 +345,8 @@ class InputFormatConfig(_FormatConfig):
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create the input map defaults, then run the shared constructor."""
         self.backlog_to_internal = {}
         self.release_to_internal = {}
@@ -342,7 +354,8 @@ class InputFormatConfig(_FormatConfig):
         _FormatConfig.__init__(self, from_json_data_text=from_json_data_text,
                                from_json_filename=from_json_filename,
                                auto_ch_hook=auto_ch_hook,
-                               stderr_file=stderr_file)
+                               stderr_file=stderr_file,
+                               member_name=member_name)
 
     @override
     def _get_read_old_config(self) -> ReadOldConfiguration:
@@ -381,7 +394,8 @@ class OutputFormatConfig(_FormatConfig):
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create the output defaults, then run the shared constructor."""
         self.backlog_to_external = {}
         self.release_to_external = {}
@@ -389,7 +403,8 @@ class OutputFormatConfig(_FormatConfig):
         _FormatConfig.__init__(self, from_json_data_text=from_json_data_text,
                                from_json_filename=from_json_filename,
                                auto_ch_hook=auto_ch_hook,
-                               stderr_file=stderr_file)
+                               stderr_file=stderr_file,
+                               member_name=member_name)
 
     @override
     def parse_converters(self) -> dict[str, ParseConverter]:
@@ -450,7 +465,8 @@ class GuiDisplayConfig(Config):
 
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create the display defaults, then read them from JSON."""
         self.backlog_to_external = {}
         self.release_to_external = {}
@@ -458,7 +474,7 @@ class GuiDisplayConfig(Config):
         self._unchecked_dicts = ['backlog_to_external', 'release_to_external']
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        stderr_file=stderr_file)
+                        stderr_file=stderr_file, member_name=member_name)
 
     @override
     def parse_converters(self) -> dict[str, ParseConverter]:

{backlogops-1.0 → backlogops-1.2}/src/backlogops/jira_io_config.py

@@ -420,7 +420,8 @@ class JiraConnectConfig(Config):
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create connection defaults, then read them from JSON."""
         self.jira_type = JiraType.CLOUD
         self.base_url = ''
@@ -431,7 +432,8 @@ class JiraConnectConfig(Config):
         self._cached_token: Optional[str] = None
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file)
+                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file,
+                        member_name=member_name)
 
     @override
     def _omit_none_from_json(self) -> list[str]:
@@ -600,7 +602,8 @@ class JiraPreset(Config):
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create preset defaults, then read them from JSON."""
         self.connection_name = ''
         self.backlog_column_map_name = ''
@@ -611,7 +614,8 @@ class JiraPreset(Config):
         self.def_filter = ''
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file)
+                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file,
+                        member_name=member_name)
 
     @override
     def _get_read_old_config(self) -> ReadOldConfiguration:
@@ -695,7 +699,8 @@ class JiraIOConfig(Config):
     def __init__(self, from_json_data_text: Optional[str] = None,
                  from_json_filename: Optional[PathOrStr] = None,
                  auto_ch_hook: Optional[ConfigAutoChangeHook] = None,
-                 stderr_file: TextIO = sys.stderr) -> None:
+                 stderr_file: TextIO = sys.stderr, *,
+                 member_name: Optional[str] = None) -> None:
         """Create empty defaults, then read the jira configuration."""
         self.connections: dict[str, JiraConnectConfig] = {}
         self.backlog_column_maps: dict[str, JiraColumnMap] = {}
@@ -706,7 +711,8 @@ class JiraIOConfig(Config):
                                  'issue_type_maps']
         Config.__init__(self, from_json_data_text=from_json_data_text,
                         from_json_filename=from_json_filename,
-                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file)
+                        auto_ch_hook=auto_ch_hook, stderr_file=stderr_file,
+                        member_name=member_name)
 
     @override
     def _get_read_old_config(self) -> ReadOldConfiguration: