backlogops-cli 0.1__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.1/LICENSE.txt +22 -0
- backlogops_cli-0.1/PKG-INFO +216 -0
- backlogops_cli-0.1/README_pypi.md +184 -0
- backlogops_cli-0.1/backlogops_cli.egg-info/PKG-INFO +216 -0
- backlogops_cli-0.1/backlogops_cli.egg-info/SOURCES.txt +23 -0
- backlogops_cli-0.1/backlogops_cli.egg-info/dependency_links.txt +1 -0
- backlogops_cli-0.1/backlogops_cli.egg-info/requires.txt +2 -0
- backlogops_cli-0.1/backlogops_cli.egg-info/top_level.txt +1 -0
- backlogops_cli-0.1/pyproject.toml +37 -0
- backlogops_cli-0.1/setup.cfg +4 -0
- backlogops_cli-0.1/setup.py +20 -0
- backlogops_cli-0.1/src/backlogops_cli/__init__.py +6 -0
- backlogops_cli-0.1/src/backlogops_cli/__main__.py +12 -0
- backlogops_cli-0.1/src/backlogops_cli/_command_io.py +220 -0
- backlogops_cli-0.1/src/backlogops_cli/adjust_release_content.py +55 -0
- backlogops_cli-0.1/src/backlogops_cli/convert.py +47 -0
- backlogops_cli-0.1/src/backlogops_cli/demo_backlog.py +44 -0
- backlogops_cli-0.1/src/backlogops_cli/estimate_ready_date.py +99 -0
- backlogops_cli-0.1/src/backlogops_cli/extract_keys.py +79 -0
- backlogops_cli-0.1/src/backlogops_cli/list.py +63 -0
- backlogops_cli-0.1/src/backlogops_cli/order_by_deps.py +70 -0
- backlogops_cli-0.1/src/backlogops_cli/order_by_keys.py +59 -0
- backlogops_cli-0.1/src/backlogops_cli/plan_release_dates.py +55 -0
- backlogops_cli-0.1/src/backlogops_cli/py.typed +0 -0
- backlogops_cli-0.1/src/backlogops_cli/teams_wizard.py +55 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Tom Björkholm
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
22
|
+
|
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: backlogops-cli
|
|
3
|
+
Version: 0.1
|
|
4
|
+
Summary: Command line interface for backlog operations.
|
|
5
|
+
Author: Tom Björkholm
|
|
6
|
+
Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
|
|
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/
|
|
11
|
+
Keywords: backlog,release planning,agile,scrum,scheduling,roadmap,project management,product owner,product management
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Development Status :: 3 - Alpha
|
|
18
|
+
Classifier: Environment :: Console
|
|
19
|
+
Classifier: Intended Audience :: Developers
|
|
20
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
21
|
+
Classifier: Intended Audience :: Information Technology
|
|
22
|
+
Classifier: Topic :: Office/Business :: Scheduling
|
|
23
|
+
Requires-Python: >=3.12
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
License-File: LICENSE.txt
|
|
26
|
+
Requires-Dist: argcomplete>=3.6.3
|
|
27
|
+
Requires-Dist: backlogops>=0.1
|
|
28
|
+
Dynamic: author
|
|
29
|
+
Dynamic: license-file
|
|
30
|
+
Dynamic: requires-dist
|
|
31
|
+
Dynamic: requires-python
|
|
32
|
+
|
|
33
|
+
# backlogops-cli
|
|
34
|
+
|
|
35
|
+
There are 3 related packages for backlog operations:
|
|
36
|
+
|
|
37
|
+
- backlogops: a collection of library functions to manipulate backlogs
|
|
38
|
+
|
|
39
|
+
- backlogops-cli: command line interface to use the functions in the library.
|
|
40
|
+
This is just a thin wrapper around the library functions. It serves a dual
|
|
41
|
+
purpose as both an example of how to use the library and as a tool for the
|
|
42
|
+
user to use the library.
|
|
43
|
+
|
|
44
|
+
- backlogops-gui: graphical user interface to use the functions in the library.
|
|
45
|
+
It is based on TkInter. The ambition is to keep it as a thin wrapper around
|
|
46
|
+
the library.
|
|
47
|
+
|
|
48
|
+
## Available functionality
|
|
49
|
+
|
|
50
|
+
The following functionality is available in all 3 packages:
|
|
51
|
+
|
|
52
|
+
- Reading backlog and releases from file types that TableIO supports reading
|
|
53
|
+
from (Currently CSV, Excel, and ODS).
|
|
54
|
+
|
|
55
|
+
- Writing backlog and releases to file types that TableIO supports writing to
|
|
56
|
+
(Currently CSV, Excel, ODS and 9 other file formats).
|
|
57
|
+
|
|
58
|
+
- File format is detected from the file extension, but may be overridden.
|
|
59
|
+
|
|
60
|
+
- Adjust release content to fit the planned release dates.
|
|
61
|
+
|
|
62
|
+
- Create a demonstration backlog and releases (for exploring the features).
|
|
63
|
+
|
|
64
|
+
- Estimate ready date for the backlog items based on available teams, team
|
|
65
|
+
velocity, vacation dates, periods with half time work, etc.
|
|
66
|
+
|
|
67
|
+
- Extract backlog keys at given backlog item levels.
|
|
68
|
+
|
|
69
|
+
- Reorder the backlog so that the dependencies are satisfied.
|
|
70
|
+
|
|
71
|
+
- Reorder the backlog so that items identified by keys in a list come first. If
|
|
72
|
+
the key is at a higher level it will bring all items it is a parent of in
|
|
73
|
+
front of it (recursively).
|
|
74
|
+
|
|
75
|
+
- Set planned release dates from the estimated release dates.
|
|
76
|
+
|
|
77
|
+
- Calculate the release dates from the backlog items estimated ready dates, with
|
|
78
|
+
a configurable buffer time.
|
|
79
|
+
|
|
80
|
+
- Validate the backlog and releases for consistency.
|
|
81
|
+
|
|
82
|
+
- A wizard to create an available teams configuration.
|
|
83
|
+
|
|
84
|
+
## The operating model
|
|
85
|
+
|
|
86
|
+
The operating model that most of the functionality is designed for is that the
|
|
87
|
+
teams work off a single backlog in the order of the backlog. The backlog items
|
|
88
|
+
are ordered by priority and dependencies to allow the teams to work in the
|
|
89
|
+
backlog order. Each backlog item and each release may have a planned ready date,
|
|
90
|
+
that records what has been communicated to the customer. Each backlog item and
|
|
91
|
+
each release may have an estimated ready date, that is calculated from the
|
|
92
|
+
current backlog state, the team velocity, and what we know about the
|
|
93
|
+
availability of the team members.
|
|
94
|
+
|
|
95
|
+
## The backlog item fields
|
|
96
|
+
|
|
97
|
+
Each backlog item has the following fields that are used by the algorithms in
|
|
98
|
+
the library:
|
|
99
|
+
|
|
100
|
+
- key: The key of the backlog item. Required. Must be unique. Must not be empty,
|
|
101
|
+
must not contain whitespace and must not contain any of the characters , . ; :
|
|
102
|
+
( ) \[ \] \{ \}.
|
|
103
|
+
|
|
104
|
+
- level: The level of the backlog item. Required. Must be an integer.
|
|
105
|
+
|
|
106
|
+
- title: The title of the backlog item. Required.
|
|
107
|
+
|
|
108
|
+
- story_points: The story points of the backlog item. Required.
|
|
109
|
+
|
|
110
|
+
- status: The status of the backlog item. Required.
|
|
111
|
+
|
|
112
|
+
- parent_key: The key of the parent backlog item. Optional. Must exist as a key
|
|
113
|
+
in the backlog. Parent keys are used to build the hierarchy of the backlog.
|
|
114
|
+
The parent key must be at a higher level than the current item. Parent keys
|
|
115
|
+
introduce implicit dependencies between items: the current item cannot start
|
|
116
|
+
before the parent item starts, and the parent item cannot finish before all
|
|
117
|
+
its children have finished.
|
|
118
|
+
|
|
119
|
+
- release: The release of the backlog item. Optional. Follows the same character
|
|
120
|
+
rules as the key. Must not be empty string.
|
|
121
|
+
|
|
122
|
+
- team: The team responsible for the backlog item. Optional. Must not be empty
|
|
123
|
+
string. Must be a valid team name. If None the item can be done by any team.
|
|
124
|
+
If not None. the item can only be done by the specified team.
|
|
125
|
+
|
|
126
|
+
- depends_on_f2s: The list of keys of the backlog items that must have been
|
|
127
|
+
finished before the current item can start. May be empty.
|
|
128
|
+
|
|
129
|
+
- depends_on_f2f: The list of keys of the backlog items that must have been
|
|
130
|
+
finished before the current item can finish. May be empty.
|
|
131
|
+
|
|
132
|
+
- depends_on_s2s: The list of keys of the backlog items that must have been
|
|
133
|
+
started before the current item can start. May be empty.
|
|
134
|
+
|
|
135
|
+
- planned_ready_date: The planned ready date of the backlog item. The date that
|
|
136
|
+
is communicated to the customer. Optional.
|
|
137
|
+
|
|
138
|
+
- estimated_ready_date: The estimated ready date of the backlog item. Optional.
|
|
139
|
+
|
|
140
|
+
Additionally each backlog item can have any number of other fields.
|
|
141
|
+
|
|
142
|
+
## Installing backlogops-cli
|
|
143
|
+
|
|
144
|
+
### On macOS and Linux
|
|
145
|
+
|
|
146
|
+
To install backlogops-cli on macOS and Linux, run the following command:
|
|
147
|
+
|
|
148
|
+
````sh
|
|
149
|
+
pip3 install --upgrade backlogops-cli
|
|
150
|
+
````
|
|
151
|
+
|
|
152
|
+
### On Microsoft Windows
|
|
153
|
+
|
|
154
|
+
To install backlogops-cli on Microsoft Windows, run the following command:
|
|
155
|
+
|
|
156
|
+
````sh
|
|
157
|
+
pip install --upgrade backlogops-cli
|
|
158
|
+
````
|
|
159
|
+
|
|
160
|
+
## API documentation
|
|
161
|
+
|
|
162
|
+
For more detailed code documentation, see the API documentation:
|
|
163
|
+
|
|
164
|
+
- [Library public API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_api.md)
|
|
165
|
+
|
|
166
|
+
- [Library protected API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_api.md)
|
|
167
|
+
|
|
168
|
+
- [Library public CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_cli.md)
|
|
169
|
+
|
|
170
|
+
- [Library protected CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_cli.md)
|
|
171
|
+
|
|
172
|
+
- [Library public GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_gui.md)
|
|
173
|
+
|
|
174
|
+
- [Library protected GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_gui.md)
|
|
175
|
+
|
|
176
|
+
## Command line backlog operations
|
|
177
|
+
|
|
178
|
+
backlogops_cli serves 2 purposes:
|
|
179
|
+
|
|
180
|
+
- as a command line utility collection for manipulating backlogs
|
|
181
|
+
|
|
182
|
+
- as an example of how to write your own programs that use the backlogops library
|
|
183
|
+
|
|
184
|
+
### Currently available commands
|
|
185
|
+
|
|
186
|
+
````text
|
|
187
|
+
python3 -m backlogops_cli.adjust_release_content
|
|
188
|
+
Adjust release content to fit the planned release dates
|
|
189
|
+
python3 -m backlogops_cli.convert
|
|
190
|
+
Convert a backlog and releases between table file formats
|
|
191
|
+
python3 -m backlogops_cli.demo_backlog
|
|
192
|
+
Write a demonstration backlog and releases to a file
|
|
193
|
+
python3 -m backlogops_cli.estimate_ready_date
|
|
194
|
+
Estimate ready dates for the backlog items
|
|
195
|
+
python3 -m backlogops_cli.extract_keys
|
|
196
|
+
Extract backlog keys at the given levels to a key list
|
|
197
|
+
python3 -m backlogops_cli.list
|
|
198
|
+
List all commands available in backlogops_cli
|
|
199
|
+
python3 -m backlogops_cli.order_by_deps
|
|
200
|
+
Reorder a backlog so that dependencies are fulfilled
|
|
201
|
+
python3 -m backlogops_cli.order_by_keys
|
|
202
|
+
Reorder a backlog so that key-list items come first
|
|
203
|
+
python3 -m backlogops_cli.plan_release_dates
|
|
204
|
+
Set planned release dates from the estimated release dates
|
|
205
|
+
python3 -m backlogops_cli.teams_wizard
|
|
206
|
+
Create an AvailableTeams configuration file via a wizard
|
|
207
|
+
````
|
|
208
|
+
|
|
209
|
+
## Test summary
|
|
210
|
+
|
|
211
|
+
- Test result: 1066 passed in 16s
|
|
212
|
+
- No flake8 warnings.
|
|
213
|
+
- No mypy errors found.
|
|
214
|
+
- No python layout warnings.
|
|
215
|
+
- Built version(s): 0.1
|
|
216
|
+
- Build and test using Python 3.14.6
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
# backlogops-cli
|
|
2
|
+
|
|
3
|
+
There are 3 related packages for backlog operations:
|
|
4
|
+
|
|
5
|
+
- backlogops: a collection of library functions to manipulate backlogs
|
|
6
|
+
|
|
7
|
+
- backlogops-cli: command line interface to use the functions in the library.
|
|
8
|
+
This is just a thin wrapper around the library functions. It serves a dual
|
|
9
|
+
purpose as both an example of how to use the library and as a tool for the
|
|
10
|
+
user to use the library.
|
|
11
|
+
|
|
12
|
+
- backlogops-gui: graphical user interface to use the functions in the library.
|
|
13
|
+
It is based on TkInter. The ambition is to keep it as a thin wrapper around
|
|
14
|
+
the library.
|
|
15
|
+
|
|
16
|
+
## Available functionality
|
|
17
|
+
|
|
18
|
+
The following functionality is available in all 3 packages:
|
|
19
|
+
|
|
20
|
+
- Reading backlog and releases from file types that TableIO supports reading
|
|
21
|
+
from (Currently CSV, Excel, and ODS).
|
|
22
|
+
|
|
23
|
+
- Writing backlog and releases to file types that TableIO supports writing to
|
|
24
|
+
(Currently CSV, Excel, ODS and 9 other file formats).
|
|
25
|
+
|
|
26
|
+
- File format is detected from the file extension, but may be overridden.
|
|
27
|
+
|
|
28
|
+
- Adjust release content to fit the planned release dates.
|
|
29
|
+
|
|
30
|
+
- Create a demonstration backlog and releases (for exploring the features).
|
|
31
|
+
|
|
32
|
+
- Estimate ready date for the backlog items based on available teams, team
|
|
33
|
+
velocity, vacation dates, periods with half time work, etc.
|
|
34
|
+
|
|
35
|
+
- Extract backlog keys at given backlog item levels.
|
|
36
|
+
|
|
37
|
+
- Reorder the backlog so that the dependencies are satisfied.
|
|
38
|
+
|
|
39
|
+
- Reorder the backlog so that items identified by keys in a list come first. If
|
|
40
|
+
the key is at a higher level it will bring all items it is a parent of in
|
|
41
|
+
front of it (recursively).
|
|
42
|
+
|
|
43
|
+
- Set planned release dates from the estimated release dates.
|
|
44
|
+
|
|
45
|
+
- Calculate the release dates from the backlog items estimated ready dates, with
|
|
46
|
+
a configurable buffer time.
|
|
47
|
+
|
|
48
|
+
- Validate the backlog and releases for consistency.
|
|
49
|
+
|
|
50
|
+
- A wizard to create an available teams configuration.
|
|
51
|
+
|
|
52
|
+
## The operating model
|
|
53
|
+
|
|
54
|
+
The operating model that most of the functionality is designed for is that the
|
|
55
|
+
teams work off a single backlog in the order of the backlog. The backlog items
|
|
56
|
+
are ordered by priority and dependencies to allow the teams to work in the
|
|
57
|
+
backlog order. Each backlog item and each release may have a planned ready date,
|
|
58
|
+
that records what has been communicated to the customer. Each backlog item and
|
|
59
|
+
each release may have an estimated ready date, that is calculated from the
|
|
60
|
+
current backlog state, the team velocity, and what we know about the
|
|
61
|
+
availability of the team members.
|
|
62
|
+
|
|
63
|
+
## The backlog item fields
|
|
64
|
+
|
|
65
|
+
Each backlog item has the following fields that are used by the algorithms in
|
|
66
|
+
the library:
|
|
67
|
+
|
|
68
|
+
- key: The key of the backlog item. Required. Must be unique. Must not be empty,
|
|
69
|
+
must not contain whitespace and must not contain any of the characters , . ; :
|
|
70
|
+
( ) \[ \] \{ \}.
|
|
71
|
+
|
|
72
|
+
- level: The level of the backlog item. Required. Must be an integer.
|
|
73
|
+
|
|
74
|
+
- title: The title of the backlog item. Required.
|
|
75
|
+
|
|
76
|
+
- story_points: The story points of the backlog item. Required.
|
|
77
|
+
|
|
78
|
+
- status: The status of the backlog item. Required.
|
|
79
|
+
|
|
80
|
+
- parent_key: The key of the parent backlog item. Optional. Must exist as a key
|
|
81
|
+
in the backlog. Parent keys are used to build the hierarchy of the backlog.
|
|
82
|
+
The parent key must be at a higher level than the current item. Parent keys
|
|
83
|
+
introduce implicit dependencies between items: the current item cannot start
|
|
84
|
+
before the parent item starts, and the parent item cannot finish before all
|
|
85
|
+
its children have finished.
|
|
86
|
+
|
|
87
|
+
- release: The release of the backlog item. Optional. Follows the same character
|
|
88
|
+
rules as the key. Must not be empty string.
|
|
89
|
+
|
|
90
|
+
- team: The team responsible for the backlog item. Optional. Must not be empty
|
|
91
|
+
string. Must be a valid team name. If None the item can be done by any team.
|
|
92
|
+
If not None. the item can only be done by the specified team.
|
|
93
|
+
|
|
94
|
+
- depends_on_f2s: The list of keys of the backlog items that must have been
|
|
95
|
+
finished before the current item can start. May be empty.
|
|
96
|
+
|
|
97
|
+
- depends_on_f2f: The list of keys of the backlog items that must have been
|
|
98
|
+
finished before the current item can finish. May be empty.
|
|
99
|
+
|
|
100
|
+
- depends_on_s2s: The list of keys of the backlog items that must have been
|
|
101
|
+
started before the current item can start. May be empty.
|
|
102
|
+
|
|
103
|
+
- planned_ready_date: The planned ready date of the backlog item. The date that
|
|
104
|
+
is communicated to the customer. Optional.
|
|
105
|
+
|
|
106
|
+
- estimated_ready_date: The estimated ready date of the backlog item. Optional.
|
|
107
|
+
|
|
108
|
+
Additionally each backlog item can have any number of other fields.
|
|
109
|
+
|
|
110
|
+
## Installing backlogops-cli
|
|
111
|
+
|
|
112
|
+
### On macOS and Linux
|
|
113
|
+
|
|
114
|
+
To install backlogops-cli on macOS and Linux, run the following command:
|
|
115
|
+
|
|
116
|
+
````sh
|
|
117
|
+
pip3 install --upgrade backlogops-cli
|
|
118
|
+
````
|
|
119
|
+
|
|
120
|
+
### On Microsoft Windows
|
|
121
|
+
|
|
122
|
+
To install backlogops-cli on Microsoft Windows, run the following command:
|
|
123
|
+
|
|
124
|
+
````sh
|
|
125
|
+
pip install --upgrade backlogops-cli
|
|
126
|
+
````
|
|
127
|
+
|
|
128
|
+
## API documentation
|
|
129
|
+
|
|
130
|
+
For more detailed code documentation, see the API documentation:
|
|
131
|
+
|
|
132
|
+
- [Library public API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_api.md)
|
|
133
|
+
|
|
134
|
+
- [Library protected API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_api.md)
|
|
135
|
+
|
|
136
|
+
- [Library public CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_cli.md)
|
|
137
|
+
|
|
138
|
+
- [Library protected CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_cli.md)
|
|
139
|
+
|
|
140
|
+
- [Library public GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_gui.md)
|
|
141
|
+
|
|
142
|
+
- [Library protected GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_gui.md)
|
|
143
|
+
|
|
144
|
+
## Command line backlog operations
|
|
145
|
+
|
|
146
|
+
backlogops_cli serves 2 purposes:
|
|
147
|
+
|
|
148
|
+
- as a command line utility collection for manipulating backlogs
|
|
149
|
+
|
|
150
|
+
- as an example of how to write your own programs that use the backlogops library
|
|
151
|
+
|
|
152
|
+
### Currently available commands
|
|
153
|
+
|
|
154
|
+
````text
|
|
155
|
+
python3 -m backlogops_cli.adjust_release_content
|
|
156
|
+
Adjust release content to fit the planned release dates
|
|
157
|
+
python3 -m backlogops_cli.convert
|
|
158
|
+
Convert a backlog and releases between table file formats
|
|
159
|
+
python3 -m backlogops_cli.demo_backlog
|
|
160
|
+
Write a demonstration backlog and releases to a file
|
|
161
|
+
python3 -m backlogops_cli.estimate_ready_date
|
|
162
|
+
Estimate ready dates for the backlog items
|
|
163
|
+
python3 -m backlogops_cli.extract_keys
|
|
164
|
+
Extract backlog keys at the given levels to a key list
|
|
165
|
+
python3 -m backlogops_cli.list
|
|
166
|
+
List all commands available in backlogops_cli
|
|
167
|
+
python3 -m backlogops_cli.order_by_deps
|
|
168
|
+
Reorder a backlog so that dependencies are fulfilled
|
|
169
|
+
python3 -m backlogops_cli.order_by_keys
|
|
170
|
+
Reorder a backlog so that key-list items come first
|
|
171
|
+
python3 -m backlogops_cli.plan_release_dates
|
|
172
|
+
Set planned release dates from the estimated release dates
|
|
173
|
+
python3 -m backlogops_cli.teams_wizard
|
|
174
|
+
Create an AvailableTeams configuration file via a wizard
|
|
175
|
+
````
|
|
176
|
+
|
|
177
|
+
## Test summary
|
|
178
|
+
|
|
179
|
+
- Test result: 1066 passed in 16s
|
|
180
|
+
- No flake8 warnings.
|
|
181
|
+
- No mypy errors found.
|
|
182
|
+
- No python layout warnings.
|
|
183
|
+
- Built version(s): 0.1
|
|
184
|
+
- Build and test using Python 3.14.6
|
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: backlogops-cli
|
|
3
|
+
Version: 0.1
|
|
4
|
+
Summary: Command line interface for backlog operations.
|
|
5
|
+
Author: Tom Björkholm
|
|
6
|
+
Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
|
|
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/
|
|
11
|
+
Keywords: backlog,release planning,agile,scrum,scheduling,roadmap,project management,product owner,product management
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Development Status :: 3 - Alpha
|
|
18
|
+
Classifier: Environment :: Console
|
|
19
|
+
Classifier: Intended Audience :: Developers
|
|
20
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
21
|
+
Classifier: Intended Audience :: Information Technology
|
|
22
|
+
Classifier: Topic :: Office/Business :: Scheduling
|
|
23
|
+
Requires-Python: >=3.12
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
License-File: LICENSE.txt
|
|
26
|
+
Requires-Dist: argcomplete>=3.6.3
|
|
27
|
+
Requires-Dist: backlogops>=0.1
|
|
28
|
+
Dynamic: author
|
|
29
|
+
Dynamic: license-file
|
|
30
|
+
Dynamic: requires-dist
|
|
31
|
+
Dynamic: requires-python
|
|
32
|
+
|
|
33
|
+
# backlogops-cli
|
|
34
|
+
|
|
35
|
+
There are 3 related packages for backlog operations:
|
|
36
|
+
|
|
37
|
+
- backlogops: a collection of library functions to manipulate backlogs
|
|
38
|
+
|
|
39
|
+
- backlogops-cli: command line interface to use the functions in the library.
|
|
40
|
+
This is just a thin wrapper around the library functions. It serves a dual
|
|
41
|
+
purpose as both an example of how to use the library and as a tool for the
|
|
42
|
+
user to use the library.
|
|
43
|
+
|
|
44
|
+
- backlogops-gui: graphical user interface to use the functions in the library.
|
|
45
|
+
It is based on TkInter. The ambition is to keep it as a thin wrapper around
|
|
46
|
+
the library.
|
|
47
|
+
|
|
48
|
+
## Available functionality
|
|
49
|
+
|
|
50
|
+
The following functionality is available in all 3 packages:
|
|
51
|
+
|
|
52
|
+
- Reading backlog and releases from file types that TableIO supports reading
|
|
53
|
+
from (Currently CSV, Excel, and ODS).
|
|
54
|
+
|
|
55
|
+
- Writing backlog and releases to file types that TableIO supports writing to
|
|
56
|
+
(Currently CSV, Excel, ODS and 9 other file formats).
|
|
57
|
+
|
|
58
|
+
- File format is detected from the file extension, but may be overridden.
|
|
59
|
+
|
|
60
|
+
- Adjust release content to fit the planned release dates.
|
|
61
|
+
|
|
62
|
+
- Create a demonstration backlog and releases (for exploring the features).
|
|
63
|
+
|
|
64
|
+
- Estimate ready date for the backlog items based on available teams, team
|
|
65
|
+
velocity, vacation dates, periods with half time work, etc.
|
|
66
|
+
|
|
67
|
+
- Extract backlog keys at given backlog item levels.
|
|
68
|
+
|
|
69
|
+
- Reorder the backlog so that the dependencies are satisfied.
|
|
70
|
+
|
|
71
|
+
- Reorder the backlog so that items identified by keys in a list come first. If
|
|
72
|
+
the key is at a higher level it will bring all items it is a parent of in
|
|
73
|
+
front of it (recursively).
|
|
74
|
+
|
|
75
|
+
- Set planned release dates from the estimated release dates.
|
|
76
|
+
|
|
77
|
+
- Calculate the release dates from the backlog items estimated ready dates, with
|
|
78
|
+
a configurable buffer time.
|
|
79
|
+
|
|
80
|
+
- Validate the backlog and releases for consistency.
|
|
81
|
+
|
|
82
|
+
- A wizard to create an available teams configuration.
|
|
83
|
+
|
|
84
|
+
## The operating model
|
|
85
|
+
|
|
86
|
+
The operating model that most of the functionality is designed for is that the
|
|
87
|
+
teams work off a single backlog in the order of the backlog. The backlog items
|
|
88
|
+
are ordered by priority and dependencies to allow the teams to work in the
|
|
89
|
+
backlog order. Each backlog item and each release may have a planned ready date,
|
|
90
|
+
that records what has been communicated to the customer. Each backlog item and
|
|
91
|
+
each release may have an estimated ready date, that is calculated from the
|
|
92
|
+
current backlog state, the team velocity, and what we know about the
|
|
93
|
+
availability of the team members.
|
|
94
|
+
|
|
95
|
+
## The backlog item fields
|
|
96
|
+
|
|
97
|
+
Each backlog item has the following fields that are used by the algorithms in
|
|
98
|
+
the library:
|
|
99
|
+
|
|
100
|
+
- key: The key of the backlog item. Required. Must be unique. Must not be empty,
|
|
101
|
+
must not contain whitespace and must not contain any of the characters , . ; :
|
|
102
|
+
( ) \[ \] \{ \}.
|
|
103
|
+
|
|
104
|
+
- level: The level of the backlog item. Required. Must be an integer.
|
|
105
|
+
|
|
106
|
+
- title: The title of the backlog item. Required.
|
|
107
|
+
|
|
108
|
+
- story_points: The story points of the backlog item. Required.
|
|
109
|
+
|
|
110
|
+
- status: The status of the backlog item. Required.
|
|
111
|
+
|
|
112
|
+
- parent_key: The key of the parent backlog item. Optional. Must exist as a key
|
|
113
|
+
in the backlog. Parent keys are used to build the hierarchy of the backlog.
|
|
114
|
+
The parent key must be at a higher level than the current item. Parent keys
|
|
115
|
+
introduce implicit dependencies between items: the current item cannot start
|
|
116
|
+
before the parent item starts, and the parent item cannot finish before all
|
|
117
|
+
its children have finished.
|
|
118
|
+
|
|
119
|
+
- release: The release of the backlog item. Optional. Follows the same character
|
|
120
|
+
rules as the key. Must not be empty string.
|
|
121
|
+
|
|
122
|
+
- team: The team responsible for the backlog item. Optional. Must not be empty
|
|
123
|
+
string. Must be a valid team name. If None the item can be done by any team.
|
|
124
|
+
If not None. the item can only be done by the specified team.
|
|
125
|
+
|
|
126
|
+
- depends_on_f2s: The list of keys of the backlog items that must have been
|
|
127
|
+
finished before the current item can start. May be empty.
|
|
128
|
+
|
|
129
|
+
- depends_on_f2f: The list of keys of the backlog items that must have been
|
|
130
|
+
finished before the current item can finish. May be empty.
|
|
131
|
+
|
|
132
|
+
- depends_on_s2s: The list of keys of the backlog items that must have been
|
|
133
|
+
started before the current item can start. May be empty.
|
|
134
|
+
|
|
135
|
+
- planned_ready_date: The planned ready date of the backlog item. The date that
|
|
136
|
+
is communicated to the customer. Optional.
|
|
137
|
+
|
|
138
|
+
- estimated_ready_date: The estimated ready date of the backlog item. Optional.
|
|
139
|
+
|
|
140
|
+
Additionally each backlog item can have any number of other fields.
|
|
141
|
+
|
|
142
|
+
## Installing backlogops-cli
|
|
143
|
+
|
|
144
|
+
### On macOS and Linux
|
|
145
|
+
|
|
146
|
+
To install backlogops-cli on macOS and Linux, run the following command:
|
|
147
|
+
|
|
148
|
+
````sh
|
|
149
|
+
pip3 install --upgrade backlogops-cli
|
|
150
|
+
````
|
|
151
|
+
|
|
152
|
+
### On Microsoft Windows
|
|
153
|
+
|
|
154
|
+
To install backlogops-cli on Microsoft Windows, run the following command:
|
|
155
|
+
|
|
156
|
+
````sh
|
|
157
|
+
pip install --upgrade backlogops-cli
|
|
158
|
+
````
|
|
159
|
+
|
|
160
|
+
## API documentation
|
|
161
|
+
|
|
162
|
+
For more detailed code documentation, see the API documentation:
|
|
163
|
+
|
|
164
|
+
- [Library public API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_api.md)
|
|
165
|
+
|
|
166
|
+
- [Library protected API](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_api.md)
|
|
167
|
+
|
|
168
|
+
- [Library public CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_cli.md)
|
|
169
|
+
|
|
170
|
+
- [Library protected CLI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_cli.md)
|
|
171
|
+
|
|
172
|
+
- [Library public GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_gui.md)
|
|
173
|
+
|
|
174
|
+
- [Library protected GUI](https://bitbucket.org/tom-bjorkholm/backlog-ops/src/master/doc/backlogops_protected_gui.md)
|
|
175
|
+
|
|
176
|
+
## Command line backlog operations
|
|
177
|
+
|
|
178
|
+
backlogops_cli serves 2 purposes:
|
|
179
|
+
|
|
180
|
+
- as a command line utility collection for manipulating backlogs
|
|
181
|
+
|
|
182
|
+
- as an example of how to write your own programs that use the backlogops library
|
|
183
|
+
|
|
184
|
+
### Currently available commands
|
|
185
|
+
|
|
186
|
+
````text
|
|
187
|
+
python3 -m backlogops_cli.adjust_release_content
|
|
188
|
+
Adjust release content to fit the planned release dates
|
|
189
|
+
python3 -m backlogops_cli.convert
|
|
190
|
+
Convert a backlog and releases between table file formats
|
|
191
|
+
python3 -m backlogops_cli.demo_backlog
|
|
192
|
+
Write a demonstration backlog and releases to a file
|
|
193
|
+
python3 -m backlogops_cli.estimate_ready_date
|
|
194
|
+
Estimate ready dates for the backlog items
|
|
195
|
+
python3 -m backlogops_cli.extract_keys
|
|
196
|
+
Extract backlog keys at the given levels to a key list
|
|
197
|
+
python3 -m backlogops_cli.list
|
|
198
|
+
List all commands available in backlogops_cli
|
|
199
|
+
python3 -m backlogops_cli.order_by_deps
|
|
200
|
+
Reorder a backlog so that dependencies are fulfilled
|
|
201
|
+
python3 -m backlogops_cli.order_by_keys
|
|
202
|
+
Reorder a backlog so that key-list items come first
|
|
203
|
+
python3 -m backlogops_cli.plan_release_dates
|
|
204
|
+
Set planned release dates from the estimated release dates
|
|
205
|
+
python3 -m backlogops_cli.teams_wizard
|
|
206
|
+
Create an AvailableTeams configuration file via a wizard
|
|
207
|
+
````
|
|
208
|
+
|
|
209
|
+
## Test summary
|
|
210
|
+
|
|
211
|
+
- Test result: 1066 passed in 16s
|
|
212
|
+
- No flake8 warnings.
|
|
213
|
+
- No mypy errors found.
|
|
214
|
+
- No python layout warnings.
|
|
215
|
+
- Built version(s): 0.1
|
|
216
|
+
- Build and test using Python 3.14.6
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
LICENSE.txt
|
|
2
|
+
README_pypi.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
setup.py
|
|
5
|
+
backlogops_cli.egg-info/PKG-INFO
|
|
6
|
+
backlogops_cli.egg-info/SOURCES.txt
|
|
7
|
+
backlogops_cli.egg-info/dependency_links.txt
|
|
8
|
+
backlogops_cli.egg-info/requires.txt
|
|
9
|
+
backlogops_cli.egg-info/top_level.txt
|
|
10
|
+
src/backlogops_cli/__init__.py
|
|
11
|
+
src/backlogops_cli/__main__.py
|
|
12
|
+
src/backlogops_cli/_command_io.py
|
|
13
|
+
src/backlogops_cli/adjust_release_content.py
|
|
14
|
+
src/backlogops_cli/convert.py
|
|
15
|
+
src/backlogops_cli/demo_backlog.py
|
|
16
|
+
src/backlogops_cli/estimate_ready_date.py
|
|
17
|
+
src/backlogops_cli/extract_keys.py
|
|
18
|
+
src/backlogops_cli/list.py
|
|
19
|
+
src/backlogops_cli/order_by_deps.py
|
|
20
|
+
src/backlogops_cli/order_by_keys.py
|
|
21
|
+
src/backlogops_cli/plan_release_dates.py
|
|
22
|
+
src/backlogops_cli/py.typed
|
|
23
|
+
src/backlogops_cli/teams_wizard.py
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
backlogops_cli
|