backlogops-cli 0.2__tar.gz → 0.4__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 (45) hide show
  1. {backlogops_cli-0.2 → backlogops_cli-0.4}/PKG-INFO +85 -18
  2. {backlogops_cli-0.2 → backlogops_cli-0.4}/README_pypi.md +76 -10
  3. {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/PKG-INFO +85 -18
  4. {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/SOURCES.txt +10 -0
  5. backlogops_cli-0.4/backlogops_cli.egg-info/requires.txt +3 -0
  6. {backlogops_cli-0.2 → backlogops_cli-0.4}/pyproject.toml +7 -7
  7. {backlogops_cli-0.2 → backlogops_cli-0.4}/setup.py +4 -4
  8. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/_command_io.py +43 -9
  9. backlogops_cli-0.4/src/backlogops_cli/_wizard_io.py +126 -0
  10. backlogops_cli-0.4/src/backlogops_cli/add_releases_to_jira.py +144 -0
  11. backlogops_cli-0.4/src/backlogops_cli/add_to_jira.py +151 -0
  12. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/config_wizard.py +16 -5
  13. backlogops_cli-0.4/src/backlogops_cli/encrypt_token_file.py +120 -0
  14. backlogops_cli-0.4/src/backlogops_cli/jira_fields.py +91 -0
  15. backlogops_cli-0.4/src/backlogops_cli/order_releases_in_jira.py +128 -0
  16. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/preset_wizard.py +20 -5
  17. backlogops_cli-0.4/src/backlogops_cli/rank_in_jira.py +120 -0
  18. backlogops_cli-0.4/src/backlogops_cli/read_jira.py +92 -0
  19. backlogops_cli-0.4/src/backlogops_cli/rename_releases_in_jira.py +120 -0
  20. backlogops_cli-0.4/src/backlogops_cli/update_backlog_in_jira.py +177 -0
  21. backlogops_cli-0.4/src/backlogops_cli/update_releases_in_jira.py +135 -0
  22. backlogops_cli-0.2/backlogops_cli.egg-info/requires.txt +0 -3
  23. backlogops_cli-0.2/src/backlogops_cli/_wizard_io.py +0 -92
  24. {backlogops_cli-0.2 → backlogops_cli-0.4}/LICENSE.txt +0 -0
  25. {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/dependency_links.txt +0 -0
  26. {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/top_level.txt +0 -0
  27. {backlogops_cli-0.2 → backlogops_cli-0.4}/setup.cfg +0 -0
  28. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/__init__.py +0 -0
  29. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/__main__.py +0 -0
  30. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/_migrate_warn.py +0 -0
  31. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/adjust_release_content.py +0 -0
  32. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/bloc_version_reporter.py +0 -0
  33. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/convert.py +0 -0
  34. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/demo_backlog.py +0 -0
  35. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/estimate_ready_date.py +0 -0
  36. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/extract_keys.py +0 -0
  37. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/list.py +0 -0
  38. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/migrate_cfg.py +0 -0
  39. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_by_deps.py +0 -0
  40. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_by_keys.py +0 -0
  41. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_by_release.py +0 -0
  42. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_releases.py +0 -0
  43. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/plan_release_dates.py +0 -0
  44. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/py.typed +0 -0
  45. {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/version.py +0 -0
@@ -1,31 +1,32 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: backlogops-cli
3
- Version: 0.2
3
+ Version: 0.4
4
4
  Summary: Command line interface for backlog operations.
5
5
  Author: Tom Björkholm
6
6
  Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
7
7
  License-Expression: MIT
8
- Project-URL: Homepage, https://bitbucket.org/tom-bjorkholm/backlog-ops
9
- Project-URL: Source code, https://bitbucket.org/tom-bjorkholm/backlog-ops
10
- Project-URL: Documentation, https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/
8
+ Project-URL: Homepage, https://github.com/tom-bjorkholm/backlog-ops
9
+ Project-URL: Source code, https://github.com/tom-bjorkholm/backlog-ops
10
+ Project-URL: Documentation, https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/using_backlogops/README.md
11
11
  Keywords: backlog,release planning,agile,scrum,scheduling,roadmap,project management,product owner,product management
12
12
  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
16
  Classifier: Operating System :: OS Independent
17
- Classifier: Development Status :: 3 - Alpha
17
+ Classifier: Development Status :: 4 - Beta
18
18
  Classifier: Environment :: Console
19
19
  Classifier: Intended Audience :: Developers
20
20
  Classifier: Intended Audience :: End Users/Desktop
21
21
  Classifier: Intended Audience :: Information Technology
22
22
  Classifier: Topic :: Office/Business :: Scheduling
23
+ Classifier: Typing :: Typed
23
24
  Requires-Python: >=3.12
24
25
  Description-Content-Type: text/markdown
25
26
  License-File: LICENSE.txt
26
- Requires-Dist: argcomplete>=3.6.3
27
- Requires-Dist: backlogops>=0.2
28
- Requires-Dist: versionreporter>=0.3
27
+ Requires-Dist: argcomplete>=3.7.0
28
+ Requires-Dist: backlogops>=0.4
29
+ Requires-Dist: versionreporter>=0.4
29
30
  Dynamic: author
30
31
  Dynamic: license-file
31
32
  Dynamic: requires-dist
@@ -47,6 +48,18 @@ There are 3 related packages for backlog operations:
47
48
  interface to use the functions in the library. It is based on TkInter. The
48
49
  ambition is to keep it as a thin wrapper around the library.
49
50
 
51
+ ## Project status
52
+
53
+ backlogops is in beta. The algorithms intended for its initial scope are in
54
+ place, so the main work from here is on the user experience rather than on new
55
+ core functionality. The three packages share a version number and are released
56
+ together.
57
+
58
+ The library is not meant to ever be "finished": using it for real planning keeps
59
+ surfacing new ideas. Some of those will be added to backlogops itself, and
60
+ others will fit better in separate packages built on top of backlogops. Early
61
+ adopters are very welcome, and their feedback shapes what comes next.
62
+
50
63
  ## Available functionality
51
64
 
52
65
  The following functionality is available in all 3 packages:
@@ -102,6 +115,23 @@ The following functionality is available in all 3 packages:
102
115
  - A wizard to create a backlog-ops configuration file with the workforce, named
103
116
  input and output presets, level names, and status name mapping.
104
117
 
118
+ - Read a backlog and releases from Jira into a backlog and release table.
119
+
120
+ - Write a backlog to Jira, creating a new Jira issue for each backlog item.
121
+
122
+ - Update a backlog that is already in Jira, changing only the chosen columns.
123
+
124
+ - Add the releases to Jira as Jira versions.
125
+
126
+ - Update the releases in Jira, setting their dates to the planned release dates.
127
+
128
+ - Order the releases in Jira by date, by a name list, or by the input order.
129
+
130
+ - Rename releases in Jira, changing the Jira version names.
131
+
132
+ - Move backlog items to a chosen anchor in the Jira rank order, following a key
133
+ list.
134
+
105
135
  ## The operating model
106
136
 
107
137
  The operating model that most of the functionality is designed for is that the
@@ -137,8 +167,9 @@ the library:
137
167
  before the parent item starts, and the parent item cannot finish before all
138
168
  its children have finished.
139
169
 
140
- - `release` The release of the backlog item. Optional. Follows the same
141
- character rules as the key. Must not be empty string.
170
+ - `release` The release of the backlog item. Optional. Must not be empty string,
171
+ must not start or end with whitespace, and must not contain tabs, newlines or
172
+ control characters.
142
173
 
143
174
  - `team` The team responsible for the backlog item. Optional. Must not be empty
144
175
  string. Must be a valid team name. If None the item can be done by any team.
@@ -178,21 +209,27 @@ To install backlogops-cli on Microsoft Windows, run the following command:
178
209
  pip install --upgrade backlogops-cli
179
210
  ````
180
211
 
212
+ ## Using backlogops documentation
213
+
214
+ For a better understanding of how to use the library, CLI or GUI, see the user
215
+ documentation:
216
+ [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc//using_backlogops/README.md)
217
+
181
218
  ## API documentation
182
219
 
183
220
  For more detailed code documentation, see the API documentation:
184
221
 
185
- - [Library public API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_api.md)
222
+ - [Library public API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_api.md)
186
223
 
187
- - [Library protected API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_api.md)
224
+ - [Library protected API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_api.md)
188
225
 
189
- - [Library public CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_cli.md)
226
+ - [Public CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_cli.md)
190
227
 
191
- - [Library protected CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_cli.md)
228
+ - [Protected CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_cli.md)
192
229
 
193
- - [Library public GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_gui.md)
230
+ - [Public GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_gui.md)
194
231
 
195
- - [Library protected GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_gui.md)
232
+ - [Protected GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_gui.md)
196
233
 
197
234
  ## Command line backlog operations
198
235
 
@@ -206,6 +243,12 @@ backlogops_cli serves 2 purposes:
206
243
 
207
244
  ````text
208
245
 
246
+ python3 -m backlogops_cli.add_releases_to_jira
247
+ Add releases to Jira, creating a new version per release
248
+
249
+ python3 -m backlogops_cli.add_to_jira
250
+ Add a backlog to Jira, creating a new issue per item
251
+
209
252
  python3 -m backlogops_cli.adjust_release_content
210
253
  Adjust release content to fit the planned release dates
211
254
 
@@ -218,12 +261,18 @@ backlogops_cli serves 2 purposes:
218
261
  python3 -m backlogops_cli.demo_backlog
219
262
  Write a demonstration backlog and releases to a file
220
263
 
264
+ python3 -m backlogops_cli.encrypt_token_file
265
+ Encrypt a Jira API token file with a pass phrase.
266
+
221
267
  python3 -m backlogops_cli.estimate_ready_date
222
268
  Estimate ready dates for the backlog items
223
269
 
224
270
  python3 -m backlogops_cli.extract_keys
225
271
  Extract backlog keys at the given levels to a key list
226
272
 
273
+ python3 -m backlogops_cli.jira_fields
274
+ Print Jira custom fields and an issue's editable fields
275
+
227
276
  python3 -m backlogops_cli.list
228
277
  List all commands available in backlogops_cli
229
278
 
@@ -242,12 +291,30 @@ backlogops_cli serves 2 purposes:
242
291
  python3 -m backlogops_cli.order_releases
243
292
  Order the releases by their planned or estimated date
244
293
 
294
+ python3 -m backlogops_cli.order_releases_in_jira
295
+ Order releases in Jira by date, a name list or the input order
296
+
245
297
  python3 -m backlogops_cli.plan_release_dates
246
298
  Set planned release dates from the estimated release dates
247
299
 
248
300
  python3 -m backlogops_cli.preset_wizard
249
301
  Create an input or output preset config file via a wizard
250
302
 
303
+ python3 -m backlogops_cli.rank_in_jira
304
+ Move key-list items to a chosen anchor in the Jira rank order
305
+
306
+ python3 -m backlogops_cli.read_jira
307
+ Read a backlog and releases from Jira and store to a file
308
+
309
+ python3 -m backlogops_cli.rename_releases_in_jira
310
+ Rename releases in Jira, changing Jira version names
311
+
312
+ python3 -m backlogops_cli.update_backlog_in_jira
313
+ Update a backlog in Jira, changing only the chosen columns
314
+
315
+ python3 -m backlogops_cli.update_releases_in_jira
316
+ Update releases in Jira, setting dates to the planned dates
317
+
251
318
  python3 -m backlogops_cli.version
252
319
  Print version information for the backlogops_cli package
253
320
 
@@ -255,9 +322,9 @@ backlogops_cli serves 2 purposes:
255
322
 
256
323
  ## Test summary
257
324
 
258
- - Test result: 1545 passed in 32s
325
+ - Test result: 2638 passed, 7 deselected in 51s
259
326
  - No flake8 warnings.
260
327
  - No mypy errors found.
261
328
  - No python layout warnings.
262
- - Built version(s): 0.2
329
+ - Built version(s): 0.4
263
330
  - Build and test using Python 3.14.6
@@ -14,6 +14,18 @@ There are 3 related packages for backlog operations:
14
14
  interface to use the functions in the library. It is based on TkInter. The
15
15
  ambition is to keep it as a thin wrapper around the library.
16
16
 
17
+ ## Project status
18
+
19
+ backlogops is in beta. The algorithms intended for its initial scope are in
20
+ place, so the main work from here is on the user experience rather than on new
21
+ core functionality. The three packages share a version number and are released
22
+ together.
23
+
24
+ The library is not meant to ever be "finished": using it for real planning keeps
25
+ surfacing new ideas. Some of those will be added to backlogops itself, and
26
+ others will fit better in separate packages built on top of backlogops. Early
27
+ adopters are very welcome, and their feedback shapes what comes next.
28
+
17
29
  ## Available functionality
18
30
 
19
31
  The following functionality is available in all 3 packages:
@@ -69,6 +81,23 @@ The following functionality is available in all 3 packages:
69
81
  - A wizard to create a backlog-ops configuration file with the workforce, named
70
82
  input and output presets, level names, and status name mapping.
71
83
 
84
+ - Read a backlog and releases from Jira into a backlog and release table.
85
+
86
+ - Write a backlog to Jira, creating a new Jira issue for each backlog item.
87
+
88
+ - Update a backlog that is already in Jira, changing only the chosen columns.
89
+
90
+ - Add the releases to Jira as Jira versions.
91
+
92
+ - Update the releases in Jira, setting their dates to the planned release dates.
93
+
94
+ - Order the releases in Jira by date, by a name list, or by the input order.
95
+
96
+ - Rename releases in Jira, changing the Jira version names.
97
+
98
+ - Move backlog items to a chosen anchor in the Jira rank order, following a key
99
+ list.
100
+
72
101
  ## The operating model
73
102
 
74
103
  The operating model that most of the functionality is designed for is that the
@@ -104,8 +133,9 @@ the library:
104
133
  before the parent item starts, and the parent item cannot finish before all
105
134
  its children have finished.
106
135
 
107
- - `release` The release of the backlog item. Optional. Follows the same
108
- character rules as the key. Must not be empty string.
136
+ - `release` The release of the backlog item. Optional. Must not be empty string,
137
+ must not start or end with whitespace, and must not contain tabs, newlines or
138
+ control characters.
109
139
 
110
140
  - `team` The team responsible for the backlog item. Optional. Must not be empty
111
141
  string. Must be a valid team name. If None the item can be done by any team.
@@ -145,21 +175,27 @@ To install backlogops-cli on Microsoft Windows, run the following command:
145
175
  pip install --upgrade backlogops-cli
146
176
  ````
147
177
 
178
+ ## Using backlogops documentation
179
+
180
+ For a better understanding of how to use the library, CLI or GUI, see the user
181
+ documentation:
182
+ [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc//using_backlogops/README.md)
183
+
148
184
  ## API documentation
149
185
 
150
186
  For more detailed code documentation, see the API documentation:
151
187
 
152
- - [Library public API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_api.md)
188
+ - [Library public API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_api.md)
153
189
 
154
- - [Library protected API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_api.md)
190
+ - [Library protected API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_api.md)
155
191
 
156
- - [Library public CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_cli.md)
192
+ - [Public CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_cli.md)
157
193
 
158
- - [Library protected CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_cli.md)
194
+ - [Protected CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_cli.md)
159
195
 
160
- - [Library public GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_gui.md)
196
+ - [Public GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_gui.md)
161
197
 
162
- - [Library protected GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_gui.md)
198
+ - [Protected GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_gui.md)
163
199
 
164
200
  ## Command line backlog operations
165
201
 
@@ -173,6 +209,12 @@ backlogops_cli serves 2 purposes:
173
209
 
174
210
  ````text
175
211
 
212
+ python3 -m backlogops_cli.add_releases_to_jira
213
+ Add releases to Jira, creating a new version per release
214
+
215
+ python3 -m backlogops_cli.add_to_jira
216
+ Add a backlog to Jira, creating a new issue per item
217
+
176
218
  python3 -m backlogops_cli.adjust_release_content
177
219
  Adjust release content to fit the planned release dates
178
220
 
@@ -185,12 +227,18 @@ backlogops_cli serves 2 purposes:
185
227
  python3 -m backlogops_cli.demo_backlog
186
228
  Write a demonstration backlog and releases to a file
187
229
 
230
+ python3 -m backlogops_cli.encrypt_token_file
231
+ Encrypt a Jira API token file with a pass phrase.
232
+
188
233
  python3 -m backlogops_cli.estimate_ready_date
189
234
  Estimate ready dates for the backlog items
190
235
 
191
236
  python3 -m backlogops_cli.extract_keys
192
237
  Extract backlog keys at the given levels to a key list
193
238
 
239
+ python3 -m backlogops_cli.jira_fields
240
+ Print Jira custom fields and an issue's editable fields
241
+
194
242
  python3 -m backlogops_cli.list
195
243
  List all commands available in backlogops_cli
196
244
 
@@ -209,12 +257,30 @@ backlogops_cli serves 2 purposes:
209
257
  python3 -m backlogops_cli.order_releases
210
258
  Order the releases by their planned or estimated date
211
259
 
260
+ python3 -m backlogops_cli.order_releases_in_jira
261
+ Order releases in Jira by date, a name list or the input order
262
+
212
263
  python3 -m backlogops_cli.plan_release_dates
213
264
  Set planned release dates from the estimated release dates
214
265
 
215
266
  python3 -m backlogops_cli.preset_wizard
216
267
  Create an input or output preset config file via a wizard
217
268
 
269
+ python3 -m backlogops_cli.rank_in_jira
270
+ Move key-list items to a chosen anchor in the Jira rank order
271
+
272
+ python3 -m backlogops_cli.read_jira
273
+ Read a backlog and releases from Jira and store to a file
274
+
275
+ python3 -m backlogops_cli.rename_releases_in_jira
276
+ Rename releases in Jira, changing Jira version names
277
+
278
+ python3 -m backlogops_cli.update_backlog_in_jira
279
+ Update a backlog in Jira, changing only the chosen columns
280
+
281
+ python3 -m backlogops_cli.update_releases_in_jira
282
+ Update releases in Jira, setting dates to the planned dates
283
+
218
284
  python3 -m backlogops_cli.version
219
285
  Print version information for the backlogops_cli package
220
286
 
@@ -222,9 +288,9 @@ backlogops_cli serves 2 purposes:
222
288
 
223
289
  ## Test summary
224
290
 
225
- - Test result: 1545 passed in 32s
291
+ - Test result: 2638 passed, 7 deselected in 51s
226
292
  - No flake8 warnings.
227
293
  - No mypy errors found.
228
294
  - No python layout warnings.
229
- - Built version(s): 0.2
295
+ - Built version(s): 0.4
230
296
  - Build and test using Python 3.14.6
@@ -1,31 +1,32 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: backlogops-cli
3
- Version: 0.2
3
+ Version: 0.4
4
4
  Summary: Command line interface for backlog operations.
5
5
  Author: Tom Björkholm
6
6
  Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
7
7
  License-Expression: MIT
8
- Project-URL: Homepage, https://bitbucket.org/tom-bjorkholm/backlog-ops
9
- Project-URL: Source code, https://bitbucket.org/tom-bjorkholm/backlog-ops
10
- Project-URL: Documentation, https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/
8
+ Project-URL: Homepage, https://github.com/tom-bjorkholm/backlog-ops
9
+ Project-URL: Source code, https://github.com/tom-bjorkholm/backlog-ops
10
+ Project-URL: Documentation, https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/using_backlogops/README.md
11
11
  Keywords: backlog,release planning,agile,scrum,scheduling,roadmap,project management,product owner,product management
12
12
  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
16
  Classifier: Operating System :: OS Independent
17
- Classifier: Development Status :: 3 - Alpha
17
+ Classifier: Development Status :: 4 - Beta
18
18
  Classifier: Environment :: Console
19
19
  Classifier: Intended Audience :: Developers
20
20
  Classifier: Intended Audience :: End Users/Desktop
21
21
  Classifier: Intended Audience :: Information Technology
22
22
  Classifier: Topic :: Office/Business :: Scheduling
23
+ Classifier: Typing :: Typed
23
24
  Requires-Python: >=3.12
24
25
  Description-Content-Type: text/markdown
25
26
  License-File: LICENSE.txt
26
- Requires-Dist: argcomplete>=3.6.3
27
- Requires-Dist: backlogops>=0.2
28
- Requires-Dist: versionreporter>=0.3
27
+ Requires-Dist: argcomplete>=3.7.0
28
+ Requires-Dist: backlogops>=0.4
29
+ Requires-Dist: versionreporter>=0.4
29
30
  Dynamic: author
30
31
  Dynamic: license-file
31
32
  Dynamic: requires-dist
@@ -47,6 +48,18 @@ There are 3 related packages for backlog operations:
47
48
  interface to use the functions in the library. It is based on TkInter. The
48
49
  ambition is to keep it as a thin wrapper around the library.
49
50
 
51
+ ## Project status
52
+
53
+ backlogops is in beta. The algorithms intended for its initial scope are in
54
+ place, so the main work from here is on the user experience rather than on new
55
+ core functionality. The three packages share a version number and are released
56
+ together.
57
+
58
+ The library is not meant to ever be "finished": using it for real planning keeps
59
+ surfacing new ideas. Some of those will be added to backlogops itself, and
60
+ others will fit better in separate packages built on top of backlogops. Early
61
+ adopters are very welcome, and their feedback shapes what comes next.
62
+
50
63
  ## Available functionality
51
64
 
52
65
  The following functionality is available in all 3 packages:
@@ -102,6 +115,23 @@ The following functionality is available in all 3 packages:
102
115
  - A wizard to create a backlog-ops configuration file with the workforce, named
103
116
  input and output presets, level names, and status name mapping.
104
117
 
118
+ - Read a backlog and releases from Jira into a backlog and release table.
119
+
120
+ - Write a backlog to Jira, creating a new Jira issue for each backlog item.
121
+
122
+ - Update a backlog that is already in Jira, changing only the chosen columns.
123
+
124
+ - Add the releases to Jira as Jira versions.
125
+
126
+ - Update the releases in Jira, setting their dates to the planned release dates.
127
+
128
+ - Order the releases in Jira by date, by a name list, or by the input order.
129
+
130
+ - Rename releases in Jira, changing the Jira version names.
131
+
132
+ - Move backlog items to a chosen anchor in the Jira rank order, following a key
133
+ list.
134
+
105
135
  ## The operating model
106
136
 
107
137
  The operating model that most of the functionality is designed for is that the
@@ -137,8 +167,9 @@ the library:
137
167
  before the parent item starts, and the parent item cannot finish before all
138
168
  its children have finished.
139
169
 
140
- - `release` The release of the backlog item. Optional. Follows the same
141
- character rules as the key. Must not be empty string.
170
+ - `release` The release of the backlog item. Optional. Must not be empty string,
171
+ must not start or end with whitespace, and must not contain tabs, newlines or
172
+ control characters.
142
173
 
143
174
  - `team` The team responsible for the backlog item. Optional. Must not be empty
144
175
  string. Must be a valid team name. If None the item can be done by any team.
@@ -178,21 +209,27 @@ To install backlogops-cli on Microsoft Windows, run the following command:
178
209
  pip install --upgrade backlogops-cli
179
210
  ````
180
211
 
212
+ ## Using backlogops documentation
213
+
214
+ For a better understanding of how to use the library, CLI or GUI, see the user
215
+ documentation:
216
+ [Using backlogops](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc//using_backlogops/README.md)
217
+
181
218
  ## API documentation
182
219
 
183
220
  For more detailed code documentation, see the API documentation:
184
221
 
185
- - [Library public API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_api.md)
222
+ - [Library public API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_api.md)
186
223
 
187
- - [Library protected API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_api.md)
224
+ - [Library protected API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_api.md)
188
225
 
189
- - [Library public CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_cli.md)
226
+ - [Public CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_cli.md)
190
227
 
191
- - [Library protected CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_cli.md)
228
+ - [Protected CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_cli.md)
192
229
 
193
- - [Library public GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_gui.md)
230
+ - [Public GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_gui.md)
194
231
 
195
- - [Library protected GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_gui.md)
232
+ - [Protected GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_gui.md)
196
233
 
197
234
  ## Command line backlog operations
198
235
 
@@ -206,6 +243,12 @@ backlogops_cli serves 2 purposes:
206
243
 
207
244
  ````text
208
245
 
246
+ python3 -m backlogops_cli.add_releases_to_jira
247
+ Add releases to Jira, creating a new version per release
248
+
249
+ python3 -m backlogops_cli.add_to_jira
250
+ Add a backlog to Jira, creating a new issue per item
251
+
209
252
  python3 -m backlogops_cli.adjust_release_content
210
253
  Adjust release content to fit the planned release dates
211
254
 
@@ -218,12 +261,18 @@ backlogops_cli serves 2 purposes:
218
261
  python3 -m backlogops_cli.demo_backlog
219
262
  Write a demonstration backlog and releases to a file
220
263
 
264
+ python3 -m backlogops_cli.encrypt_token_file
265
+ Encrypt a Jira API token file with a pass phrase.
266
+
221
267
  python3 -m backlogops_cli.estimate_ready_date
222
268
  Estimate ready dates for the backlog items
223
269
 
224
270
  python3 -m backlogops_cli.extract_keys
225
271
  Extract backlog keys at the given levels to a key list
226
272
 
273
+ python3 -m backlogops_cli.jira_fields
274
+ Print Jira custom fields and an issue's editable fields
275
+
227
276
  python3 -m backlogops_cli.list
228
277
  List all commands available in backlogops_cli
229
278
 
@@ -242,12 +291,30 @@ backlogops_cli serves 2 purposes:
242
291
  python3 -m backlogops_cli.order_releases
243
292
  Order the releases by their planned or estimated date
244
293
 
294
+ python3 -m backlogops_cli.order_releases_in_jira
295
+ Order releases in Jira by date, a name list or the input order
296
+
245
297
  python3 -m backlogops_cli.plan_release_dates
246
298
  Set planned release dates from the estimated release dates
247
299
 
248
300
  python3 -m backlogops_cli.preset_wizard
249
301
  Create an input or output preset config file via a wizard
250
302
 
303
+ python3 -m backlogops_cli.rank_in_jira
304
+ Move key-list items to a chosen anchor in the Jira rank order
305
+
306
+ python3 -m backlogops_cli.read_jira
307
+ Read a backlog and releases from Jira and store to a file
308
+
309
+ python3 -m backlogops_cli.rename_releases_in_jira
310
+ Rename releases in Jira, changing Jira version names
311
+
312
+ python3 -m backlogops_cli.update_backlog_in_jira
313
+ Update a backlog in Jira, changing only the chosen columns
314
+
315
+ python3 -m backlogops_cli.update_releases_in_jira
316
+ Update releases in Jira, setting dates to the planned dates
317
+
251
318
  python3 -m backlogops_cli.version
252
319
  Print version information for the backlogops_cli package
253
320
 
@@ -255,9 +322,9 @@ backlogops_cli serves 2 purposes:
255
322
 
256
323
  ## Test summary
257
324
 
258
- - Test result: 1545 passed in 32s
325
+ - Test result: 2638 passed, 7 deselected in 51s
259
326
  - No flake8 warnings.
260
327
  - No mypy errors found.
261
328
  - No python layout warnings.
262
- - Built version(s): 0.2
329
+ - Built version(s): 0.4
263
330
  - Build and test using Python 3.14.6
@@ -12,20 +12,30 @@ src/backlogops_cli/__main__.py
12
12
  src/backlogops_cli/_command_io.py
13
13
  src/backlogops_cli/_migrate_warn.py
14
14
  src/backlogops_cli/_wizard_io.py
15
+ src/backlogops_cli/add_releases_to_jira.py
16
+ src/backlogops_cli/add_to_jira.py
15
17
  src/backlogops_cli/adjust_release_content.py
16
18
  src/backlogops_cli/bloc_version_reporter.py
17
19
  src/backlogops_cli/config_wizard.py
18
20
  src/backlogops_cli/convert.py
19
21
  src/backlogops_cli/demo_backlog.py
22
+ src/backlogops_cli/encrypt_token_file.py
20
23
  src/backlogops_cli/estimate_ready_date.py
21
24
  src/backlogops_cli/extract_keys.py
25
+ src/backlogops_cli/jira_fields.py
22
26
  src/backlogops_cli/list.py
23
27
  src/backlogops_cli/migrate_cfg.py
24
28
  src/backlogops_cli/order_by_deps.py
25
29
  src/backlogops_cli/order_by_keys.py
26
30
  src/backlogops_cli/order_by_release.py
27
31
  src/backlogops_cli/order_releases.py
32
+ src/backlogops_cli/order_releases_in_jira.py
28
33
  src/backlogops_cli/plan_release_dates.py
29
34
  src/backlogops_cli/preset_wizard.py
30
35
  src/backlogops_cli/py.typed
36
+ src/backlogops_cli/rank_in_jira.py
37
+ src/backlogops_cli/read_jira.py
38
+ src/backlogops_cli/rename_releases_in_jira.py
39
+ src/backlogops_cli/update_backlog_in_jira.py
40
+ src/backlogops_cli/update_releases_in_jira.py
31
41
  src/backlogops_cli/version.py
@@ -0,0 +1,3 @@
1
+ argcomplete>=3.7.0
2
+ backlogops>=0.4
3
+ versionreporter>=0.4
@@ -4,7 +4,6 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "backlogops-cli"
7
- version = "0.2"
8
7
  authors = [
9
8
  { name="Tom Björkholm", email="klausuler_linnet0q@icloud.com" },
10
9
  ]
@@ -22,16 +21,17 @@ classifiers = [
22
21
  "Programming Language :: Python :: 3.13",
23
22
  "Programming Language :: Python :: 3.14",
24
23
  "Operating System :: OS Independent",
25
- "Development Status :: 3 - Alpha",
24
+ "Development Status :: 4 - Beta",
26
25
  "Environment :: Console",
27
26
  "Intended Audience :: Developers",
28
27
  "Intended Audience :: End Users/Desktop",
29
28
  "Intended Audience :: Information Technology",
30
- "Topic :: Office/Business :: Scheduling"
29
+ "Topic :: Office/Business :: Scheduling",
30
+ "Typing :: Typed"
31
31
  ]
32
- dynamic = ["dependencies"]
32
+ dynamic = ["dependencies", "version"]
33
33
 
34
34
  [project.urls]
35
- "Homepage" = "https://bitbucket.org/tom-bjorkholm/backlog-ops"
36
- "Source code" = "https://bitbucket.org/tom-bjorkholm/backlog-ops"
37
- "Documentation" = "https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/"
35
+ "Homepage" = "https://github.com/tom-bjorkholm/backlog-ops"
36
+ "Source code" = "https://github.com/tom-bjorkholm/backlog-ops"
37
+ "Documentation" = "https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/using_backlogops/README.md"
@@ -5,7 +5,7 @@ from setuptools import setup
5
5
 
6
6
  setup(
7
7
  name='backlogops-cli',
8
- version='0.2',
8
+ version='0.4',
9
9
  description='Command line interface for backlog operations.',
10
10
  author='Tom Björkholm',
11
11
  author_email='klausuler_linnet0q@icloud.com',
@@ -14,8 +14,8 @@ setup(
14
14
  package_dir={'backlogops_cli': 'src/backlogops_cli'},
15
15
  package_data={'backlogops_cli': ['src/py.typed']},
16
16
  install_requires=[
17
- 'argcomplete >= 3.6.3',
18
- 'backlogops >= 0.2',
19
- 'versionreporter >= 0.3'
17
+ 'argcomplete >= 3.7.0',
18
+ 'backlogops >= 0.4',
19
+ 'versionreporter >= 0.4'
20
20
  ]
21
21
  )