README

• README
  • Summary
  • Install
  • Features
  • Usage
  • Mulit-line
  • Filter keyword
  • Excluding some folder
  • Expand json file
  • Local arguments
  • Clean the crumbs

Other Versions (have some features different):

• codeitlater_ml ocaml version
• code-it-later clojure version
• codeitlater_hs haskell version

Summary

Make flags in source code where may have problems or can be optimized. codeitlater help you track this flags and fix them in future.

Install

cargo install code-it-later-rs

Features

• get comments in source code
• get comments depending on different key words
• get comments in special path of dir or files
• can expand to other languages

Languages support now:

• rs
• go
• lisp
• py
• hs
• el
• clj
• js

If you wanna expand other languages, check expand json file

Usage

Write code as usual. The comment line that you want to leave mark in, left := symbol after comment symbol.

Then run codeitlater command in terminal get those crumbs back.

For example:

Golang:

```golang // /user/src/main.go // test codeitlater //:= this line can be read by codeitlater //:= MARK: you can left keyword to marked comment line /*:= mutil lines comments */

```

then run codeitlater in code root path

You will get:

|-- /user/src/main.go |-- Line 3: this line can be read by codeitlater |-- Line 4: MARK: you can left keyword to marked comment line |-- Line 5: mutil lines comments

Python:

```python

/src/main.py

this line wont be read

:= this line for codeitlater

print("aaa") ###:= this line can be read again ```

Run codeitlater /path/to/this_py.py.

You will get:

|-- /src/main.py |-- Line 3: this line for codeitlater" |-- Line 4: this line can be read again"

Give specify file type

codeitlater -f clj

You will get result only from clojure.

codeitlater -f clj -f py

Then results both of clojure and python will return.

When you are using options, put -- before the targets. Like:

codeitlater -f clj -f py -- /path/to/file /path/to/dir

~~#### Specific path ####~~

~~Run codeitlater -d /user/src/ let codeitlater just scan specific path.~~

-d/--dir option are desecrated. Use codeitlater /user/src/ /other/path/ /other/file instead.

Mulit-line

When one line ending with ..., then, the next line will add to this crumb. Also, you can make tail chain for this.

For example:

```rust //:= line1... //:= , and line2... //:= line3 with line2...

//:= line4 is diffrent... //:= with line5 //:= line6 ```

Will give you:

|-- Line 1: line1 , and line2 line3 with line2... |-- Line 4: line4 is diffrent with line5 |-- Line 6: line6

Filter keyword

Keyword format is Keyword: with a space after.

Filter keyword (use -k be keyword flag, check out more flags by -h):

codeitlater -k MARK

You will get:

|-- /user/src/main.go |-- Line 4: MARK: you can left keyword to marked comment line

Same format as filetypes, if you want get two keywords together:

codeitlater -k TODO --keywords MARK

CAUTION: if keywords and multi-lines are mixed, multi-lines feature has higher priority.

Example:

//:= TODO: aaaa... //:= bbb... //:= MARK: ccc

Both codeitlater and codeitlater -k TODO are showing

|-- Line 1: TODO: aaaa bbb MARK: ccc

codeitlater -k MARK will show nothing.

Excluding some folder

codeitlater -x vendor will ignore all files in vendor (recursively).

Expand json file

Check tests/test.json, if you run codeitlater -j ./tests/test.json, the "rs" in codeitlater's dictionary will be covered by new value in test.json. Other languages are keep same.

Local arguments

codeitlater will look for {$PWD}/.codeitlater file to pre-load arguments. If any arguments those been given in command line, also set inside the .codeitlater file, will be rewrote by command line arguments.

Clean the crumbs

codeitlater -D target gonna clean all crumbs inside the files in the target folder