brakoll 0.2.2

📌 Information

Having a good method of tracking what's finished and what needs to be done is crucial once a project grows large enough. Of course, for team-driven development having a full-featured issue tracker such as GitHub or similar is preferable, but for solo-developers GitHub can feel like an over-engineered solution to a simple problem.

(The name "Brakoll" is derived from the swedish word "koll", which is the act of surveying or scanning something.)

The idea for this project was inspired directly by this video.

📦 Install

cargo install brakoll

💻 Usage

Adding a new issue

When you want to add something to your issue list you simply type it out in your project (I would advise you to create a snippet for this; for example "issue").

// *brakoll - d: fix formatting issue in debug statement, p: 10, t: debug, s: open

• d: description of the issue (obligatory)
• p: priority from 0 to infinity where the highest number is the most critical priority (optional - fallback: 0)
• t: tag (optional - fallback: n/a)
• s: status [ (op)en | (pr)ogress | (cl)osed ] (optional - fallback: open)

[!IMPORTANT]
Issues are currently only single-line! If you want a long description, write it all on a single line or alternatively refer to a bigger document somewhere else inside your description. The prefix "*brakoll" is required but whatever is before it on the line is of no importance to the parser and will be ignored, e.g "#", "//", "--" or other comment syntax.

Here's a way to integrate Brakoll into your neovim config using luasnip:

local ls = require("luasnip")
local s = ls.snippet
local t = ls.text_node
local i = ls.insert_node

return {
    s("issue", {
        t("*brakoll - d: "), i(1),
        t(", p: "), i(2),
        t(", t: "), i(3),
        t(", s: open"),
    }),
}

Listing and reviewing issues

Subcommands and flags will be added in future versions, but right now all you have to do is type "brakoll" inside your current directory and all your issues within it and any children directories will be listed.

brakoll

Typical terminal output

3 issues were found.

=== 10: closed ===
file: ~/dev/my_awesome_project/src/api.rs
line: 426, tag: refactor
desc: query parser for-loop

*** 0: todo ***
file: ~/dev/my_awesome_project/src/main.rs
line: 108, tag: debug
desc: fix formatting issue in debug statement

/// 7: in progress ///
file: ~/dev/my_awesome_project/src/utils/tools.rs
line: 18, tag: refactor
desc: abstract structs

3 issues were found.

📜 License

This project is licensed under the MIT License.

🛠 Dependencies

• walkdir
• dirs