Text-based Requirement Management using AsciiDoc and version control
Project description
AsciiReqs - Requirements Management using AsciiDoc markdown and git
What it is
Requirement Management software can be complicated and inconvenient to use. Support for collaboration and change management can be cumbersome and poor. What if we could instead store our requirements in git and use that for versioning and use pull requests for review and management of changes?
This project is a (simple) parser for AsciiDoc files written in Python that will identify requirements in AsciiDoc files, and build a requirements project model from this. It uses this to do reporting and data export, and will also post process the AsciiDoc files to insert cross-links and report data. This can then be turned into HTML or PDF by tools like AsciiDoctor.
The parser supports requirement document hierarchies, and can find and report inconsistencies in requirement cross-links between documents.
This allows complicated sets of product requirements to be managed in AsciiDoc.
AsciiReqs is to some degree inspired by Sphinx-Needs and Doorstop.
Status
This is a prototype that I wrote out of frustration with an ancient (but common) Requirement Management System. I also wanted to freshen up my Python skills. Python is fun, so it ended up with more features than I had originally planned. It must still be considered a prototype, but it is in a workable state and the current functionality is at a level where it can be quite useful.
More information
The full Readme is written in AsciiDoc and can be found here: Readme.adoc
Project details
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
Hashes for asciireqs-0.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a658117d03d5c02f3524fe9f9327b9cfe578ac587e600475b036788e3025a36a |
|
MD5 | f13beb27f6771f92d14460a009725db3 |
|
BLAKE2b-256 | 5f5b49b776df1e9148cecde8a56bd58bea18fa3a2790e8afab8bbcdf764272fc |