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 use exclude patterns from .gitignore (if present in scan root) when traversing dirs

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

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.3
File	Size	Uploaded
todex-1.1.3.tar.gz	6.3 kB	Sep 21, 2026	Details

Built distribution (wheel)

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

Total release size: 14.1 kB

Release files / todex-1.1.3.tar.gz

Download URL	todex-1.1.3.tar.gz
Size	6.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`448b45d8db733a0dbd281b576d39d5e518fb60241f9f8b12243a07ff0fcd345c`
BLAKE2b-256 checksum How to use checksums	`65e499e34b0d20d22fee48b8fbbfd9eabe66f916003b9e191b3e420f1e9aa746`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.7.12`

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

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