taskli-cli 1.0.0__py3-none-any.whl

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.
@@ -0,0 +1,38 @@
1
+
2
+ Register-ArgumentCompleter -Native -CommandName tk -ScriptBlock {
3
+ param($commandName, $wordToComplete, $cursorPosition)
4
+ $completion_file = New-TemporaryFile
5
+ $env:ARGCOMPLETE_USE_TEMPFILES = 1
6
+ $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
7
+ $env:COMP_LINE = $wordToComplete
8
+ $env:COMP_POINT = $cursorPosition
9
+ $env:_ARGCOMPLETE = 1
10
+ $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
11
+ $env:_ARGCOMPLETE_IFS = "`n"
12
+ $env:_ARGCOMPLETE_SHELL = "powershell"
13
+ tk 2>&1 | Out-Null
14
+
15
+ Get-Content $completion_file | ForEach-Object {
16
+ [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
17
+ }
18
+ Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
19
+ }
20
+
21
+ Register-ArgumentCompleter -Native -CommandName taskli -ScriptBlock {
22
+ param($commandName, $wordToComplete, $cursorPosition)
23
+ $completion_file = New-TemporaryFile
24
+ $env:ARGCOMPLETE_USE_TEMPFILES = 1
25
+ $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
26
+ $env:COMP_LINE = $wordToComplete
27
+ $env:COMP_POINT = $cursorPosition
28
+ $env:_ARGCOMPLETE = 1
29
+ $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
30
+ $env:_ARGCOMPLETE_IFS = "`n"
31
+ $env:_ARGCOMPLETE_SHELL = "powershell"
32
+ taskli 2>&1 | Out-Null
33
+
34
+ Get-Content $completion_file | ForEach-Object {
35
+ [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
36
+ }
37
+ Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
38
+ }
@@ -0,0 +1,81 @@
1
+ #compdef tk taskli
2
+ # Run something, muting output or redirecting it to the debug stream
3
+ # depending on the value of _ARC_DEBUG.
4
+ # If ARGCOMPLETE_USE_TEMPFILES is set, use tempfiles for IPC.
5
+ __python_argcomplete_run() {
6
+ if [[ -z "${ARGCOMPLETE_USE_TEMPFILES-}" ]]; then
7
+ __python_argcomplete_run_inner "$@"
8
+ return
9
+ fi
10
+ local tmpfile="$(mktemp)"
11
+ _ARGCOMPLETE_STDOUT_FILENAME="$tmpfile" __python_argcomplete_run_inner "$@"
12
+ local code=$?
13
+ cat "$tmpfile"
14
+ rm "$tmpfile"
15
+ return $code
16
+ }
17
+
18
+ __python_argcomplete_run_inner() {
19
+ if [[ -z "${_ARC_DEBUG-}" ]]; then
20
+ "$@" 8>&1 9>&2 1>/dev/null 2>&1 </dev/null
21
+ else
22
+ "$@" 8>&1 9>&2 1>&9 2>&1 </dev/null
23
+ fi
24
+ }
25
+
26
+ _python_argcomplete() {
27
+ local IFS=$'\013'
28
+ local script=""
29
+ if [[ -n "${ZSH_VERSION-}" ]]; then
30
+ local completions
31
+ completions=($(IFS="$IFS" \
32
+ COMP_LINE="$BUFFER" \
33
+ COMP_POINT="$CURSOR" \
34
+ _ARGCOMPLETE=1 \
35
+ _ARGCOMPLETE_SHELL="zsh" \
36
+ _ARGCOMPLETE_SUPPRESS_SPACE=1 \
37
+ __python_argcomplete_run ${script:-${words[1]}}))
38
+ local nosort=()
39
+ local nospace=()
40
+ if is-at-least 5.8; then
41
+ nosort=(-o nosort)
42
+ fi
43
+ if [[ "${completions-}" =~ ([^\\\\]): && "${match[1]}" =~ [=/:] ]]; then
44
+ nospace=(-S '')
45
+ fi
46
+ _describe "${words[1]}" completions "${nosort[@]}" "${nospace[@]}"
47
+ else
48
+ local SUPPRESS_SPACE=0
49
+ if compopt +o nospace 2> /dev/null; then
50
+ SUPPRESS_SPACE=1
51
+ fi
52
+ COMPREPLY=($(IFS="$IFS" \
53
+ COMP_LINE="$COMP_LINE" \
54
+ COMP_POINT="$COMP_POINT" \
55
+ COMP_TYPE="$COMP_TYPE" \
56
+ _ARGCOMPLETE_COMP_WORDBREAKS="$COMP_WORDBREAKS" \
57
+ _ARGCOMPLETE=1 \
58
+ _ARGCOMPLETE_SHELL="bash" \
59
+ _ARGCOMPLETE_SUPPRESS_SPACE=$SUPPRESS_SPACE \
60
+ __python_argcomplete_run ${script:-$1}))
61
+ if [[ $? != 0 ]]; then
62
+ unset COMPREPLY
63
+ elif [[ $SUPPRESS_SPACE == 1 ]] && [[ "${COMPREPLY-}" =~ [=/:]$ ]]; then
64
+ compopt -o nospace
65
+ fi
66
+ fi
67
+ }
68
+ if [[ -z "${ZSH_VERSION-}" ]]; then
69
+ complete -o nospace -o default -o bashdefault -F _python_argcomplete tk taskli
70
+ else
71
+ # When called by the Zsh completion system, this will end with
72
+ # "loadautofunc" when initially autoloaded and "shfunc" later on, otherwise,
73
+ # the script was "eval"-ed so use "compdef" to register it with the
74
+ # completion system
75
+ autoload is-at-least
76
+ if [[ $zsh_eval_context == *func ]]; then
77
+ _python_argcomplete "$@"
78
+ else
79
+ compdef _python_argcomplete tk taskli
80
+ fi
81
+ fi
@@ -0,0 +1,208 @@
1
+ Metadata-Version: 2.5
2
+ Name: taskli-cli
3
+ Version: 1.0.0
4
+ Summary: Simple CLI for tracking todo lists.
5
+ Project-URL: Homepage, https://github.com/calvinmcelvain/taskli
6
+ Project-URL: Repository, https://github.com/calvinmcelvain/taskli
7
+ Project-URL: Issues, https://github.com/calvinmcelvain/taskli/issues
8
+ Project-URL: Changelog, https://github.com/calvinmcelvain/taskli/blob/main/CHANGELOG.md
9
+ Project-URL: Documentation, https://github.com/calvinmcelvain/taskli/blob/main/docs/reference.md
10
+ Author-email: "Calvin W. McElvain" <mcelvain1@hotmail.com>
11
+ License-Expression: MIT
12
+ License-File: LICENSE
13
+ Keywords: cli,productivity,task-list,tasks,terminal,todo
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Environment :: Console
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Operating System :: OS Independent
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Programming Language :: Python :: 3.14
22
+ Classifier: Topic :: Utilities
23
+ Requires-Python: >=3.12
24
+ Requires-Dist: argcomplete<4,>=3.0
25
+ Requires-Dist: pydantic>=2.0
26
+ Requires-Dist: rich>=13.0
27
+ Description-Content-Type: text/markdown
28
+
29
+ <div align="center">
30
+
31
+ # taskli
32
+
33
+ **Nested task lists for your terminal.**
34
+ One command, one JSON file per list, and output that's actually nice to read.
35
+
36
+ [![PyPI](https://img.shields.io/pypi/v/taskli-cli)](https://pypi.org/project/taskli-cli/)
37
+ [![CI](https://github.com/calvinmcelvain/taskli/actions/workflows/ci.yml/badge.svg)](https://github.com/calvinmcelvain/taskli/actions/workflows/ci.yml)
38
+ ![Python](https://img.shields.io/pypi/pyversions/taskli-cli)
39
+ ![Type checked: mypy](https://img.shields.io/badge/type--checked-mypy-blue)
40
+
41
+ [Install](#install) · [Quickstart](#quickstart) · [Tour](#tour) · [Cheat sheet](#cheat-sheet) · [Reference](https://github.com/calvinmcelvain/taskli/blob/main/docs/reference.md)
42
+
43
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/hero.svg" alt="tk work --all: a tree of tasks with subtasks, priorities, tags, and color-coded due dates" width="760">
44
+
45
+ </div>
46
+
47
+ ## Install
48
+
49
+ ```bash
50
+ uv tool install taskli-cli
51
+ ```
52
+
53
+ That puts `tk` (and its alias `taskli`) on your `PATH`. It needs Python 3.12+.
54
+ If `tk` isn't found afterwards, run `uv tool update-shell` once.
55
+
56
+ <details>
57
+ <summary>Using pipx, or installing from source</summary>
58
+
59
+ ```bash
60
+ pipx install taskli-cli
61
+ ```
62
+
63
+ To install the latest from GitHub instead:
64
+
65
+ ```bash
66
+ uv tool install git+https://github.com/calvinmcelvain/taskli.git
67
+ ```
68
+
69
+ To hack on it, see [CONTRIBUTING](https://github.com/calvinmcelvain/taskli/blob/main/CONTRIBUTING.md).
70
+
71
+ </details>
72
+
73
+ ## Quickstart
74
+
75
+ ```bash
76
+ tk -a "Buy oat milk" # goes to your inbox
77
+ tk work -a "Ship v2" -p high --due friday # any list, created on demand
78
+ tk work.meetings -a "Review roadmap" # a sublist of work
79
+ tk work --all # see work and everything under it
80
+ ```
81
+
82
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/quickstart.svg" alt="Adding items to the inbox, a work list, and a work.meetings sublist, then viewing the tree" width="640">
83
+
84
+ > [!TIP]
85
+ > `tk` on its own shows your inbox. Every action is a flag, so a list can be
86
+ > named anything and `tk work` never gets confused with a command.
87
+
88
+ ## The mental model
89
+
90
+ ```text
91
+ work a list
92
+ ├── 1 Ship v2 an item
93
+ │ └── 1.2 Tag the build a subtask (any depth: 1.2.1, ...)
94
+ └── work.meetings a sublist (up to 2 levels deep)
95
+ └── 1 Review roadmap
96
+ ```
97
+
98
+ Lists are named; items are numbered by position. That's the whole idea.
99
+
100
+ ## Tour
101
+
102
+ ### Check things off
103
+
104
+ Mark items done (`-d`), in progress (`-i`), or reset them (`-u`). Pass several
105
+ ids at once.
106
+
107
+ ```bash
108
+ tk work -i 2
109
+ tk work -d 3
110
+ ```
111
+
112
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/states.svg" alt="Marking one item in progress (cyan) and another done (dimmed and struck through)" width="560">
113
+
114
+ ### Plan your day
115
+
116
+ Set a due date with `--due`; overdue items turn red and today's turn yellow.
117
+ `tk --agenda` pulls everything due, from every list, into one timeline.
118
+
119
+ ```bash
120
+ tk work -a "Submit timesheet" --due friday
121
+ tk --agenda
122
+ ```
123
+
124
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/agenda.svg" alt="The agenda: items from several lists sorted by due date, overdue in red and due-today in yellow" width="640">
125
+
126
+ `--due` takes `today`, `tomorrow`, `3 days`, `2 weeks`, a weekday name, or
127
+ `MM-DD-YYYY`. More in [Working with tasks](https://github.com/calvinmcelvain/taskli/blob/main/docs/tasks.md#due-dates).
128
+
129
+ ### Find what matters
130
+
131
+ The default view is also a filter. Combine `--tag`, `-p`, `--today`,
132
+ `--undated`, and `--all`.
133
+
134
+ ```bash
135
+ tk work --all -p high # high priority, in work and every sublist
136
+ tk --today --all # everything due today, across every list
137
+ ```
138
+
139
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/filter.svg" alt="High-priority items in work and its meetings sublist" width="640">
140
+
141
+ ### Break work down
142
+
143
+ Nest subtasks with `--under`. Ids become dotted paths (`1.2`) that every
144
+ command understands.
145
+
146
+ ```bash
147
+ tk work -a "Cut release branch" --under 1
148
+ tk work -D 1 # full detail: description, timestamps, subtasks
149
+ ```
150
+
151
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/details.svg" alt="The detail view of one task, listing its description and subtasks" width="560">
152
+
153
+ ### Organize your lists
154
+
155
+ ```bash
156
+ tk groceries --new --color green # color-code a list
157
+ tk work -mv later 2 3 # move items between lists
158
+ tk work --rename job # renames sublists too
159
+ tk --lists
160
+ ```
161
+
162
+ <img src="https://raw.githubusercontent.com/calvinmcelvain/taskli/main/docs/assets/lists.svg" alt="All lists shown as a color-coded tree" width="360">
163
+
164
+ ## Cheat sheet
165
+
166
+ | I want to... | Type this |
167
+ |---|---|
168
+ | add a task | `tk work -a "Ship v2" -p high --tag release` |
169
+ | see a list | `tk work` |
170
+ | see a list and its sublists | `tk work --all` |
171
+ | finish / start / reopen | `tk work -d 1` · `tk work -i 1` · `tk work -u 1` |
172
+ | change a task | `tk work -e 1 -t "Ship v2.1" --due tomorrow` |
173
+ | add a subtask | `tk work -a "Tag build" --under 1` |
174
+ | see everything due | `tk --agenda` |
175
+ | clear out finished work | `tk work --prune` |
176
+ | delete a task | `tk work -rm 1` |
177
+ | copy or move to another list | `tk work --copy later 1` · `tk work -mv later 1` |
178
+ | change a setting | `tk --config default_priority high` |
179
+
180
+ Every flag and rule lives in the [full reference](https://github.com/calvinmcelvain/taskli/blob/main/docs/reference.md).
181
+
182
+ ## Good to know
183
+
184
+ > [!WARNING]
185
+ > Ids are **positions**, not permanent. `-rm` and `--prune` renumber what's
186
+ > left, so don't reuse an id across commands that delete.
187
+
188
+ > [!WARNING]
189
+ > `-e --tag` **replaces** an item's tags. Use `--add-tag` to append.
190
+
191
+ > [!IMPORTANT]
192
+ > One action per call. If you mix flags from different groups (for example
193
+ > `--new` and `-a`), taskli runs one and warns about the others instead of
194
+ > guessing. `-d`, `-i`, `-u`, and `-rm` can combine freely.
195
+
196
+ ## More
197
+
198
+ - [Working with tasks](https://github.com/calvinmcelvain/taskli/blob/main/docs/tasks.md): priorities, tags, due dates, descriptions, subtasks
199
+ - [Lists and sublists](https://github.com/calvinmcelvain/taskli/blob/main/docs/lists.md): nesting, colors, moving, cascading delete and rename
200
+ - [Configuration](https://github.com/calvinmcelvain/taskli/blob/main/docs/config.md): every setting
201
+ - [Tab completion](https://github.com/calvinmcelvain/taskli/blob/main/docs/completion.md): bash, zsh, PowerShell
202
+ - [Stability](https://github.com/calvinmcelvain/taskli/blob/main/docs/stability.md): what stays compatible across 1.x
203
+ - [Changelog](https://github.com/calvinmcelvain/taskli/blob/main/CHANGELOG.md)
204
+ - [Contributing](https://github.com/calvinmcelvain/taskli/blob/main/CONTRIBUTING.md)
205
+
206
+ Your data lives in `~/.taskli` (override with `TASKLI_PATH`). Run `tk --path` to see it.
207
+
208
+ Released under the [MIT License](https://github.com/calvinmcelvain/taskli/blob/main/LICENSE).
@@ -0,0 +1,27 @@
1
+ taskli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
2
+ taskli/__version__.py,sha256=nv6hOpTJtPqBuBnSxCiXdHnGyIuE-QWP4SSVSyOzPcY,57
3
+ taskli/cli.py,sha256=BC1LeHci_itJEQ6kOK5dy5nG7MNOwAcuBLT2pK-IqbY,33009
4
+ taskli/env.py,sha256=o6rgyCdndXG5Q2zMtZHfeKydAjWhD555XMupuf6igQY,959
5
+ taskli/exceptions.py,sha256=mM8FCX6Ec4qmlfQnwvyXRJGHNXYgyOgBBGRDZhDvX4s,1935
6
+ taskli/hierarchy.py,sha256=O7FyvwvYihXQkKVxfuw_AqBEXMUqBzbwKbwbCfB9Y9E,1956
7
+ taskli/logic.py,sha256=JvF-F7FrYURiwZXGJXSAA5NNUcLUY-GDlXUt2zqWGsg,31511
8
+ taskli/migrations.py,sha256=K3QN0kd6RS3c-D_8xrD3XRCZsggDd5JEjivLARhh1qg,4901
9
+ taskli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
10
+ taskli/render.py,sha256=hI_y_R5Q13DgAe98tr_rBtz3E88f6jkELqIZvPrHfw8,13912
11
+ taskli/storage.py,sha256=hVMXkNzkN2zkIAdKeu7Dj4XSAgvPgdLJ15B0gYydGIY,18397
12
+ taskli/models/__init__.py,sha256=UFOa06BIfrM2Ds3yruQpnVRuqgWQETP4WGFaF6CrYKo,59
13
+ taskli/models/attributes.py,sha256=FhvAGxKF7zxzx8H5HEpyfTpghmR6S-g-ob_OKPVEvnM,3704
14
+ taskli/models/config.py,sha256=rh7ZjSnulO9szUGWsZXXxNQwBKWbHULYoCWwvLPiTV4,2924
15
+ taskli/models/dates.py,sha256=r1YBNiegJSaX0izU_duKGRAl2BnOLauds7CIE4x0qEY,3645
16
+ taskli/models/paths.py,sha256=yYQK4x2KWEroXqWyLLBtalMZHaCzvL4tZ20VVpmJ1Vc,508
17
+ taskli/models/query.py,sha256=iiBbRzVjLAFvAdU_h-0i9b0iYrp-xNET2VIFKlEIBBA,6968
18
+ taskli/models/registry.py,sha256=4BxezEpTJ4VZPG3iVW8zVyG7lIdcqa_oUgwigBlWBLU,5926
19
+ taskli/models/tasks.py,sha256=NzjVTPB3If_-lMX-zycdsm1njP77lS_sndvw0B45clQ,21712
20
+ taskli_cli-1.0.0.data/data/share/taskli/completions/README.md,sha256=oxCOXak3Pn_bAejwzHApIng0xmU0De3tTPn0yks5x8A,1439
21
+ taskli_cli-1.0.0.data/data/share/taskli/completions/taskli.ps1,sha256=HzRUOuyZo5NX-iL5b-0GbfvXbsfMj81oiWZN0ptNeug,1786
22
+ taskli_cli-1.0.0.data/data/share/taskli/completions/taskli.sh,sha256=lAP3lrIhkeqirbMIxXarLPsVcsiN7Hah9nVaPd5DCds,2688
23
+ taskli_cli-1.0.0.dist-info/METADATA,sha256=_sOyoMpop_h57TX77CUPM8rLKJSoDMPSS6-nfxkgO0g,8240
24
+ taskli_cli-1.0.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
25
+ taskli_cli-1.0.0.dist-info/entry_points.txt,sha256=Z39GyfESyq9VPtm46MzcH-nKG-Cnd_6QrDN1aoTSQEg,64
26
+ taskli_cli-1.0.0.dist-info/licenses/LICENSE,sha256=3yY4oiDyvR0wN6_OEE4kljKgab45nVJHiNfUin1CkPA,1075
27
+ taskli_cli-1.0.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.33.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ taskli = taskli.cli:main
3
+ tk = taskli.cli:main
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Calvin W. McElvain
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.