reqstool 0.6.0

A tool for managing requirements with related tests and test results.

Reqstool Client

Overview

Reqstool is a tool for managing requirements with related software verification cases (aka tests) and verification results (test results).

• Requirements are defined in YAML files and can reference each other (depending on the variant different data will be parsed).
• Annotations are then used in code to specify where a requirement is implemented as well as tested.

With this information and the actual test results (e.g., JUnit), use Reqstool to:

• Generate a report (AsciiDoc, which can be transformed into e.g. PDF) listing all requirements, where that requirement is implemented and tested, and whether the tests passed/failed. This report can be used e.g. with auditors ("Yes, we track this requirement, it's implemented (here) and it has been tested with a pass (here).")
• Status the software, i.e. get a list of all requirements, their status on implementation and tests. Reqstool will exit with a status code equal to the number of requirements that have not been implemented and tested with a pass. Hence, it can be used in a pipeline as a gate for deployment to production.

Installation

You need to have the following installed in order to use the tool:

• Python, 3.10 or later
• pip or pipx

To use the tool, you need to install the PyPI package reqstool.

pipx install reqstool
reqstool -h # to confirm installation

Usage

reqstool [-h] {command: report-asciidoc,generate-json,status} {location: local,git,maven} ...

Use -h/--help for more information about each command and location.

Documentation

Full documentation can be found here.

Contributing

See the organization-wide CONTRIBUTING.md.

License

MIT License.