todex
Peak mud digger and TODO extractor
pipx install todex
todex <PATH> [OPTIONS...]
You can also invoke todex using the shorter alias tdx.
| Which | What | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
PATH |
path to file or dir to process | ||||||||||||
-h, --help |
show this help message and exit | ||||||||||||
-x, --exclude PATTERN [PATTERN ...] |
git-like patterns to skip (paths, names, or globs together with default .* / __), e.g.
|
||||||||||||
-H, --include-hidden |
do not apply default excludes for hidden names (.* / __*) | ||||||||||||
-g, --use-gitignore |
use exclude patterns from .gitignore (if present in scan root) when traversing dirs | ||||||||||||
-t, --tokens TOKEN [TOKEN ...] |
list of tokens to search for (together with default TODO, FIXME) e.g. WARN, REVISIT. If the token is followed by {lines-count} e.g. #FIXME{3} the extractor will include multiline snippet with the length specified between the curly braces: #FIXME{3} - revisit after release if self.foo == "bar": return f"fizz{buzz}" |
||||||||||||
-i, --ignore-default |
use only -t tokens (skip default TODO, FIXME) | ||||||||||||
-f, --full-path |
display absolute dir/file path | ||||||||||||
-c, --concise |
display only token messages e.g. '#TODO{5}: after release', ignore longer snippets | ||||||||||||
-r, --recursive |
traverse given dir path recursively | ||||||||||||
-m, --max-depth N |
maximum depth of dir traversal - used with -r/--recursive flag | ||||||||||||
-d, --debug |
enable debug mode | ||||||||||||
-o, --out OUT |
path to output file - if existing dir is passed instead TODO out file will be saved inside the path | ||||||||||||
-s, --stdout |
output result to stdout | ||||||||||||
--tee |
output result to stdout and save to file | ||||||||||||
-v, --version |
show program's version number and exit |
Usage of LLMs
Todex's application code is written by hand. LLMs are used to maintain the test suite and optimize certain parts of the code base.
1 maintainer
Metadata
1 maintainer
Release files for todex 2.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| todex-2.1.0.tar.gz | 7.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| todex-2.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.8 kB
Release files / todex-2.1.0.tar.gz
| Download URL | todex-2.1.0.tar.gz |
|---|---|
| Size | 7.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f7266dc8fd2d25532fdba90350d09959f4970b518f9ad09b51e030923bfd4a32
|
|
BLAKE2b-256 checksum How to use checksums |
fa1da1b7a47c051801aef528a10f32390737bc69f583158737fcb4b776c9530b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.12
|
Release files / todex-2.1.0-py3-none-any.whl
| Download URL | todex-2.1.0-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b6eeb14e47fc901b74b7510f451ee64ab5ac67751b4053f25cd0c83be37913a3
|
|
BLAKE2b-256 checksum How to use checksums |
d6f99c98491c97bd8844fb1bbafa7385b36cca37d962cdd9c29c3f139a629da5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.12
|
