toodles: Manage the TODO entries in your code

[ library, mit, program, project-management ] [ Propose Tags ]

Toodles scrapes your entire repository for TODO entries and organizes them so you can manage your project directly from the code. View, filter, sort, and edit your TODO's with an easy to use web application. When you make changes via toodles, the edits will be applied directly the TODO entries in your code. When you're done, commit and push your changes to share them with your team!


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.0.3, 0.1.0.4, 0.1.0.5, 0.1.0.6, 0.1.0.7, 0.1.0.8, 0.1.0.9, 0.1.0.10, 0.1.0.11, 0.1.0.12, 0.1.0.13, 0.1.0.14, 0.1.0.15, 0.1.0.16, 0.1.1, 0.1.2, 0.1.3, 0.1.4, 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.1.0, 1.1.1, 1.2.1, 1.2.2, 1.2.3
Dependencies aeson (==1.3.1.1), base (>=4.0 && <5), blaze-html (==0.9.1.1), cmdargs (==0.10.20), directory (==1.3.1.5), filepath (==1.4.2), http-types (==0.12.2), megaparsec (==6.5.0), MissingH (>=1.4.0.1 && <1.5), regex-posix (==0.95.2), servant (==0.14.1), servant-blaze (==0.8), servant-server (==0.14.1), strict (==0.3.2), text (==1.2.3.1), transformers (==0.5.5.0), wai (==3.2.1.2), warp (==3.2.25), yaml (==0.8.32) [details]
License MIT
Copyright 2018 Avi Press
Author Avi Press
Maintainer mail@avi.press
Category Project Management
Home page https://github.com/aviaviavi/toodles#readme
Bug tracker https://github.com/aviaviavi/toodles/issues
Source repo head: git clone https://github.com/aviaviavi/toodles
Uploaded by aviaviavi at 2018-10-27T01:08:05Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables toodles
Downloads 12947 total (70 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2018-10-27 [all 3 reports]

Readme for toodles-0.1.0.13

[back to package description]

Toodles

Build Status Hackage

Toodles scrapes your entire repository for TODO entries and organizes them so you can manage your project directly from the code. View, filter, sort, and edit your TODO's with an easy to use web application. When you make changes via toodles, the edits will be applied directly the TODO entries in your code. When you're done, commit and push your changes to share them with your team!

Toodles Screenshot

TODO details

Specify details about your TODO's so that you can filter and sort them with ease! Specify details within parenthasis and separate with the | delimeter.

# TODO(assignee|p=1|keys=vals|#tags) 

Priority

The key p=<integer> will be interpreted as a priority number

KeyVals

Use arbitrary key value pairs <key>=<value>|<key2>=<value2>|... and design any organization scheme you wish! A good use for this is to enter dates of deadlines for TODO's that you can sort on in Toodles

Tags

A detail starting with #, eg #bug|#techdebt|#database|... will be interpreted as a tag, which can be used to label and group your TODO's.

Assign

Assign your TODO's to someone. Any plain word that will be interpreted as an assignee.

# TODO(bob) - something we need to do later

Per Project Configuration

You can configure toodles by putting a .toodles.yaml file in the root of your project. See this repo's .toodles.yaml for the full configuration spec.

Currently via config you can:

  • Set files to ignore via a list of regular expressions

Scanned Languages

These languages will be scanned for any TODO's:

  • C/C++
  • C#
  • Elixir
  • Erlang
  • Go
  • Haskell
  • Java
  • Javascript
  • Kotlin
  • Lua
  • Objective-C
  • PHP
  • Plaintext files (*.txt)
  • Protobuf
  • Python
  • Ruby
  • Rust
  • Scala
  • Shell / Bash
  • Swift
  • Typescript
  • Yaml

Submit a PR if you'd like a language to be added. There will eventually be support for this to be user configurable

Installing

The easiest way to get toodles is via stack. Just a stack install toodles and you're done! Alternatively, with GHC 8.4.3 you can use cabal. If there is desire for it I can look into precompiled distribution.

Running

Invoking toodles with no arguments will treat the current directory as the project root and will start a server on port 9001. You can set these with the -d and -p flags, respectively.

# $ toodles -d <root directory of your project> -p <port to run server>
# for more info run:
# $ toodles --help
$ toodles -d /path/to/your/project -p 9001
# or simply
$ toodles

Current Limitations

Due to the parser's current simplicity, Toodles won't see TODO's in multiline initiated comment. For instance in javascript

// TODO(#bug) this would be parsed

/*

 TODO(#bug) this will _not_ be picked up by toodles

*/