docs: add readme for basic intro
This commit is contained in:
parent
b9c65670c7
commit
309e1b8247
1 changed files with 53 additions and 0 deletions
53
README.md
Normal file
53
README.md
Normal file
|
@ -0,0 +1,53 @@
|
|||
# task-status
|
||||
|
||||
This utility allows you to generate a list of tasks completed from task warrior
|
||||
over the last week.
|
||||
|
||||
# Installation
|
||||
|
||||
Task-status is published in PyPi, so to install you just need to run `pip
|
||||
install task-status`. This will give you the `task-status` entry point to
|
||||
execute.
|
||||
|
||||
## Prerequirements
|
||||
|
||||
In order for this to work, you need to have taskwarrior installed to track
|
||||
tasks. Addtitionally, taskwarrior needs an additiona "User Defined
|
||||
Attribute"(UDA) to define the boolean for displaying a task in the report
|
||||
|
||||
### Taskwarrior
|
||||
|
||||
All of the data comes from taskwarrior, so In order for this to work, [Taskwarrior](https://taskwarrior.org/download/) must
|
||||
be set up first.
|
||||
|
||||
### User-Defined Attribute
|
||||
|
||||
The following must be added to your taskrc file.
|
||||
|
||||
```
|
||||
uda.status_report.type=string
|
||||
uda.status_report.label=status_report
|
||||
uda.status_report.values=display,hide
|
||||
uda.status_report.default=display
|
||||
```
|
||||
|
||||
You may either do that by copying and pasting that directly in your taskrc file,
|
||||
or by running the following:
|
||||
|
||||
`task config uda.status_report.type string`
|
||||
|
||||
`task config uda.status_report.label status_report`
|
||||
|
||||
`task config uda.status_report.values display,hide`
|
||||
|
||||
`task config uda.status_report.default display`
|
||||
|
||||
This will create the attribute that is used to filter out tasks that are not
|
||||
desired to show on the report
|
||||
|
||||
## Usage
|
||||
|
||||
The general usage is to just run `task-status`. It will automatically create a
|
||||
list of tasks completed from last monday to the time the script is run. You may
|
||||
run `task-status --help` to see the complete list of options and their
|
||||
explanation
|
Loading…
Reference in a new issue