Requirements management using version control.
Project description
Overview
Doorstop is a requirements management tool that facilitates the storage of textual requirements alongside source code in version control.
When a project utilizes this tool, each linkable item (requirement, test case, etc.) is stored as a YAML file in a designated directory. The items in each directory form a document. The relationship between documents forms a tree hierarchy. Doorstop provides mechanisms for modifying this tree, validating item traceability, and publishing documents in several formats.
Doorstop is under active development and we welcome contributions.
The project is licensed as LGPLv3.
To report a problem or a security vulnerability please raise an issue.
Additional reading:
- publication: JSEA Paper
- talks: GRDevDay, BarCamp
- sample: Generated HTML
Setup
Requirements
- Python 3.5+
- A version control system for requirements storage
Installation
Install Doorstop with pip:
$ pip install doorstop
or directly from source:
$ git clone https://github.com/jacebrowning/doorstop.git
$ cd doorstop
$ python setup.py install
After installation, Doorstop is available on the command-line:
$ doorstop --help
And the package is available under the name 'doorstop':
$ python
>>> import doorstop
>>> doorstop.__version__
Usage
Switch to an existing version control working directory, or create one:
$ git init .
Create documents
Create a new parent requirements document:
$ doorstop create SRD ./reqs/srd
Add a few items to that document:
$ doorstop add SRD
$ doorstop add SRD
$ doorstop add SRD
Link items
Create a child document to link to the parent:
$ doorstop create HLTC ./tests/hl --parent SRD
$ doorstop add HLTC
Link items between documents:
$ doorstop link HLTC001 SRD002
Publish reports
Run integrity checks on the document tree:
$ doorstop
Publish the documents as HTML:
$ doorstop publish all ./public
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file doorstop-1.6b2.tar.gz.
File metadata
- Download URL: doorstop-1.6b2.tar.gz
- Upload date:
- Size: 225.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/0.12.17 CPython/3.7.2 Darwin/18.6.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f836d817798da1b70dfc6eaa14bb660440c9a4b6e1d620a5703515a73a2f31a3 |
|
| MD5 | bb5cfb450b00e729c1c89394df3b0e36 |
|
| BLAKE2b-256 | 0c8d194bcdc0bb2a1d298b35dd7620b5714734aeab9dc8804d13da8c0010e64b |
File details
Details for the file doorstop-1.6b2-py3-none-any.whl.
File metadata
- Download URL: doorstop-1.6b2-py3-none-any.whl
- Upload date:
- Size: 268.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/0.12.17 CPython/3.7.2 Darwin/18.6.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3274a9c8e24713faa295e540b51c16d3392974b72bdd374b33d78c2a25738bc6 |
|
| MD5 | 9328a7ec06b4ae5fa59ea61820c14898 |
|
| BLAKE2b-256 | 366e9f94b351f43d2b0e42d36607337657d7a01750924463800d26a07a0d73fd |
