todo_r
| Crates.io | todo_r |
| lib.rs | todo_r |
| version | 0.7.2 |
| source | src |
| created_at | 2018-12-07 20:38:49.7382 |
| updated_at | 2019-02-11 19:55:40.9391 |
| description | Simple rust command line utility that keeps track of your todo comments in code |
| homepage | https://github.com/lavifb/todo_r |
| repository | https://github.com/lavifb/todo_r |
| max_upload_size | |
| id | 100679 |
| size | 102,089 |
Lavi Blumberg (lavifb)
documentation
README
Todo_r
Find all your notes with one command!
Todo_r is a simple rust command line utility that keeps track of your todo items in code. It is pronounced "todoer" like someone that does todos.
Find all your TODO notes with one command!
A lot is adapted from leasot but runs much faster.
Installation
The latest release can be downloaded from the releases page.
If you use macOS Homebrew or Linuxbrew you can currently install the latest version using
$ brew tap lavifb/todo_r https://github.com/lavifb/todo_r.git
$ brew install todor
Features
- Reads TODO comments that are on their own line.
// TODO: do this
/* TODO: do that */
Note: comments that are not on their own line are not supported.
- User references are tracked and can be found using
--userflag.
// TODO(user1): item
// TODO: tagging @user2 and @user3
// TODO(user1): @user3 both are also found!
Comments 1 and 3 are found with todor -u user1.
- Custom tags can be searched using the
-tflag. - Interactive mode for deleting comments is launched using the
-dflag. - If files are not provided for input, todo_r searches the entire git repository.
.gitignorefiles are respected- More ignores can be added using
.todorignorefiles that use the same syntax - If you are not using git, you can instead use a
.todorfile in the root directory
Config files
Create a .todor file in the root of your workspace with todor init.
.todor files can also used as a config file to set custom tags, comments types, output styles, etc.
Todo_r also supports a global config file at $XDG_CONFIG_HOME/todor/todor.conf (default ~/.config/todor/todor.conf) for Mac/Linux and ~\AppData\Roaming\lavifb\todor\todor.conf on Windows.
A deeper explanation of config files can be found at config.md.
Default Language Support
These common languages are supported by default. More support can be added using config files above.
| Filetype | Extensions | Comment Types |
|---|---|---|
| C/C++ | .c,.h,.cpp |
//,/* */ |
| C# | .cs |
//,/* */ |
| CoffeeScript | .coffee |
# |
| Go | .go |
//,/* */ |
| Haskell | .hs |
-- |
| HTML | .html,.htm |
<!-- --> |
| Java | .java |
//,/* */ |
| JavaScript | .js,.es,.es6 |
//,/* */ |
| Obj-C/C++ | .m,.mm |
//,/* */ |
| Less | .less |
//,/* */ |
| Markdown | .md |
<!-- --> |
| Perl | .pl,.pm |
# |
| PHP | .php |
//,/* */ |
| Python | .py |
#,""" """ |
| Ruby | .rb |
# |
| Rust | .rs |
//,/* */ |
| Sass | .sass,scss |
//,/* */ |
| Scala | .scala |
//,/* */ |
| Shell | .sh,.bash,.zsh |
# |
| SQL | .sql |
--,/* */ |
| Stylus | .styl |
//,/* */ |
| Swift | .swift |
//,/* */ |
| TeX | .tex |
% |
| TypeScript | .ts,.tsx |
//,/* */ |
| YAML | .yaml,.yml |
# |
If there are any more languages/extensions that you feel should supported by default, feel free to submit an issue/pull request.
written by Lavi Blumberg