A python CLI that extends taskwarrior for productivity scoreboard & gamification (quantified self)
Project description
TaskQuant
This is a CLI application that helps Taskwarrior users quantify their productivity by tracking the 'score' attribute in their tasks.
score
is a custom User Defined Attributes. You will need to have that configured in your .taskrc
file. A sample configuration for this attribute would be:
uda.score.type=numeric
uda.score.label=Score 🏆
urgency.uda.score.coefficient=2
TaskQuant will then compute the score(s) you have accumulated across the different tasks and return a scoresheet.
TaskQuant has no external dependencies except tasklib
, which is also by the same organization that developed Taskwarrior.
It is written entirely in Python, using standard library. It may have optional dependencies, but those are not required and a fallback option will always be used by default.
For those reasons, TaskQuant is extremely lightweight. As it stands, it's only 6.8kb of code, and should install in under a second.
Installation
TaskQuant is available on pypi.
pip install taskquant
Usage
Install the package and execute:
tq
- It supports an optional
-p
(path
) argument to specify the path to your.task
file. Especially helpful if you changed the default location of your.task
file. - It supports an optional
-v
(verbose
) argument to print out additional information in its output.
tq -p ~/vaults/tasks -v
# outputs:
+------------+-------+------------+
| Date | Score | Cumulative |
+------------+-------+------------+
| 2022-03-09 | 0 | 0 |
| 2022-03-10 | 8 | 8 |
| 2022-03-11 | 1 | 9 |
| 2022-03-12 | 43 | 52 |
| 2022-03-13 | 4 | 56 |
| 2022-03-14 | 4 | 60 |
| 2022-03-15 | 7 | 67 |
| 2022-03-16 | 9 | 76 |
| 2022-03-17 | 4 | 80 |
| 2022-03-18 | 4 | 84 |
| 2022-03-19 | 3 | 87 |
| 2022-03-20 | 2 | 89 |
| 2022-03-21 | 5 | 94 |
+------------+-------+------------+
Total completed tasks: 48
Active dates: 13
task_path: /home/samuel/vaults/tasks
- To see all optional arguments, use the
-h
(help
) argument.
tq -h
Dependencies
Roadmap
- Argparse to optionally specify a path to your tasks file
- Add terminal-based charts and graphs
- New ways to visualize scores based on tags, projects or other attributes
Links to Tutorials
- to be updated
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for taskquant-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 239587378ff24aedee7ea4339367b0fdcb193a4c47735a4da0a39f9d045a1d14 |
|
MD5 | b17e6c6f4ba077d2211f0725504e6216 |
|
BLAKE2b-256 | 4b2ddf820b43dbf489d9e11434d4776379c4b5ec8c22d54371e0ff0878ef85f3 |