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 | ||||||||||||
-s, --short |
display only token messages e.g. '#FIXME{3} - revist 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 | ||||||||||||
-v, --version |
show program's version number and exit |
Metadata
Release files for todex 1.1.5
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-1.1.5.tar.gz | 6.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| todex-1.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.1 kB
Release files / todex-1.1.5.tar.gz
| Download URL | todex-1.1.5.tar.gz |
|---|---|
| Size | 6.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb6b3719b1b4fade36c20ae2dc0c76a8ac073515e2ecf0d3eb5625fb46c66ab9
|
|
BLAKE2b-256 checksum How to use checksums |
42996bbe9dee85ab7afc7fbad5fec56b66d65189b93c78448b898bdb57ffbfc4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.12
|
Release files / todex-1.1.5-py3-none-any.whl
| Download URL | todex-1.1.5-py3-none-any.whl |
|---|---|
| Size | 7.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f9ed6b1ae19afd9037fca0e669a6622590b5a706bc1ae0889d52e7ed27c0ba88
|
|
BLAKE2b-256 checksum How to use checksums |
f26aace2dc4b458b59bd965958c55ca6cd5c7be3dea2a0f5ed21ebdf5134d5d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.12
|