Metadata-Version: 2.1
Name: inspectortodo
Version: 1.0.0
Summary: InspectorTodo is a Python tool to track the status of todos in a software project, assuming that the project uses an issue tracker, e.g. JIRA.
Home-page: https://github.com/wolfgangmuender/InspectorTodo
Author: Wolfgang Münder
Author-email: wolfgang.muender@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Environment :: Console
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE.md

### About

InspectorTodo is a Python tool to track the status of todos in a software project, assuming that the project uses an 
issue tracker, e.g. JIRA. In its simplest form it searches for all occurrences of the string TODO and checks whether it 
is followed by an issue reference that is conform to a given regular expression.

Download or clone this project and go to the resulting directory (Python >= 3.6 is required):

    pip install .

Then you can run InspectorTodo:

    inspectortodo --help

If you installed it in a virtualenv (which is recommended), then you always have to activate the virtualenv first.

### Example

The source code of InspectorTodo contains a small example project which can be parsed with the command (assuming you
are at project root of InspectorTodo)

    inspectortodo ./tests/inspectortodo/project_for_testing "IT-\d+" --version-pattern "Release-\d+" --version 2 --versions 1,2,3

### Traversing the folder tree

InspectorTodo currently features two ways of traversing the folder tree of your project: iterating over all files on 
OS level or iterating over all files under git control. The latter is used when the folder passed to InspectorTodo as 
root dir is a git root.

### Config file

To use advanced features you can use a config file by passing a file path via the --configfile option. If the file does 
not exist a default config is created which you can adapt afterwards.

If issues are tracked in an issue tracker like JIRA, InspectorTodo can validate whether issues that are referenced in a 
todo are in an allowed status.

#### JIRA server

Connection settings for a JIRA server.

### Issue filter

A filter (currently tailored to Jira) that will only mark todos as invalid, if a field with name `filter_key` is present
and has at least one of `filter_values` values as its entry. Can be used, _e.g._ to show only todos pointing to issues
belonging to certain teams (_e.g._ on branches).

#### Statuses

A list of allowed statuses in the issue tracker, like "Backlog" or "Todo".

#### Files

If there are files in the project that should not be parsed (e.g. because they belong to another project), you can 
configure a list of ignored paths here, relative to the project root. Compare the entries from the example config for
details.

### Copyright & License

InspectorTodo was conceived, written and executed by [Martin Fink](https://github.com/martin1fink),
[Kai Helbig](https://github.com/ostrya) and [Wolfgang M&uuml;nder](https://github.com/wolfgangmuender).

Licensed under the Apache License, Version 2.0 - see [LICENSE.md](LICENSE.md) in project root directory.
