Marty/topen
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

doc: Update README

Browse source
This commit is contained in:
Marty Oehme 2025-04-08 20:54:38 +02:00
parent ee4f3781f8
commit e3db83df46
Signed by: Marty
GPG key ID: 4E535BC19C61886E
1 changed files with 24 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

41
README.md
View file

@ -1,4 +1,7 @@
# Topen - simple taskwarrior note editing # Simple taskwarrior note management
[Docs](https://marty-oehme.github.io/topen)
[Pypi](https://pypi.org/project/topen)
A script without bells and whistles. A script without bells and whistles.
Focuses on letting you quickly: Focuses on letting you quickly:
@ -8,7 +11,7 @@ Focuses on letting you quickly:
It does both by simply being invoked with `topen <task-id>`. It does both by simply being invoked with `topen <task-id>`.
Provide a taskwarrior task id or uuid and topen creates a new note file or lets Provide a taskwarrior task id or uuid and `topen` creates a new note file or lets
you edit an existing one. Additionally it adds a small annotation to the task you edit an existing one. Additionally it adds a small annotation to the task
to let you see that there exists a note file next time you view the task. to let you see that there exists a note file next time you view the task.
@ -32,37 +35,46 @@ That's all there is to it.
You can install the script with your favorite python environment manager: You can install the script with your favorite python environment manager:
```bash ```bash
uv tool install git+https://git.martyoeh.me/Marty/topen.git uv tool install topen
``` ```
```bash ```bash
pipx install git+https://git.martyoeh.me/Marty/topen.git pipx install topen
``` ```
```bash ```bash
pip install git+https://git.martyoeh.me/Marty/topen.git pip install topen
``` ```
Or just manually copy the `topen` file to a directory in your PATH. Or just manually copy the `topen` file to a directory in your PATH.
[tasklib](https://github.com/GothenburgBitFactory/tasklib) is the only dependency aside from the python standard library.
If you just want to try the script out, If you just want to try the script out,
feel free to do so by invoking it e.g. with `uvx git+https://git.martyoeh.me/Marty/topen.git`. feel free to do so by invoking it e.g. with `uvx git+https://git.martyoeh.me/Marty/topen.git`.
Only has [tasklib](https://github.com/GothenburgBitFactory/tasklib) as a dependency. If you want to install the trunk version instead of a versioned release simply substitute for the git path:
```bash
uv tool install git+https://git.martyoeh.me/Marty/topen.git
```
## Configuration ## Configuration
By default the script generally assumes your taskwarrior setup follows the XDG Most taskwarrior setups should not need much further configuration and just work out of the box.
base directory suggestions. However, if you want to diverge from the defaults explained here,
use the below settings to configure everything to your preferences.
That means, taskrc in `$XDG_CONFIG_HOME/task/taskrc`, usually It looks for a taskrc file in the user's home directory (`~/.taskrc`) or the XDG base config directory (usually `~/.config/task/taskrc`).
`~/.config/task/taskrc`. Furthermore, at the moment it assumes the taskwarrior The data directory also follows the taskwarrior defaults (`~/.task`) or is read from the taskrc `data.location` option.
_data_ residing in the `$XDG_DATA_HOME/task` directory. This may diverge from
taskwarrior setups still. The notes directory defaults to be in the `notes` subdirectory of where-ever your taskwarrior data location is,
but can be set to anywhere else independently as well.
This program can be configured in 3 different ways: options set in your regular taskwarrior `taskrc` file, This program can be configured in 3 different ways: options set in your regular taskwarrior `taskrc` file,
environment variables or options given on the command line. environment variables or options given on the command line.
CLI options override environment variables, which in turn override configuration set in the `taskrc` file.
### Taskrc configuration ### Taskrc configuration
All options can be changed directly in your taskrc file. All options can be changed directly in your taskrc file.
@ -80,11 +92,6 @@ notes.editor # set the editor used to open notes
notes.quiet # set topen to hide all verbose information during use notes.quiet # set topen to hide all verbose information during use
``` ```
<!-- TODO: IMPROVE DOC -->
Ultimately the goal would probably be to support reading from a taskwarrior 'taskrc' file,
which can then be optionally overwritten with env variables,
which can then be optionally overwritten with cli options.
### Environment variables ### Environment variables
Each option can be changed through setting the corresponding environment variable. Each option can be changed through setting the corresponding environment variable.