backlogops 1.0__tar.gz → 1.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops
-Version: 1.0
+Version: 1.1
 Summary: Library with backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -22,13 +22,13 @@ 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: 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: 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.1.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: 2298 passed, 1 deselected in 57s
 - No flake8 warnings.
 - No mypy errors found.
 - No pylint warnings.
 - No python layout warnings.
-- Built version(s): 1.0
+- Built version(s): 1.1
 - Build and test using Python 3.14.7

{backlogops-1.0 → backlogops-1.1}/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: 2298 passed, 1 deselected in 57s
 - No flake8 warnings.
 - No mypy errors found.
 - No pylint warnings.
 - No python layout warnings.
-- Built version(s): 1.0
+- Built version(s): 1.1
 - Build and test using Python 3.14.7

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops
-Version: 1.0
+Version: 1.1
 Summary: Library with backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -22,13 +22,13 @@ 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: 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: 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.1.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: 2298 passed, 1 deselected in 57s
 - No flake8 warnings.
 - No mypy errors found.
 - No pylint warnings.
 - No python layout warnings.
-- Built version(s): 1.0
+- Built version(s): 1.1
 - Build and test using Python 3.14.7

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

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

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

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

{backlogops-1.0 → backlogops-1.1}/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
@@ -96,6 +99,12 @@ def _level_from_obj(name: str, value: object, stderr_file: TextIO) -> Level:
     return _level_from_dict(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
 class _LevelsMember(MemberValidator):
     """Convert the optional ``levels`` member into a list of ``Level``."""
@@ -104,13 +113,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)]

{backlogops-1.0 → backlogops-1.1}/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