Skip to main content

Find lines of source code you have tagged with custom categories

Project description


Find lines of source code you have tagged with custom categories, defined inside a config.json file.

For example, to tag a piece of code which contains a bug, write a comment as below:

# @BUG(HIGH) buggy_code() throws an unhandled exception!

You can then run tagg in the project root directory and it will output the file name, line number and description to the console as below.

taggregator/taggregator/  :57   # @BUG(HIGH) Throws OSError on some files if in use
taggregator/taggregator/  :64   # @SPEED(MEDIUM) Regex search of processed line
taggregator/taggregator/     :34   # @TODO(LOW) Allow user to specify path for config file

Each line marked with a tag will be ordered and coloured by priority. By default, there are a number of tags and priorities in the config file installed.


$ pip3 install --upgrade taggregator

Installation will also create a config file at ~/.taggregator/config.json but the program will prioritise a config file stored in {current_directory}/.taggregator/config.json if it exists.


From project root

$ tagg

From a specified folder

$ tagg Assets/Scripts

Only return lines marked with "speed" and "refactor"

$ tagg -t "speed, refactor"

Create config file in current directory

$ tagg create

Workflow integration

It might be useful to bind taggregator to a key combination in a tool like vim. For example, place this in your ~/.vimrc:

nnoremap <leader>t :!clear;tagg<CR>

Presuming your vim leader is ',' you can then access your taggregator todo list at any time by typing ',t' while editing.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

taggregator-0.0.36.tar.gz (7.2 kB view hashes)

Uploaded Source

Built Distribution

taggregator-0.0.36-py3-none-any.whl (8.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page