backlogops-gui 1.3__tar.gz → 1.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. {backlogops_gui-1.3 → backlogops_gui-1.5}/PKG-INFO +34 -15
  2. {backlogops_gui-1.3 → backlogops_gui-1.5}/README_pypi.md +27 -9
  3. {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/PKG-INFO +34 -15
  4. backlogops_gui-1.5/backlogops_gui.egg-info/requires.txt +6 -0
  5. {backlogops_gui-1.3 → backlogops_gui-1.5}/pyproject.toml +1 -0
  6. {backlogops_gui-1.3 → backlogops_gui-1.5}/setup.py +6 -6
  7. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/application.py +13 -8
  8. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_actions.py +65 -18
  9. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_io.py +6 -2
  10. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_window.py +58 -35
  11. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/blog_version_reporter.py +1 -1
  12. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_update.py +6 -2
  13. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_write.py +1 -0
  14. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/table_view.py +33 -10
  15. backlogops_gui-1.3/backlogops_gui.egg-info/requires.txt +0 -6
  16. {backlogops_gui-1.3 → backlogops_gui-1.5}/LICENSE.txt +0 -0
  17. {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/SOURCES.txt +0 -0
  18. {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/dependency_links.txt +0 -0
  19. {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/entry_points.txt +0 -0
  20. {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/top_level.txt +0 -0
  21. {backlogops_gui-1.3 → backlogops_gui-1.5}/setup.cfg +0 -0
  22. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/__init__.py +0 -0
  23. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/__main__.py +0 -0
  24. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/_migrate_warn.py +0 -0
  25. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_dialogs.py +0 -0
  26. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/choice_dialogs.py +0 -0
  27. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/config_edit.py +0 -0
  28. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/file_choosers.py +0 -0
  29. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/format_dialogs.py +0 -0
  30. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_actions.py +0 -0
  31. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_base.py +0 -0
  32. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_dialogs.py +0 -0
  33. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_order.py +0 -0
  34. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_rank.py +0 -0
  35. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_read.py +0 -0
  36. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_rename.py +0 -0
  37. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/key_list_box.py +0 -0
  38. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/log_buffer.py +0 -0
  39. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/modal_dialog.py +0 -0
  40. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/py.typed +0 -0
  41. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/python_version.py +0 -0
  42. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/report_windows.py +0 -0
  43. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/tcltk_version.py +0 -0
  44. {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/token_dialog.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: backlogops-gui
3
- Version: 1.3
3
+ Version: 1.5
4
4
  Summary: Graphical user interface for backlog operations.
5
5
  Author: Tom Björkholm
6
6
  Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3
13
13
  Classifier: Programming Language :: Python :: 3.12
14
14
  Classifier: Programming Language :: Python :: 3.13
15
15
  Classifier: Programming Language :: Python :: 3.14
16
+ Classifier: Programming Language :: Python :: 3.15
16
17
  Classifier: Operating System :: OS Independent
17
18
  Classifier: Intended Audience :: End Users/Desktop
18
19
  Classifier: Intended Audience :: Information Technology
@@ -21,12 +22,12 @@ Classifier: Typing :: Typed
21
22
  Requires-Python: >=3.12
22
23
  Description-Content-Type: text/markdown
23
24
  License-File: LICENSE.txt
24
- Requires-Dist: backlogops>=1.3
25
+ Requires-Dist: backlogops>=1.5
25
26
  Requires-Dist: argcomplete>=3.7.2
26
- Requires-Dist: wizard-ui-bridge>=1.4
27
- Requires-Dist: wizard-tk-bridge>=1.4
28
- Requires-Dist: edit-cfg-json-tk>=0.3.0
29
- Requires-Dist: versionreporter>=0.4
27
+ Requires-Dist: wizard-ui-bridge>=1.5
28
+ Requires-Dist: wizard-tk-bridge>=1.5
29
+ Requires-Dist: edit-cfg-json-tk>=1.0.0
30
+ Requires-Dist: versionreporter>=0.5
30
31
  Dynamic: author
31
32
  Dynamic: license-file
32
33
  Dynamic: requires-dist
@@ -75,6 +76,10 @@ The following functionality is available in all 3 packages:
75
76
  - Estimate ready date for the backlog items based on available teams, team
76
77
  velocity, vacation dates, periods with half time work, etc.
77
78
 
79
+ - Alternatively, where remaining time estimates are required, estimate ready
80
+ dates from the remaining time of the backlog items and the focus factor of the
81
+ teams (story points are recommended).
82
+
78
83
  - Configure what a backlog item that nobody has estimated counts as, per backlog
79
84
  item level, so that an unestimated item does not make the estimated dates too
80
85
  optimistic.
@@ -103,6 +108,9 @@ The following functionality is available in all 3 packages:
103
108
 
104
109
  - Rename columns when reading a file and when writing a file.
105
110
 
111
+ - Leave out columns that are empty on every row, when writing a file and when
112
+ showing the backlog in the GUI.
113
+
106
114
  - Map custom status names in input files to backlog item statuses.
107
115
 
108
116
  - Choose how backlog item levels are written: by number, by name, or both, and
@@ -114,8 +122,8 @@ The following functionality is available in all 3 packages:
114
122
 
115
123
  - A wizard to create a backlog-ops configuration file with the workforce, named
116
124
  input and output presets, level names, status name mapping, the guess for
117
- unestimated items, how the graphical user interface shows the data, and the
118
- Jira integration.
125
+ unestimated items, whether remaining time estimates are also used, how the
126
+ graphical user interface shows the data, and the Jira integration.
119
127
 
120
128
  - An editor showing a whole configuration file or a stand-alone preset file at
121
129
  once, folded where it is deep, to change a single value without stepping
@@ -145,6 +153,10 @@ The following functionality is available in all 3 packages:
145
153
  Jira refused or what was skipped, so a value that was not written is visible
146
154
  without reading the whole listing.
147
155
 
156
+ - Show the custom fields of Jira, the fields an issue's edit screen accepts, and
157
+ the raw JSON Jira holds for a field of an issue, to find the correct Jira
158
+ field mapping.
159
+
148
160
  ## The operating model
149
161
 
150
162
  The operating model that most of the functionality is designed for is that the
@@ -153,8 +165,8 @@ are ordered by priority and dependencies to allow the teams to work in the
153
165
  backlog order. Each backlog item and each release may have a planned ready date,
154
166
  that records what has been communicated to the customer. Each backlog item and
155
167
  each release may have an estimated ready date, that is calculated from the
156
- current backlog state, the team velocity, and what we know about the
157
- availability of the team members.
168
+ current backlog state, the team velocity (or, for remaining time estimates, the
169
+ focus factor), and what we know about the availability of the team members.
158
170
 
159
171
  ## The backlog item fields
160
172
 
@@ -189,7 +201,11 @@ the library:
189
201
 
190
202
  - `team` The team responsible for the backlog item. Optional. Must not be empty
191
203
  string. Must be a valid team name. If None the item can be done by any team.
192
- If not None. the item can only be done by the specified team.
204
+ If not None, the item can only be done by the specified team.
205
+
206
+ - `remaining_time` The remaining time of the backlog item, as ideal focused work
207
+ time of one person. Optional. Only used by the alternative remaining time
208
+ estimates; story points are recommended. Must not be negative.
193
209
 
194
210
  - `depends_on_f2s` The list of keys of the backlog items that must have been
195
211
  finished before the current item can start. May be empty.
@@ -229,7 +245,7 @@ pip install --upgrade backlogops-gui
229
245
 
230
246
  For a better understanding of how to use the library, CLI or GUI, see the user
231
247
  documentation:
232
- [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc//using_backlogops/README.md)
248
+ [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/using_backlogops/README.md)
233
249
 
234
250
  ## API documentation
235
251
 
@@ -366,6 +382,9 @@ succeeded. When something was refused the pop-up title is marked
366
382
 
367
383
  - Estimate ready date...
368
384
 
385
+ - Estimate ready date from remaining time... (greyed out unless
386
+ remaining time estimates are enabled in the configuration)
387
+
369
388
  - Set planned date from estimated
370
389
 
371
390
  - Adjust release content...
@@ -398,10 +417,10 @@ succeeded. When something was refused the pop-up title is marked
398
417
 
399
418
  ## Test summary
400
419
 
401
- - Test result: 2555 passed, 1 deselected in 58s
420
+ - Test result: 2963 passed, 1 deselected in 74s (0:01:14)
402
421
  - No flake8 warnings.
403
422
  - No mypy errors found.
404
423
  - No pylint warnings.
405
424
  - No python layout warnings.
406
- - Built version(s): 1.3
407
- - Build and test using Python 3.14.7
425
+ - Built version(s): 1.5
426
+ - Build and test using Python 3.15.2
@@ -41,6 +41,10 @@ The following functionality is available in all 3 packages:
41
41
  - Estimate ready date for the backlog items based on available teams, team
42
42
  velocity, vacation dates, periods with half time work, etc.
43
43
 
44
+ - Alternatively, where remaining time estimates are required, estimate ready
45
+ dates from the remaining time of the backlog items and the focus factor of the
46
+ teams (story points are recommended).
47
+
44
48
  - Configure what a backlog item that nobody has estimated counts as, per backlog
45
49
  item level, so that an unestimated item does not make the estimated dates too
46
50
  optimistic.
@@ -69,6 +73,9 @@ The following functionality is available in all 3 packages:
69
73
 
70
74
  - Rename columns when reading a file and when writing a file.
71
75
 
76
+ - Leave out columns that are empty on every row, when writing a file and when
77
+ showing the backlog in the GUI.
78
+
72
79
  - Map custom status names in input files to backlog item statuses.
73
80
 
74
81
  - Choose how backlog item levels are written: by number, by name, or both, and
@@ -80,8 +87,8 @@ The following functionality is available in all 3 packages:
80
87
 
81
88
  - A wizard to create a backlog-ops configuration file with the workforce, named
82
89
  input and output presets, level names, status name mapping, the guess for
83
- unestimated items, how the graphical user interface shows the data, and the
84
- Jira integration.
90
+ unestimated items, whether remaining time estimates are also used, how the
91
+ graphical user interface shows the data, and the Jira integration.
85
92
 
86
93
  - An editor showing a whole configuration file or a stand-alone preset file at
87
94
  once, folded where it is deep, to change a single value without stepping
@@ -111,6 +118,10 @@ The following functionality is available in all 3 packages:
111
118
  Jira refused or what was skipped, so a value that was not written is visible
112
119
  without reading the whole listing.
113
120
 
121
+ - Show the custom fields of Jira, the fields an issue's edit screen accepts, and
122
+ the raw JSON Jira holds for a field of an issue, to find the correct Jira
123
+ field mapping.
124
+
114
125
  ## The operating model
115
126
 
116
127
  The operating model that most of the functionality is designed for is that the
@@ -119,8 +130,8 @@ are ordered by priority and dependencies to allow the teams to work in the
119
130
  backlog order. Each backlog item and each release may have a planned ready date,
120
131
  that records what has been communicated to the customer. Each backlog item and
121
132
  each release may have an estimated ready date, that is calculated from the
122
- current backlog state, the team velocity, and what we know about the
123
- availability of the team members.
133
+ current backlog state, the team velocity (or, for remaining time estimates, the
134
+ focus factor), and what we know about the availability of the team members.
124
135
 
125
136
  ## The backlog item fields
126
137
 
@@ -155,7 +166,11 @@ the library:
155
166
 
156
167
  - `team` The team responsible for the backlog item. Optional. Must not be empty
157
168
  string. Must be a valid team name. If None the item can be done by any team.
158
- If not None. the item can only be done by the specified team.
169
+ If not None, the item can only be done by the specified team.
170
+
171
+ - `remaining_time` The remaining time of the backlog item, as ideal focused work
172
+ time of one person. Optional. Only used by the alternative remaining time
173
+ estimates; story points are recommended. Must not be negative.
159
174
 
160
175
  - `depends_on_f2s` The list of keys of the backlog items that must have been
161
176
  finished before the current item can start. May be empty.
@@ -195,7 +210,7 @@ pip install --upgrade backlogops-gui
195
210
 
196
211
  For a better understanding of how to use the library, CLI or GUI, see the user
197
212
  documentation:
198
- [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc//using_backlogops/README.md)
213
+ [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/using_backlogops/README.md)
199
214
 
200
215
  ## API documentation
201
216
 
@@ -332,6 +347,9 @@ succeeded. When something was refused the pop-up title is marked
332
347
 
333
348
  - Estimate ready date...
334
349
 
350
+ - Estimate ready date from remaining time... (greyed out unless
351
+ remaining time estimates are enabled in the configuration)
352
+
335
353
  - Set planned date from estimated
336
354
 
337
355
  - Adjust release content...
@@ -364,10 +382,10 @@ succeeded. When something was refused the pop-up title is marked
364
382
 
365
383
  ## Test summary
366
384
 
367
- - Test result: 2555 passed, 1 deselected in 58s
385
+ - Test result: 2963 passed, 1 deselected in 74s (0:01:14)
368
386
  - No flake8 warnings.
369
387
  - No mypy errors found.
370
388
  - No pylint warnings.
371
389
  - No python layout warnings.
372
- - Built version(s): 1.3
373
- - Build and test using Python 3.14.7
390
+ - Built version(s): 1.5
391
+ - Build and test using Python 3.15.2
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: backlogops-gui
3
- Version: 1.3
3
+ Version: 1.5
4
4
  Summary: Graphical user interface for backlog operations.
5
5
  Author: Tom Björkholm
6
6
  Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3
13
13
  Classifier: Programming Language :: Python :: 3.12
14
14
  Classifier: Programming Language :: Python :: 3.13
15
15
  Classifier: Programming Language :: Python :: 3.14
16
+ Classifier: Programming Language :: Python :: 3.15
16
17
  Classifier: Operating System :: OS Independent
17
18
  Classifier: Intended Audience :: End Users/Desktop
18
19
  Classifier: Intended Audience :: Information Technology
@@ -21,12 +22,12 @@ Classifier: Typing :: Typed
21
22
  Requires-Python: >=3.12
22
23
  Description-Content-Type: text/markdown
23
24
  License-File: LICENSE.txt
24
- Requires-Dist: backlogops>=1.3
25
+ Requires-Dist: backlogops>=1.5
25
26
  Requires-Dist: argcomplete>=3.7.2
26
- Requires-Dist: wizard-ui-bridge>=1.4
27
- Requires-Dist: wizard-tk-bridge>=1.4
28
- Requires-Dist: edit-cfg-json-tk>=0.3.0
29
- Requires-Dist: versionreporter>=0.4
27
+ Requires-Dist: wizard-ui-bridge>=1.5
28
+ Requires-Dist: wizard-tk-bridge>=1.5
29
+ Requires-Dist: edit-cfg-json-tk>=1.0.0
30
+ Requires-Dist: versionreporter>=0.5
30
31
  Dynamic: author
31
32
  Dynamic: license-file
32
33
  Dynamic: requires-dist
@@ -75,6 +76,10 @@ The following functionality is available in all 3 packages:
75
76
  - Estimate ready date for the backlog items based on available teams, team
76
77
  velocity, vacation dates, periods with half time work, etc.
77
78
 
79
+ - Alternatively, where remaining time estimates are required, estimate ready
80
+ dates from the remaining time of the backlog items and the focus factor of the
81
+ teams (story points are recommended).
82
+
78
83
  - Configure what a backlog item that nobody has estimated counts as, per backlog
79
84
  item level, so that an unestimated item does not make the estimated dates too
80
85
  optimistic.
@@ -103,6 +108,9 @@ The following functionality is available in all 3 packages:
103
108
 
104
109
  - Rename columns when reading a file and when writing a file.
105
110
 
111
+ - Leave out columns that are empty on every row, when writing a file and when
112
+ showing the backlog in the GUI.
113
+
106
114
  - Map custom status names in input files to backlog item statuses.
107
115
 
108
116
  - Choose how backlog item levels are written: by number, by name, or both, and
@@ -114,8 +122,8 @@ The following functionality is available in all 3 packages:
114
122
 
115
123
  - A wizard to create a backlog-ops configuration file with the workforce, named
116
124
  input and output presets, level names, status name mapping, the guess for
117
- unestimated items, how the graphical user interface shows the data, and the
118
- Jira integration.
125
+ unestimated items, whether remaining time estimates are also used, how the
126
+ graphical user interface shows the data, and the Jira integration.
119
127
 
120
128
  - An editor showing a whole configuration file or a stand-alone preset file at
121
129
  once, folded where it is deep, to change a single value without stepping
@@ -145,6 +153,10 @@ The following functionality is available in all 3 packages:
145
153
  Jira refused or what was skipped, so a value that was not written is visible
146
154
  without reading the whole listing.
147
155
 
156
+ - Show the custom fields of Jira, the fields an issue's edit screen accepts, and
157
+ the raw JSON Jira holds for a field of an issue, to find the correct Jira
158
+ field mapping.
159
+
148
160
  ## The operating model
149
161
 
150
162
  The operating model that most of the functionality is designed for is that the
@@ -153,8 +165,8 @@ are ordered by priority and dependencies to allow the teams to work in the
153
165
  backlog order. Each backlog item and each release may have a planned ready date,
154
166
  that records what has been communicated to the customer. Each backlog item and
155
167
  each release may have an estimated ready date, that is calculated from the
156
- current backlog state, the team velocity, and what we know about the
157
- availability of the team members.
168
+ current backlog state, the team velocity (or, for remaining time estimates, the
169
+ focus factor), and what we know about the availability of the team members.
158
170
 
159
171
  ## The backlog item fields
160
172
 
@@ -189,7 +201,11 @@ the library:
189
201
 
190
202
  - `team` The team responsible for the backlog item. Optional. Must not be empty
191
203
  string. Must be a valid team name. If None the item can be done by any team.
192
- If not None. the item can only be done by the specified team.
204
+ If not None, the item can only be done by the specified team.
205
+
206
+ - `remaining_time` The remaining time of the backlog item, as ideal focused work
207
+ time of one person. Optional. Only used by the alternative remaining time
208
+ estimates; story points are recommended. Must not be negative.
193
209
 
194
210
  - `depends_on_f2s` The list of keys of the backlog items that must have been
195
211
  finished before the current item can start. May be empty.
@@ -229,7 +245,7 @@ pip install --upgrade backlogops-gui
229
245
 
230
246
  For a better understanding of how to use the library, CLI or GUI, see the user
231
247
  documentation:
232
- [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc//using_backlogops/README.md)
248
+ [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/using_backlogops/README.md)
233
249
 
234
250
  ## API documentation
235
251
 
@@ -366,6 +382,9 @@ succeeded. When something was refused the pop-up title is marked
366
382
 
367
383
  - Estimate ready date...
368
384
 
385
+ - Estimate ready date from remaining time... (greyed out unless
386
+ remaining time estimates are enabled in the configuration)
387
+
369
388
  - Set planned date from estimated
370
389
 
371
390
  - Adjust release content...
@@ -398,10 +417,10 @@ succeeded. When something was refused the pop-up title is marked
398
417
 
399
418
  ## Test summary
400
419
 
401
- - Test result: 2555 passed, 1 deselected in 58s
420
+ - Test result: 2963 passed, 1 deselected in 74s (0:01:14)
402
421
  - No flake8 warnings.
403
422
  - No mypy errors found.
404
423
  - No pylint warnings.
405
424
  - No python layout warnings.
406
- - Built version(s): 1.3
407
- - Build and test using Python 3.14.7
425
+ - Built version(s): 1.5
426
+ - Build and test using Python 3.15.2
@@ -0,0 +1,6 @@
1
+ backlogops>=1.5
2
+ argcomplete>=3.7.2
3
+ wizard-ui-bridge>=1.5
4
+ wizard-tk-bridge>=1.5
5
+ edit-cfg-json-tk>=1.0.0
6
+ versionreporter>=0.5
@@ -20,6 +20,7 @@ classifiers = [
20
20
  "Programming Language :: Python :: 3.12",
21
21
  "Programming Language :: Python :: 3.13",
22
22
  "Programming Language :: Python :: 3.14",
23
+ "Programming Language :: Python :: 3.15",
23
24
  "Operating System :: OS Independent",
24
25
  "Intended Audience :: End Users/Desktop",
25
26
  "Intended Audience :: Information Technology",
@@ -5,7 +5,7 @@ from setuptools import setup
5
5
 
6
6
  setup(
7
7
  name='backlogops-gui',
8
- version='1.3',
8
+ version='1.5',
9
9
  description='Graphical user interface for backlog operations.',
10
10
  author='Tom Björkholm',
11
11
  author_email='klausuler_linnet0q@icloud.com',
@@ -19,11 +19,11 @@ setup(
19
19
  ]
20
20
  },
21
21
  install_requires=[
22
- 'backlogops >= 1.3',
22
+ 'backlogops >= 1.5',
23
23
  'argcomplete >= 3.7.2',
24
- 'wizard-ui-bridge >= 1.4',
25
- 'wizard-tk-bridge >= 1.4',
26
- 'edit-cfg-json-tk >= 0.3.0',
27
- 'versionreporter >= 0.4'
24
+ 'wizard-ui-bridge >= 1.5',
25
+ 'wizard-tk-bridge >= 1.5',
26
+ 'edit-cfg-json-tk >= 1.0.0',
27
+ 'versionreporter >= 0.5'
28
28
  ]
29
29
  )
@@ -23,8 +23,7 @@ when no configuration is found a startup dialog offers to run the wizard,
23
23
  load a configuration file, or exit. Cancelling the wizard or a dialog
24
24
  returns to that choice, so the application ends only when the user exits.
25
25
  The Jira menu actions of a backlog window are delegated to the collaborator
26
- objects in :mod:`backlogops_gui.jira_read`, :mod:`backlogops_gui.jira_write`
27
- and :mod:`backlogops_gui.jira_update`.
26
+ objects grouped in :mod:`backlogops_gui.jira_actions`.
28
27
  """
29
28
 
30
29
  # PYTHON_ARGCOMPLETE_OK
@@ -45,8 +44,9 @@ from wizard_tk_bridge import WizardUiBridgeTk
45
44
  from backlogops import (
46
45
  AvailableTeams, BacklogOpsConfig, BacklogReleases, CONFIG_EXTENSION,
47
46
  DefaultStoryPoints,
48
- GuiDisplayConfig, InputFormatConfig, Levels, OutputFormatConfig, Status,
49
- get_demo_backlog, get_backlog_ops_config, backlog_ops_wizard,
47
+ GuiDisplayConfig, InputFormatConfig, Levels, OutputFormatConfig,
48
+ RemainingTimeConfig, Status, get_demo_backlog, get_backlog_ops_config,
49
+ backlog_ops_wizard,
50
50
  preset_wizard, read_backlog_ops_config, read_io_preset, safe_write_config,
51
51
  encrypt_token_file, encrypt_token_to_file)
52
52
  from backlogops_gui.backlog_io import read_backlog
@@ -75,8 +75,8 @@ LOG_REFRESH_MS = 800
75
75
  HEADING_FONT = ('TkDefaultFont', 14, 'bold')
76
76
  INSTRUCTIONS = (
77
77
  'Use the menus to read a backlog from a file or from Jira, load a '
78
- 'configuration file, run the teams wizard, edit a configuration or a '
79
- 'preset file, create a stand-alone input or output preset file, '
78
+ 'configuration file, run the configuration wizard, edit a configuration '
79
+ 'or a preset file, create a stand-alone input or output preset file, '
80
80
  'migrate a preset file to the current format, write the current '
81
81
  'configuration to a file, or create a demonstration backlog. Each '
82
82
  'backlog opens in its own window. On macOS the menu bar is at the top '
@@ -203,12 +203,16 @@ class BacklogApp:
203
203
  """Return what an unestimated item is worked with, or None."""
204
204
  return self.config.default_story_points if self.config else None
205
205
 
206
+ def rt_config(self) -> Optional[RemainingTimeConfig]:
207
+ """Return the remaining time configuration, or None when absent."""
208
+ return self.config.remaining_time if self.config else None
209
+
206
210
  def status_map(self) -> Optional[dict[str, Status]]:
207
211
  """Return the library-wide status input map, or None when absent."""
208
212
  return self.config.get_status_input_map() if self.config else None
209
213
 
210
214
  def gui_display(self) -> GuiDisplayConfig:
211
- """Return the GUI display configuration (level display and maps)."""
215
+ """Return the GUI display configuration (levels, omission, maps)."""
212
216
  if self.config is None:
213
217
  return GuiDisplayConfig()
214
218
  return self.config.gui_display
@@ -620,7 +624,8 @@ class BacklogApp:
620
624
  BacklogWindow(self.root, data, title, self.out_presets,
621
625
  self.available_teams, self.log, self.levels,
622
626
  self.gui_display, warning, handlers,
623
- def_points=self.def_points, source=source, reload=reload)
627
+ def_points=self.def_points, rt_config=self.rt_config,
628
+ source=source, reload=reload)
624
629
 
625
630
  def report_versions(self) -> None:
626
631
  """Report version information into the log on a worker thread.
@@ -13,11 +13,11 @@ here too, so the same reporting pattern is shared.
13
13
  # MIT License
14
14
 
15
15
  import tkinter as tk
16
- from datetime import timedelta
16
+ from datetime import date, timedelta
17
17
  from typing import Callable, Optional, TextIO
18
18
  from backlogops import (
19
19
  AddedToJira, AvailableTeams, BacklogReleases, DefaultStoryPoints, Levels,
20
- OutputFormatConfig,
20
+ OutputFormatConfig, RemainingTimeConfig,
21
21
  ReleaseChanges, ReleaseDateChanges, UpdatedBacklogInJira, allow_overwrite,
22
22
  apply_jira_keys, format_add_result, format_backlog_updates,
23
23
  format_content_changes, format_date_changes, get_keys_in_order,
@@ -40,7 +40,8 @@ def save_backlog(parent: tk.Misc, data: BacklogReleases,
40
40
  presets: Optional[dict[str, OutputFormatConfig]],
41
41
  levels: Optional[Levels], sink: TextIO,
42
42
  on_error: Callable[[str, str], None],
43
- on_info: Callable[[str, str], None]) -> Optional[str]:
43
+ on_info: Callable[[str, str], None], *,
44
+ use_remaining_time: bool = False) -> Optional[str]:
44
45
  """Ask where and how to save a backlog and write it.
45
46
 
46
47
  Args:
@@ -52,6 +53,8 @@ def save_backlog(parent: tk.Misc, data: BacklogReleases,
52
53
  sink: Stream that receives low-level write diagnostics.
53
54
  on_error: Callback used to report a write failure.
54
55
  on_info: Callback used to report a successful write.
56
+ use_remaining_time: Whether remaining time estimates are used, as
57
+ documented for :func:`backlogops.write_backlog_releases`.
55
58
 
56
59
  Returns:
57
60
  The path written, or None when the save was cancelled or failed.
@@ -65,7 +68,8 @@ def save_backlog(parent: tk.Misc, data: BacklogReleases,
65
68
  return None
66
69
  try:
67
70
  write_backlog(data, path, options.config_value, presets,
68
- options.releases_first, sink, levels)
71
+ options.releases_first, sink, levels,
72
+ use_remaining_time=use_remaining_time)
69
73
  except WRITE_ERRORS as error:
70
74
  on_error('Could not write file', str(error))
71
75
  return None
@@ -248,17 +252,16 @@ def _run_change(parent: tk.Misc,
248
252
 
249
253
 
250
254
  # pylint: disable-next=too-many-arguments,too-many-positional-arguments
251
- def estimate_date(parent: tk.Misc, data: BacklogReleases,
252
- teams: Optional[AvailableTeams],
253
- points: Optional[DefaultStoryPoints], sink: TextIO,
254
- refresh: Callable[[], None],
255
- on_error: Callable[[str, str], None],
256
- on_info: Callable[[str, str], None]) -> None:
257
- """Ask for the start date and estimate the ready dates.
255
+ def _estimate_from(parent: tk.Misc, teams: Optional[AvailableTeams],
256
+ estimate: Callable[[AvailableTeams, Optional[date]],
257
+ ReleaseDateChanges], sink: TextIO,
258
+ refresh: Callable[[], None],
259
+ on_error: Callable[[str, str], None],
260
+ on_info: Callable[[str, str], None]) -> None:
261
+ """Ask for the start date and run one kind of ready date estimate.
258
262
 
259
- An unestimated backlog item is worked with what the configuration
260
- guesses for its level, so the guess of the loaded configuration is
261
- passed on with the workforce.
263
+ The estimate is given the workforce and the start date, and returns
264
+ the release date changes that the pop-up then lists.
262
265
  """
263
266
  if teams is None:
264
267
  on_error('No configuration',
@@ -268,17 +271,61 @@ def estimate_date(parent: tk.Misc, data: BacklogReleases,
268
271
  if choice is None:
269
272
  return
270
273
  ready_teams, start = teams, choice.start_date
271
- guess = DefaultStoryPoints() if points is None else points
272
274
 
273
275
  def change() -> tuple[str, Optional[Callable[[str], None]]]:
274
276
  """Estimate the dates and return the release date change report."""
275
- changes = data.estimate_ready_date(ready_teams, start, sink,
276
- default_story_points=guess)
277
- return _date_report(changes, sink)
277
+ return _date_report(estimate(ready_teams, start), sink)
278
278
  _run_change(parent, change, refresh, on_error, on_info,
279
279
  'Could not estimate ready date', 'Release date changes')
280
280
 
281
281
 
282
+ # pylint: disable-next=too-many-arguments,too-many-positional-arguments
283
+ def estimate_date(parent: tk.Misc, data: BacklogReleases,
284
+ teams: Optional[AvailableTeams],
285
+ points: Optional[DefaultStoryPoints], sink: TextIO,
286
+ refresh: Callable[[], None],
287
+ on_error: Callable[[str, str], None],
288
+ on_info: Callable[[str, str], None]) -> None:
289
+ """Ask for the start date and estimate the ready dates.
290
+
291
+ An unestimated backlog item is worked with what the configuration
292
+ guesses for its level, so the guess of the loaded configuration is
293
+ passed on with the workforce.
294
+ """
295
+ guess = DefaultStoryPoints() if points is None else points
296
+
297
+ def estimate(ready: AvailableTeams,
298
+ start: Optional[date]) -> ReleaseDateChanges:
299
+ """Estimate the ready dates from story points."""
300
+ return data.estimate_ready_date(ready, start, sink,
301
+ default_story_points=guess)
302
+ _estimate_from(parent, teams, estimate, sink, refresh, on_error, on_info)
303
+
304
+
305
+ # pylint: disable-next=too-many-arguments,too-many-positional-arguments
306
+ def estimate_rt_date(parent: tk.Misc, data: BacklogReleases,
307
+ teams: Optional[AvailableTeams],
308
+ rt_config: Optional[RemainingTimeConfig], sink: TextIO,
309
+ refresh: Callable[[], None],
310
+ on_error: Callable[[str, str], None],
311
+ on_info: Callable[[str, str], None]) -> None:
312
+ """Ask for the start date and estimate the ready dates from remaining time.
313
+
314
+ The remaining time configuration gives the default focus factor and
315
+ what an unestimated backlog item is worked with. When remaining time
316
+ estimates are not enabled the estimate is refused with an error
317
+ pop-up that says how to enable them, and the data is left unchanged.
318
+ """
319
+ config = (RemainingTimeConfig(stderr_file=sink) if rt_config is None
320
+ else rt_config)
321
+
322
+ def estimate(ready: AvailableTeams,
323
+ start: Optional[date]) -> ReleaseDateChanges:
324
+ """Estimate the ready dates from remaining time."""
325
+ return data.estimate_rt_ready_date(ready, config, start, sink)
326
+ _estimate_from(parent, teams, estimate, sink, refresh, on_error, on_info)
327
+
328
+
282
329
  def set_plan(data: BacklogReleases, sink: TextIO, refresh: Callable[[], None],
283
330
  on_error: Callable[[str, str], None],
284
331
  on_info: Callable[[str, str], None]) -> None:
@@ -63,7 +63,8 @@ def read_backlog(path: str, value: Optional[str],
63
63
  def write_backlog(data: BacklogReleases, path: str, value: Optional[str],
64
64
  presets: Optional[dict[str, OutputFormatConfig]],
65
65
  releases_first: bool, sink: Optional[TextIO] = None,
66
- levels: Optional[Levels] = None) -> None:
66
+ levels: Optional[Levels] = None, *,
67
+ use_remaining_time: bool = False) -> None:
67
68
  """Write a backlog and releases to one file.
68
69
 
69
70
  Args:
@@ -75,6 +76,8 @@ def write_backlog(data: BacklogReleases, path: str, value: Optional[str],
75
76
  sink: Stream for diagnostics, or None to discard them.
76
77
  levels: The levels used to write level names, or None for the
77
78
  default levels.
79
+ use_remaining_time: Whether remaining time estimates are used, as
80
+ documented for :func:`backlogops.write_backlog_releases`.
78
81
  """
79
82
  out = _sink(sink)
80
83
  config = resolve_output_config(value, data_file=path, presets=presets,
@@ -83,4 +86,5 @@ def write_backlog(data: BacklogReleases, path: str, value: Optional[str],
83
86
  rules = FormatRules(backlog_first=not releases_first)
84
87
  write_backlog_releases(data, path, config, rules, levels=levels,
85
88
  stderr_file=out,
86
- file_exists_callback=allow_overwrite)
89
+ file_exists_callback=allow_overwrite,
90
+ use_remaining_time=use_remaining_time)
@@ -28,13 +28,15 @@ from backlogops import (
28
28
  AddedReleasesToJira, AddedToJira, AvailableTeams, BacklogReleases,
29
29
  DefaultStoryPoints,
30
30
  GuiDisplayConfig, Levels, OrderedReleasesInJira, OutputFormatConfig,
31
- RankedInJira, RenamedReleasesInJira, UpdatedBacklogInJira,
31
+ RankedInJira, RemainingTimeConfig, RenamedReleasesInJira,
32
+ UpdatedBacklogInJira,
32
33
  UpdatedReleasesInJira, format_order_result, format_rank_result,
33
34
  format_release_result, format_release_updates, format_rename_result,
34
35
  report_has_problems)
35
36
  from backlogops_gui.backlog_actions import (
36
37
  adjust_content, apply_add_result, apply_update_result, estimate_date,
37
- extract_keys, order_by_deps, order_by_keys, order_by_release, order_dates,
38
+ estimate_rt_date, extract_keys, order_by_deps, order_by_keys,
39
+ order_by_release, order_dates,
38
40
  plan_dates, save_backlog, set_plan)
39
41
  from backlogops_gui.report_windows import show_text_report
40
42
  from backlogops_gui.table_view import (
@@ -118,6 +120,8 @@ class BacklogWindow:
118
120
  jira: Optional[JiraHandlers] = None, *,
119
121
  def_points: Callable[
120
122
  [], Optional[DefaultStoryPoints]] = lambda: None,
123
+ rt_config: Callable[
124
+ [], Optional[RemainingTimeConfig]] = lambda: None,
121
125
  source: Optional[BacklogSource] = None,
122
126
  reload: Optional[Callable[
123
127
  [Callable[[BacklogReleases, Optional[str]], None]],
@@ -135,7 +139,8 @@ class BacklogWindow:
135
139
  levels: Callable returning the configured levels, or None for
136
140
  the default levels.
137
141
  gui_display: Callable returning the GUI display configuration,
138
- which decides the level display and the per-table column
142
+ which decides the level display, whether a column that is
143
+ empty on every row is left out, and the per-table column
139
144
  renaming for the tables.
140
145
  warning: Warning text to show over the tables. When present,
141
146
  backlog operations are disabled and only saving remains.
@@ -144,6 +149,12 @@ class BacklogWindow:
144
149
  disables its menu item.
145
150
  def_points: Callable returning what the configuration works an
146
151
  unestimated backlog item with, or None for none.
152
+ rt_config: Callable returning the remaining time configuration,
153
+ or None for none. Whether it enables remaining time
154
+ estimates decides whether an empty remaining time column
155
+ is kept when empty columns are not left out anyway, and
156
+ whether the ready date can be estimated from remaining
157
+ time.
147
158
  source: Where the data came from and when it was read. When
148
159
  given, an information region is shown at the top of the
149
160
  window; when None no information region is shown.
@@ -151,22 +162,16 @@ class BacklogWindow:
151
162
  fresh data and any warning to the given apply callback. When
152
163
  given, a "Read again" button is offered; None disables it.
153
164
  """
154
- handlers = jira if jira is not None else JiraHandlers()
165
+ self._jira = jira if jira is not None else JiraHandlers()
155
166
  self._data = data
156
167
  self._presets = presets
157
168
  self._teams = teams
158
169
  self._def_points = def_points
170
+ self._rt_config = rt_config
159
171
  self._sink = sink
160
172
  self._levels = levels
161
173
  self._gui_display = gui_display
162
174
  self._warning = warning
163
- self._add_to_jira = handlers.add_backlog
164
- self._add_releases = handlers.add_releases
165
- self._update_releases = handlers.update_releases
166
- self._update_backlog = handlers.update_backlog
167
- self._rank_in_jira = handlers.rank
168
- self._order_releases = handlers.order_releases
169
- self._rename_releases = handlers.rename_releases
170
175
  self._source = source
171
176
  self._reload = reload
172
177
  self._modified = False
@@ -182,6 +187,11 @@ class BacklogWindow:
182
187
  self._render_warning()
183
188
  self._build_tables()
184
189
 
190
+ def _rt_enabled(self) -> bool:
191
+ """Return whether remaining time estimates are enabled."""
192
+ config = self._rt_config()
193
+ return config is not None and config.enable_remaining_time
194
+
185
195
  def _report_error(self, title: str, message: str) -> None:
186
196
  """Show an error message over this backlog window."""
187
197
  messagebox.showerror(title, message, parent=self._win)
@@ -195,10 +205,13 @@ class BacklogWindow:
195
205
  display = self._gui_display()
196
206
  backlog = backlog_table(self._data, self._levels(),
197
207
  display.level_display,
198
- display.backlog_to_external, self._sink)
208
+ display.backlog_to_external, self._sink,
209
+ omit_none_column=display.omit_none_column,
210
+ use_remaining_time=self._rt_enabled())
199
211
  table = self._add_table('Backlog', *backlog, narrow=False)
200
212
  self._tables.append(table)
201
- releases = release_table(self._data, display.release_to_external)
213
+ releases = release_table(self._data, display.release_to_external,
214
+ omit_none_column=display.omit_none_column)
202
215
  self._tables.append(
203
216
  self._add_table('Releases', *releases, narrow=True))
204
217
 
@@ -347,6 +360,9 @@ class BacklogWindow:
347
360
  command=self._order_by_release, state=state)
348
361
  menu.add_command(label='Estimate ready date…',
349
362
  command=self._estimate_date, state=state)
363
+ menu.add_command(label='Estimate ready date from remaining time…',
364
+ command=self._estimate_rt_date,
365
+ state=state if self._rt_enabled() else 'disabled')
350
366
  menu.add_command(label='Set planned date from estimated',
351
367
  command=self._set_plan, state=state)
352
368
  menu.add_command(label='Adjust release content…',
@@ -361,37 +377,37 @@ class BacklogWindow:
361
377
  def _add_jira_actions(self, menu: tk.Menu) -> None:
362
378
  """Add the Jira operation items to the menu."""
363
379
  jira_state: Literal['normal', 'disabled']
364
- jira_state = ('normal' if self._add_to_jira is not None
380
+ jira_state = ('normal' if self._jira.add_backlog is not None
365
381
  and self._warning is None else 'disabled')
366
382
  menu.add_command(label='Add backlog to Jira…', command=self._jira_add,
367
383
  state=jira_state)
368
384
  upd_bl_state: Literal['normal', 'disabled']
369
- upd_bl_state = ('normal' if self._update_backlog is not None
385
+ upd_bl_state = ('normal' if self._jira.update_backlog is not None
370
386
  and self._warning is None else 'disabled')
371
387
  menu.add_command(label='Update backlog in Jira…',
372
388
  command=self._backlog_update, state=upd_bl_state)
373
389
  rel_state: Literal['normal', 'disabled']
374
- rel_state = ('normal' if self._add_releases is not None
390
+ rel_state = ('normal' if self._jira.add_releases is not None
375
391
  and self._warning is None else 'disabled')
376
392
  menu.add_command(label='Add releases to Jira…',
377
393
  command=self._releases_add, state=rel_state)
378
394
  upd_state: Literal['normal', 'disabled']
379
- upd_state = ('normal' if self._update_releases is not None
395
+ upd_state = ('normal' if self._jira.update_releases is not None
380
396
  and self._warning is None else 'disabled')
381
397
  menu.add_command(label='Update releases in Jira…',
382
398
  command=self._releases_update, state=upd_state)
383
399
  order_state: Literal['normal', 'disabled']
384
- order_state = ('normal' if self._order_releases is not None
400
+ order_state = ('normal' if self._jira.order_releases is not None
385
401
  and self._warning is None else 'disabled')
386
402
  menu.add_command(label='Order releases in Jira…',
387
403
  command=self._releases_order, state=order_state)
388
404
  rename_state: Literal['normal', 'disabled']
389
- rename_state = ('normal' if self._rename_releases is not None
405
+ rename_state = ('normal' if self._jira.rename_releases is not None
390
406
  and self._warning is None else 'disabled')
391
407
  menu.add_command(label='Rename releases in Jira…',
392
408
  command=self._releases_rename, state=rename_state)
393
409
  rank_state: Literal['normal', 'disabled']
394
- rank_state = ('normal' if self._rank_in_jira is not None
410
+ rank_state = ('normal' if self._jira.rank is not None
395
411
  and self._warning is None else 'disabled')
396
412
  menu.add_command(label='Rank items in Jira…', command=self._rank_jira,
397
413
  state=rank_state)
@@ -439,7 +455,8 @@ class BacklogWindow:
439
455
  """Save the backlog, clearing the mark when the source is rewritten."""
440
456
  saved = save_backlog(self._win, self._data, self._presets(),
441
457
  self._levels(), self._sink, self._report_error,
442
- self._report_info)
458
+ self._report_info,
459
+ use_remaining_time=self._rt_enabled())
443
460
  if saved is not None and self._saved_to_source(saved):
444
461
  self._set_modified(False)
445
462
 
@@ -475,6 +492,12 @@ class BacklogWindow:
475
492
  self._sink, self._changed_refresh, self._report_error,
476
493
  self._report_info)
477
494
 
495
+ def _estimate_rt_date(self) -> None:
496
+ """Estimate the ready dates from remaining time and refresh."""
497
+ estimate_rt_date(self._win, self._data, self._teams(),
498
+ self._rt_config(), self._sink, self._changed_refresh,
499
+ self._report_error, self._report_info)
500
+
478
501
  def _set_plan(self) -> None:
479
502
  """Copy the estimated dates to the planned dates and refresh."""
480
503
  set_plan(self._data, self._sink, self._changed_refresh,
@@ -503,8 +526,8 @@ class BacklogWindow:
503
526
 
504
527
  def _jira_add(self) -> None:
505
528
  """Add the shown backlog to Jira, adjusting the view on success."""
506
- if self._add_to_jira is not None:
507
- self._add_to_jira(self._data, self._on_jira_added)
529
+ if self._jira.add_backlog is not None:
530
+ self._jira.add_backlog(self._data, self._on_jira_added)
508
531
 
509
532
  def _on_jira_added(self, result: AddedToJira) -> None:
510
533
  """Rekey the shown backlog and show the two result lists."""
@@ -528,8 +551,8 @@ class BacklogWindow:
528
551
 
529
552
  def _releases_add(self) -> None:
530
553
  """Add the shown releases to Jira and show the result lists."""
531
- if self._add_releases is not None:
532
- self._add_releases(self._data, self._on_releases_added)
554
+ if self._jira.add_releases is not None:
555
+ self._jira.add_releases(self._data, self._on_releases_added)
533
556
 
534
557
  def _on_releases_added(self, result: AddedReleasesToJira) -> None:
535
558
  """Show the added, present and failed release lists.
@@ -542,8 +565,8 @@ class BacklogWindow:
542
565
 
543
566
  def _releases_update(self) -> None:
544
567
  """Update the shown releases in Jira and show the result lists."""
545
- if self._update_releases is not None:
546
- self._update_releases(self._data, self._on_releases_updated)
568
+ if self._jira.update_releases is not None:
569
+ self._jira.update_releases(self._data, self._on_releases_updated)
547
570
 
548
571
  def _on_releases_updated(self, result: UpdatedReleasesInJira) -> None:
549
572
  """Show the update outcome per release in a pop-up.
@@ -557,8 +580,8 @@ class BacklogWindow:
557
580
 
558
581
  def _backlog_update(self) -> None:
559
582
  """Update the shown backlog in Jira and show the result lists."""
560
- if self._update_backlog is not None:
561
- self._update_backlog(self._data, self._on_backlog_updated)
583
+ if self._jira.update_backlog is not None:
584
+ self._jira.update_backlog(self._data, self._on_backlog_updated)
562
585
 
563
586
  def _on_backlog_updated(self, result: UpdatedBacklogInJira) -> None:
564
587
  """Rekey any added items, refresh the view and show the outcome.
@@ -576,8 +599,8 @@ class BacklogWindow:
576
599
 
577
600
  def _rank_jira(self) -> None:
578
601
  """Move chosen issues in the Jira rank order and show the result."""
579
- if self._rank_in_jira is not None:
580
- self._rank_in_jira(self._on_ranked)
602
+ if self._jira.rank is not None:
603
+ self._jira.rank(self._on_ranked)
581
604
 
582
605
  def _on_ranked(self, result: RankedInJira) -> None:
583
606
  """Show the ranked and skipped keys in a copy-pasteable pop-up.
@@ -590,8 +613,8 @@ class BacklogWindow:
590
613
 
591
614
  def _releases_order(self) -> None:
592
615
  """Order the releases in Jira and show the result lists."""
593
- if self._order_releases is not None:
594
- self._order_releases(self._data, self._on_releases_ordered)
616
+ if self._jira.order_releases is not None:
617
+ self._jira.order_releases(self._data, self._on_releases_ordered)
595
618
 
596
619
  def _on_releases_ordered(self, result: OrderedReleasesInJira) -> None:
597
620
  """Show the ordered and skipped release names in a pop-up.
@@ -604,8 +627,8 @@ class BacklogWindow:
604
627
 
605
628
  def _releases_rename(self) -> None:
606
629
  """Rename the shown releases in Jira and show the result lists."""
607
- if self._rename_releases is not None:
608
- self._rename_releases(self._data, self._on_releases_renamed)
630
+ if self._jira.rename_releases is not None:
631
+ self._jira.rename_releases(self._data, self._on_releases_renamed)
609
632
 
610
633
  def _on_releases_renamed(self, result: RenamedReleasesInJira) -> None:
611
634
  """Show the rename outcome per release in a pop-up.
@@ -14,7 +14,7 @@ class BloGuiVersionReporter(BloVersionReporter):
14
14
  @override
15
15
  def package_names(self) -> list[str]:
16
16
  """Return the package names that this package reports."""
17
- ret = ['backlogops-gui']
17
+ ret = ['backlogops-gui', 'edit-cfg-json-tk', 'wizard-tk-bridge']
18
18
  ret += super().package_names()
19
19
  return ret
20
20
 
@@ -76,8 +76,11 @@ class JiraUpdater(JiraAction):
76
76
  def _preset_fields(self) -> dict[str, list[str]]:
77
77
  """Return each preset name mapped to its updatable backlog fields."""
78
78
  connections = self._connections()
79
- return {name: updatable_backlog_fields(connections, name)
80
- for name in self._config().get_jira_config().presets}
79
+ config = self._config()
80
+ use_rt = config.remaining_time.enable_remaining_time
81
+ return {name: updatable_backlog_fields(connections, name,
82
+ use_remaining_time=use_rt)
83
+ for name in config.get_jira_config().presets}
81
84
 
82
85
  def _update_backlog(
83
86
  self, data: BacklogReleases,
@@ -106,6 +109,7 @@ class JiraUpdater(JiraAction):
106
109
  fields_to_update=options.fields, link_update=link_update,
107
110
  rank_anchor=options.rank_anchor, levels=config.get_levels(),
108
111
  status_map=config.get_status_input_map(),
112
+ use_remaining_time=config.remaining_time.enable_remaining_time,
109
113
  stderr_file=self._app.log)
110
114
 
111
115
  def done(result: UpdatedBacklogInJira) -> None:
@@ -65,6 +65,7 @@ class JiraWriter(JiraAction):
65
65
  self._connections(), name, data.backlog, on_existing_key=mode,
66
66
  rank_anchor=options.rank_anchor, levels=config.get_levels(),
67
67
  status_map=config.get_status_input_map(),
68
+ use_remaining_time=config.remaining_time.enable_remaining_time,
68
69
  stderr_file=self._app.log)
69
70
 
70
71
  def done(result: AddedToJira) -> None:
@@ -10,7 +10,8 @@ rows, kept in first-seen order, and every cell is rendered as text so the
10
10
  table can show any value type; a decimal number loses the trailing zeros
11
11
  it does not need, so story points read as ``1`` and ``0.5``. A per-table
12
12
  column-name map can rename a column or drop it from the display, as the GUI
13
- display configuration decides.
13
+ display configuration decides. A column that is empty on every row may be
14
+ left out, as :func:`backlogops.omittable_columns` decides.
14
15
  """
15
16
 
16
17
  # Copyright (c) 2026, Tom Björkholm
@@ -18,14 +19,15 @@ display configuration decides.
18
19
 
19
20
  import tkinter as tk
20
21
  from collections.abc import Mapping
22
+ from datetime import timedelta
21
23
  from tkinter import font as tkfont
22
24
  from tkinter import ttk
23
25
  from typing import Optional, Sequence, TextIO
24
26
  from tableio import Color, Fmt, Value, ValueFmt
25
27
  from backlogops import (
26
28
  BacklogReleases, DEFAULT_LEVELS, FormatRules, LevelDisplay, Levels,
27
- NoTextIO, apply_column_map, display_level_rows, format_backlog,
28
- format_releases)
29
+ NoTextIO, apply_column_map, display_level_rows, drop_empty_columns,
30
+ format_backlog, format_duration, format_releases, omittable_columns)
29
31
 
30
32
  COLUMN_WIDTH = 120
31
33
  BLANK_CELL = ValueFmt(value=None, fmt=Fmt())
@@ -50,10 +52,14 @@ def _cell_text(value: Value) -> str:
50
52
  need, so half a story point reads as ``0.5`` and a whole one as
51
53
  ``1`` rather than ``1.0``. A whole number is already written
52
54
  without a decimal point, and a boolean is not a decimal number in
53
- Python, so both keep their own text.
55
+ Python, so both keep their own text. A remaining time is shown as
56
+ hours, minutes and seconds, as :func:`backlogops.format_duration`
57
+ writes it, never split into days.
54
58
  """
55
59
  if isinstance(value, float):
56
60
  return f'{value:g}'
61
+ if isinstance(value, timedelta):
62
+ return format_duration(value)
57
63
  return '' if value is None else str(value)
58
64
 
59
65
 
@@ -69,35 +75,52 @@ def _table(rows: Sequence[dict[str, ValueFmt]]
69
75
  return columns, cells
70
76
 
71
77
 
78
+ def _without_empty(rows: Sequence[dict[str, ValueFmt]], omit_none_column: bool,
79
+ use_remaining_time: bool) -> list[dict[str, ValueFmt]]:
80
+ """Return the rows without the columns left out when empty."""
81
+ columns = _columns(rows)
82
+ candidates = omittable_columns(columns, omit_none_column,
83
+ use_remaining_time)
84
+ return drop_empty_columns(list(rows), columns, candidates)[0]
85
+
86
+
72
87
  # pylint: disable-next=too-many-arguments,too-many-positional-arguments
73
88
  def backlog_table(data: BacklogReleases, levels: Optional[Levels] = None,
74
89
  display: LevelDisplay = LevelDisplay.BOTH,
75
90
  names: Optional[Mapping[str, Optional[str]]] = None,
76
- sink: Optional[TextIO] = None
91
+ sink: Optional[TextIO] = None, *,
92
+ omit_none_column: bool = False,
93
+ use_remaining_time: bool = False
77
94
  ) -> tuple[list[str], list[list[ValueFmt]]]:
78
95
  """Return the columns and formatted rows for the backlog table.
79
96
 
80
97
  The level of each item is shown as its number, its name, or both, as
81
98
  ``display`` decides, using ``levels`` to translate a number to a name.
82
- The ``names`` map then renames or drops columns, as documented for
83
- :func:`backlogops.apply_column_map`.
99
+ Columns empty on every row are then left out as
100
+ :func:`backlogops.omittable_columns` decides from ``omit_none_column``
101
+ and ``use_remaining_time``. The ``names`` map finally renames or drops
102
+ columns, as documented for :func:`backlogops.apply_column_map`.
84
103
  """
85
104
  out = sink if sink is not None else NoTextIO()
86
105
  chosen = DEFAULT_LEVELS if levels is None else levels
87
106
  rows = display_level_rows(format_backlog(data.backlog, FormatRules()),
88
107
  chosen, display, out)
108
+ rows = _without_empty(rows, omit_none_column, use_remaining_time)
89
109
  return _table([apply_column_map(row, names or {}) for row in rows])
90
110
 
91
111
 
92
112
  def release_table(data: BacklogReleases,
93
- names: Optional[Mapping[str, Optional[str]]] = None
113
+ names: Optional[Mapping[str, Optional[str]]] = None, *,
114
+ omit_none_column: bool = False
94
115
  ) -> tuple[list[str], list[list[ValueFmt]]]:
95
116
  """Return the columns and formatted rows for the releases table.
96
117
 
97
- The ``names`` map renames or drops columns, as documented for
98
- :func:`backlogops.apply_column_map`.
118
+ Columns empty on every row are left out when ``omit_none_column`` is
119
+ True. The ``names`` map then renames or drops columns, as documented
120
+ for :func:`backlogops.apply_column_map`.
99
121
  """
100
122
  rows = format_releases(data.releases, FormatRules())
123
+ rows = _without_empty(rows, omit_none_column, use_remaining_time=False)
101
124
  return _table([apply_column_map(row, names or {}) for row in rows])
102
125
 
103
126
 
@@ -1,6 +0,0 @@
1
- backlogops>=1.3
2
- argcomplete>=3.7.2
3
- wizard-ui-bridge>=1.4
4
- wizard-tk-bridge>=1.4
5
- edit-cfg-json-tk>=0.3.0
6
- versionreporter>=0.4
File without changes
File without changes