Skip to main content

A tool to generate Requirement Traceability Matrices (RTMs) from Doorstop documents.

Project description

rtm_doorstop

PyPI Version PyPI - Python Version PyPI - License Sonarcloud Code style: black

A tool to generate Requirement Traceability Matrices (RTMs) from Doorstop documents.


Table of Contents


Features

The rtm_doorstop tool can be used to quickly build an Requirements Traceability Matrix (RTM) from a Doorstop tree. RTMs map product requirements to test cases, which verify that said requirements are met. They are particularly useful to quickly understand the requirement coverage and any areas deficient in quality checks.

This tool can generate RTMs that are in Markdown-compliant format, or write to a CSV file.

| UID     | Has Test | Need Test | Tests                   |
|---------|----------|-----------|-------------------------|
| REQ0001 |     True |      True | TST0001                 |
| REQ0002 |    False |     False |                         |
| REQ0003 |     True |      True | TST0003 TST0004 TST0005 |
UID,Has Test,Need Test,Tests
REQ0001,True,True,TST0001
REQ0002,False,False,
REQ0003,True,True,TST0003 TST0004 TST0005

Usage

The tool can be invoked via command line, and has one required argument: PREFIX

rtm_doorstop --prefix=PREFIX

or simply

rtm_doorstop PREFIX

Optional arguments are --root, --sort_key, and --csv_path.

Argument Description
root If Doorstop cannot build a valid tree from the current working directory, you can specify the path to the tree root here
sort_key If the RTM should be sorted, you can specify the key to sort by here. Valid options are 'UID', 'Has Test', or 'Tests' When ommitted, no ordering is guaranteed.
csv_path The filepath where the tool should save the RTM to. When omitted, the RTM is printed to console in Markdown format.

Tests are assumed to be linked to the requirements as as child links. Doorstop specifies these links in the "links" yaml key. For instance, the following test would be linked to requirement REQ046.

active: true
custom: 1
derived: false
header: ''
level: 4
links:
- REQ046: m9tMd0JM8O8idHTViqyYy1OL3dLiVY69bT63jNAGxPs=
normative: true
ref: test_yaml_encoding
reviewed: TIwopA6cvyjBMF17bB6p_RUNA7clNMaaEhXGYlAdpdk=
test_commit_last_passed: d670460b4b4aece5915caf5c68d12f560a9fe3e4
test_commit_latest: d670460b4b4aece5915caf5c68d12f560a9fe3e4
test_result_latest: passed
text: |
  Test that inputs can be loaded from a UTF-8 encoded YAML file.

Installation

You can install "rtm_doorstop" via pip from PyPI:

pip install rtm_doorstop

Dependencies


Contributing

Contributions are very welcome, both in Issues and in Pull Requests. Tests can be run with tox.

$ tox

If you encounter any problems, please file an issue along with a detailed description.


License

Distributed under the terms of the GNU GPL v3.0 license, "rtm_doorstop" is free and open source software

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

rtm_doorstop-1.1.1.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

rtm_doorstop-1.1.1-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file rtm_doorstop-1.1.1.tar.gz.

File metadata

  • Download URL: rtm_doorstop-1.1.1.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/2.0.0 pkginfo/1.4.2 requests/2.21.0 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for rtm_doorstop-1.1.1.tar.gz
Algorithm Hash digest
SHA256 3c9eb084f3ca2151ea6eed068eb1922be0008b89f3c182ea6b7a6e0dff53d45e
MD5 47a18adcf4f5bc90dc17c7c789731dae
BLAKE2b-256 ed7e9aa8c9c8a8cf8daf87523d24e2e46028de63a47e581c9b1a37db866c1029

See more details on using hashes here.

File details

Details for the file rtm_doorstop-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: rtm_doorstop-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 16.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/2.0.0 pkginfo/1.4.2 requests/2.21.0 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for rtm_doorstop-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2ce79d6ed9759d33e4a4991714dd18253d632097bb82554290e42235764f2385
MD5 2378ce4bc2ef231d8967c8cbb12b695f
BLAKE2b-256 a50ea62106070c220e724731a9ecd885f054e7cbf0fc713c79f7bfeb304a991a

See more details on using hashes here.

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