Skip to main content
Todex

todex

Python 3.X PyPI Downloads

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.

bar.pyany file named bar.py
/bar.pyonly top-level
foo/bar.pypath under the scan root
vendor/directory and its contents
**/.pycnested matches
!fizz.mdre-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 [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)

Source distribution for todex 1.1.5
File Size Uploaded
todex-1.1.5.tar.gz 6.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for todex 1.1.5
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

1.2.0

2 release files

This release

1.1.5 This release

2 release files

1.1.4

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page