todex

Python 3.X

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 ...]

git-like patterns to skip (paths, names, or globs together with default .* / __* ), e.g.

bar.py	any file named bar.py
/bar.py	only top-level
foo/bar.py	path under the scan root
vendor/	directory and its contents
*/.pyc	nested matches
!fizz.md	re-include after a broader exclude

-H, --include-hidden do not apply default excludes for hidden names (.* / __*)

-g, --use-gitignore read patterns to exclude from .gitignore file (if present in the scan root)

-t, --tokens [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} - revist 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

Release files for todex 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for todex 1.1.1
File	Size	Uploaded
todex-1.1.1.tar.gz	6.3 kB	Sep 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for todex 1.1.1
File	Interpreter	ABI	Platform	Reset
todex-1.1.1-py3-none-any.whl 7.8 kB Sep 20, 2026	Python 3	none	any	Details

Total release size: 14.1 kB

Release files / todex-1.1.1.tar.gz

Download URL	todex-1.1.1.tar.gz
Size	6.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`0cf9abe18f58e687a11f8c46c963c20a6a1888abdfdc5f81ab3510c2b4169659`
BLAKE2b-256 checksum How to use checksums	`e9ed01f3c3b991c7ecf294f0dc6b3d951e6599763edf5447c059ed782df8a554`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.7.12`

Release files / todex-1.1.1-py3-none-any.whl

Download URL	todex-1.1.1-py3-none-any.whl
Size	7.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a72b96a6d1a3671c5b51be5dc19f4c0405b70439457df34b8ee7839c916fd3fb`
BLAKE2b-256 checksum How to use checksums	`dbdf76361fa0493469d8c9e1b854020d1c66c0afc4a1ca7158817c340c949e23`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.7.12`