Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asciireqs-0.0.7.tar.gz (15.0 kB view hashes)

Uploaded Source

Built Distribution

asciireqs-0.0.7-py3-none-any.whl (13.3 kB view hashes)

Uploaded Python 3

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