# 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](https://github.com/hpenne/asciireqs/blob/master/README.adoc)
Raw data
{
"_id": null,
"home_page": null,
"name": "asciireqs",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.7",
"maintainer_email": null,
"keywords": "Requirement Management, version control, git, text-based, AsciiDoc",
"author": "Helge Penne",
"author_email": "hpenne@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/86/5d/10c2a68dd7e0ae82c204c86390cbb1ba85139dd2f57ca8a3224a218f5b1c/asciireqs-0.0.7.tar.gz",
"platform": null,
"description": "# AsciiReqs - Requirements Management using AsciiDoc markdown and git\n\n## What it is\n\nRequirement Management software can be complicated and inconvenient to use.\nSupport for collaboration and change management can be cumbersome and poor.\nWhat if we could instead store our requirements in git and use that for versioning and use pull requests for review and management of changes?\n\nThis 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.\nIt 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.\n\nThe parser supports requirement document hierarchies, and can find and report inconsistencies in requirement cross-links between documents.\n\nThis allows complicated sets of product requirements to be managed in AsciiDoc.\n\nAsciiReqs is to some degree inspired by Sphinx-Needs and Doorstop.\n\n## Status\n\nThis is a prototype that I wrote out of frustration with an ancient (but common) Requirement Management System.\nI also wanted to freshen up my Python skills.\nPython is fun, so it ended up with more features than I had originally planned.\nIt 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.\n\n## More information\n\nThe full Readme is written in AsciiDoc and can be found here:\n[Readme.adoc](https://github.com/hpenne/asciireqs/blob/master/README.adoc)\n",
"bugtrack_url": null,
"license": null,
"summary": "Text-based Requirement Management using AsciiDoc and version control",
"version": "0.0.7",
"project_urls": null,
"split_keywords": [
"requirement management",
" version control",
" git",
" text-based",
" asciidoc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5f5b49b776df1e9148cecde8a56bd58bea18fa3a2790e8afab8bbcdf764272fc",
"md5": "f13beb27f6771f92d14460a009725db3",
"sha256": "a658117d03d5c02f3524fe9f9327b9cfe578ac587e600475b036788e3025a36a"
},
"downloads": -1,
"filename": "asciireqs-0.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f13beb27f6771f92d14460a009725db3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.7",
"size": 13328,
"upload_time": "2024-08-19T04:17:07",
"upload_time_iso_8601": "2024-08-19T04:17:07.885205Z",
"url": "https://files.pythonhosted.org/packages/5f/5b/49b776df1e9148cecde8a56bd58bea18fa3a2790e8afab8bbcdf764272fc/asciireqs-0.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "865d10c2a68dd7e0ae82c204c86390cbb1ba85139dd2f57ca8a3224a218f5b1c",
"md5": "f23fc9b403312e51fdb5821b2c2ce33d",
"sha256": "a59996f5eb1a2a9bac880e7e2bb7e6d8cc46205f15b51e1252faf7ec49ecbc12"
},
"downloads": -1,
"filename": "asciireqs-0.0.7.tar.gz",
"has_sig": false,
"md5_digest": "f23fc9b403312e51fdb5821b2c2ce33d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.7",
"size": 14992,
"upload_time": "2024-08-19T04:17:08",
"upload_time_iso_8601": "2024-08-19T04:17:08.989784Z",
"url": "https://files.pythonhosted.org/packages/86/5d/10c2a68dd7e0ae82c204c86390cbb1ba85139dd2f57ca8a3224a218f5b1c/asciireqs-0.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-19 04:17:08",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "asciireqs"
}
JSON