6 releases
0.2.0 | Aug 12, 2023 |
---|---|
0.1.4 | Feb 19, 2023 |
0.1.3 | Jan 10, 2023 |
0.1.1 | Dec 27, 2022 |
#55 in #comments
200KB
591 lines
TODL
A tool that finds comment tags in source code.
Do you like leaving todo comments in your code but want a way to easily find them? Use grep! But if you want different kinds of tags (optimize, fix, bug, etc...), want more information (when comments were last changed) or you are just lazy then todl can help.
Install
You can install todl as a cli tool
cargo install todl
Usage
To search the current directory
todl
Example output (width is determined by your terminal)
FAQs
What are comment tags?
Comment tags are labels at the start of comments to make it easier to find and convey meaning.
// TODO: Make this function do something
fn foo() -> u32 {
0
}
What comment tags are supported?
C style comments and rust todo!()
macros.
Supported tags include (case insensitive):
todo
bug
debug
fix
fixme
note
nb
undone
hack
bodge
kludge
xxx
optimize
optimizeme
optimise
optimiseme
safety
invariant
lint
ignored
What if my comments aren't supported?
There is support for custom tags but if you are using a language that is not currently supported raise an issue for it here issues.
Limitations
- Currently only supports rust and c-like syntax
- Does not exclude strings
- The message extracted after the comment tag only includes the first line
Alternatives
Check out these tools that do similar things
Dependencies
~15–25MB
~421K SLoC