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.
- {backlogops_gui-1.3 → backlogops_gui-1.5}/PKG-INFO +34 -15
- {backlogops_gui-1.3 → backlogops_gui-1.5}/README_pypi.md +27 -9
- {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/PKG-INFO +34 -15
- backlogops_gui-1.5/backlogops_gui.egg-info/requires.txt +6 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/pyproject.toml +1 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/setup.py +6 -6
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/application.py +13 -8
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_actions.py +65 -18
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_io.py +6 -2
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_window.py +58 -35
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/blog_version_reporter.py +1 -1
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_update.py +6 -2
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_write.py +1 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/table_view.py +33 -10
- backlogops_gui-1.3/backlogops_gui.egg-info/requires.txt +0 -6
- {backlogops_gui-1.3 → backlogops_gui-1.5}/LICENSE.txt +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/SOURCES.txt +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/dependency_links.txt +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/entry_points.txt +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/backlogops_gui.egg-info/top_level.txt +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/setup.cfg +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/__init__.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/__main__.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/_migrate_warn.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/backlog_dialogs.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/choice_dialogs.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/config_edit.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/file_choosers.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/format_dialogs.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_actions.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_base.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_dialogs.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_order.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_rank.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_read.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/jira_rename.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/key_list_box.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/log_buffer.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/modal_dialog.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/py.typed +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/python_version.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/report_windows.py +0 -0
- {backlogops_gui-1.3 → backlogops_gui-1.5}/src/backlogops_gui/tcltk_version.py +0 -0
- {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
|
+
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.
|
|
25
|
+
Requires-Dist: backlogops>=1.5
|
|
25
26
|
Requires-Dist: argcomplete>=3.7.2
|
|
26
|
-
Requires-Dist: wizard-ui-bridge>=1.
|
|
27
|
-
Requires-Dist: wizard-tk-bridge>=1.
|
|
28
|
-
Requires-Dist: edit-cfg-json-tk>=0.
|
|
29
|
-
Requires-Dist: versionreporter>=0.
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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:
|
|
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.
|
|
407
|
-
- Build and test using Python 3.
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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:
|
|
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.
|
|
373
|
-
- Build and test using Python 3.
|
|
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
|
+
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.
|
|
25
|
+
Requires-Dist: backlogops>=1.5
|
|
25
26
|
Requires-Dist: argcomplete>=3.7.2
|
|
26
|
-
Requires-Dist: wizard-ui-bridge>=1.
|
|
27
|
-
Requires-Dist: wizard-tk-bridge>=1.
|
|
28
|
-
Requires-Dist: edit-cfg-json-tk>=0.
|
|
29
|
-
Requires-Dist: versionreporter>=0.
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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:
|
|
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.
|
|
407
|
-
- Build and test using Python 3.
|
|
425
|
+
- Built version(s): 1.5
|
|
426
|
+
- Build and test using Python 3.15.2
|
|
@@ -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.
|
|
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.
|
|
22
|
+
'backlogops >= 1.5',
|
|
23
23
|
'argcomplete >= 3.7.2',
|
|
24
|
-
'wizard-ui-bridge >= 1.
|
|
25
|
-
'wizard-tk-bridge >= 1.
|
|
26
|
-
'edit-cfg-json-tk >= 0.
|
|
27
|
-
'versionreporter >= 0.
|
|
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.
|
|
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,
|
|
49
|
-
get_demo_backlog, get_backlog_ops_config,
|
|
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
|
|
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 (
|
|
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,
|
|
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]
|
|
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
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
"""Ask for the start date and
|
|
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
|
-
|
|
260
|
-
|
|
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
|
-
|
|
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
|
|
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,
|
|
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,
|
|
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
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
507
|
-
self.
|
|
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.
|
|
532
|
-
self.
|
|
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.
|
|
546
|
-
self.
|
|
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.
|
|
561
|
-
self.
|
|
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.
|
|
580
|
-
self.
|
|
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.
|
|
594
|
-
self.
|
|
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.
|
|
608
|
-
self.
|
|
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
|
-
|
|
80
|
-
|
|
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,
|
|
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
|
-
|
|
83
|
-
:func:`backlogops.
|
|
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
|
-
|
|
98
|
-
|
|
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
|
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|