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.
- {backlogops_cli-0.2 → backlogops_cli-0.4}/PKG-INFO +85 -18
- {backlogops_cli-0.2 → backlogops_cli-0.4}/README_pypi.md +76 -10
- {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/PKG-INFO +85 -18
- {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/SOURCES.txt +10 -0
- backlogops_cli-0.4/backlogops_cli.egg-info/requires.txt +3 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/pyproject.toml +7 -7
- {backlogops_cli-0.2 → backlogops_cli-0.4}/setup.py +4 -4
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/_command_io.py +43 -9
- backlogops_cli-0.4/src/backlogops_cli/_wizard_io.py +126 -0
- backlogops_cli-0.4/src/backlogops_cli/add_releases_to_jira.py +144 -0
- backlogops_cli-0.4/src/backlogops_cli/add_to_jira.py +151 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/config_wizard.py +16 -5
- backlogops_cli-0.4/src/backlogops_cli/encrypt_token_file.py +120 -0
- backlogops_cli-0.4/src/backlogops_cli/jira_fields.py +91 -0
- backlogops_cli-0.4/src/backlogops_cli/order_releases_in_jira.py +128 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/preset_wizard.py +20 -5
- backlogops_cli-0.4/src/backlogops_cli/rank_in_jira.py +120 -0
- backlogops_cli-0.4/src/backlogops_cli/read_jira.py +92 -0
- backlogops_cli-0.4/src/backlogops_cli/rename_releases_in_jira.py +120 -0
- backlogops_cli-0.4/src/backlogops_cli/update_backlog_in_jira.py +177 -0
- backlogops_cli-0.4/src/backlogops_cli/update_releases_in_jira.py +135 -0
- backlogops_cli-0.2/backlogops_cli.egg-info/requires.txt +0 -3
- backlogops_cli-0.2/src/backlogops_cli/_wizard_io.py +0 -92
- {backlogops_cli-0.2 → backlogops_cli-0.4}/LICENSE.txt +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/dependency_links.txt +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/backlogops_cli.egg-info/top_level.txt +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/setup.cfg +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/__init__.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/__main__.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/_migrate_warn.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/adjust_release_content.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/bloc_version_reporter.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/convert.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/demo_backlog.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/estimate_ready_date.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/extract_keys.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/list.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/migrate_cfg.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_by_deps.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_by_keys.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_by_release.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/order_releases.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/plan_release_dates.py +0 -0
- {backlogops_cli-0.2 → backlogops_cli-0.4}/src/backlogops_cli/py.typed +0 -0
- {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.
|
|
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://
|
|
9
|
-
Project-URL: Source code, https://
|
|
10
|
-
Project-URL: Documentation, https://
|
|
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 ::
|
|
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.
|
|
27
|
-
Requires-Dist: backlogops>=0.
|
|
28
|
-
Requires-Dist: versionreporter>=0.
|
|
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.
|
|
141
|
-
|
|
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://
|
|
222
|
+
- [Library public API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_api.md)
|
|
186
223
|
|
|
187
|
-
- [Library protected API](https://
|
|
224
|
+
- [Library protected API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_api.md)
|
|
188
225
|
|
|
189
|
-
- [
|
|
226
|
+
- [Public CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_cli.md)
|
|
190
227
|
|
|
191
|
-
- [
|
|
228
|
+
- [Protected CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_cli.md)
|
|
192
229
|
|
|
193
|
-
- [
|
|
230
|
+
- [Public GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_gui.md)
|
|
194
231
|
|
|
195
|
-
- [
|
|
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:
|
|
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.
|
|
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.
|
|
108
|
-
|
|
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://
|
|
188
|
+
- [Library public API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_api.md)
|
|
153
189
|
|
|
154
|
-
- [Library protected API](https://
|
|
190
|
+
- [Library protected API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_api.md)
|
|
155
191
|
|
|
156
|
-
- [
|
|
192
|
+
- [Public CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_cli.md)
|
|
157
193
|
|
|
158
|
-
- [
|
|
194
|
+
- [Protected CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_cli.md)
|
|
159
195
|
|
|
160
|
-
- [
|
|
196
|
+
- [Public GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_gui.md)
|
|
161
197
|
|
|
162
|
-
- [
|
|
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:
|
|
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.
|
|
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.
|
|
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://
|
|
9
|
-
Project-URL: Source code, https://
|
|
10
|
-
Project-URL: Documentation, https://
|
|
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 ::
|
|
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.
|
|
27
|
-
Requires-Dist: backlogops>=0.
|
|
28
|
-
Requires-Dist: versionreporter>=0.
|
|
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.
|
|
141
|
-
|
|
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://
|
|
222
|
+
- [Library public API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_api.md)
|
|
186
223
|
|
|
187
|
-
- [Library protected API](https://
|
|
224
|
+
- [Library protected API](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_api.md)
|
|
188
225
|
|
|
189
|
-
- [
|
|
226
|
+
- [Public CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_cli.md)
|
|
190
227
|
|
|
191
|
-
- [
|
|
228
|
+
- [Protected CLI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_protected_cli.md)
|
|
192
229
|
|
|
193
|
-
- [
|
|
230
|
+
- [Public GUI code documentation](https://github.com/tom-bjorkholm/backlog-ops/blob/master/doc/backlogops_gui.md)
|
|
194
231
|
|
|
195
|
-
- [
|
|
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:
|
|
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.
|
|
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
|
|
@@ -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 ::
|
|
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://
|
|
36
|
-
"Source code" = "https://
|
|
37
|
-
"Documentation" = "https://
|
|
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.
|
|
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.
|
|
18
|
-
'backlogops >= 0.
|
|
19
|
-
'versionreporter >= 0.
|
|
17
|
+
'argcomplete >= 3.7.0',
|
|
18
|
+
'backlogops >= 0.4',
|
|
19
|
+
'versionreporter >= 0.4'
|
|
20
20
|
]
|
|
21
21
|
)
|