Open Source Requirements Management Tool
This Readme gives a short overview over the available online documentation for rmtoo.
This file contains the following chapters:
Conventions
Operating System Support
Preinstalled VMs
Installation
Installation using virtualenv
First Project
Man Pages
Other Documentation
Emacs Mode for Editing Requirements
Footer
YY: names the version of rmtoo. You have to replace this with the real
version number.
$ cmd: This is a command you have to type in. The $ is a replacement for
the shell prompt - do not enter it as a part of the command.
rmtoo is fully supported under Linux. Nevertheless, because it is written in computer independent programming languages (such as python), is also works on other operating systems.
Mac OS X users might want to read Readme-OS-X.txt.
Windows users might want to read the Readme-Windows.txt.
For evaluation proposes and running small projects there is the possibility to use Amazon AWS EC2 preinstalled VMs.
More details are available in a dedicated Readme.
The following sections assume, that you are using Linux. Please refer to the appropriate Readme file for your operating system for more information if you do not use Linux.
To use rmtoo, other software packages must be installed.
rmtoo is written in python. At least version 3.5 of python is needed. python 3.8 may work, but there is a problem (bug (fix)?) is python 3.8 which create different XML elements as the previous versions.
When you want to create LaTeX or PDF documentation, LaTeX is needed.
For the requirements dependency graph, graphviz is used.
For statistics plot gnuplot is used. For the estimation module the python-scipy package is needed.
Typically the packages from your distribution will work.
The recommended way of starting is to copy the provided template project.
The basic steps are:
- Copy over the template project to some other directory.
- Set up the environment
- Run
make - Check, if everything worked
- Start changing / adapting things to your needs
Note that during this document the project will be called 'MyNewProject'. Please adapt the name for your needs.
This is the preferred installation method - it takes care that at least the python dependencies are correctly installed.
To install rmtoo in a virtualenv, execute the following steps:
$ mkdir RMTOO
$ cd RMTOO
$ virtualenv venv
$ source venv/bin/activate
$ pip install --upgrade pip setuptools wheel
$ pip install --only-binary=numpy,scipy numpy scipy
$ pip install rmtoo
This has only to be done once.
Change to a directory where you want to create the new project. This is needed only once.
# cd to virtualenv directory - if not already there
$ cd RMTOO
$ cp -r venv/rmtoo/contrib/template_project MyNewProject
To create all the artifacts for the template project, execute
$ cd MyNewProject
$ source ./setenv.sh VENV
$ make
$ ls artifacts
In the artifacts directory there are all the generated files. A typical
workflow is, to change or add requirements, topics or the configuration
in the MyNewProject directory, run make again and check the
artifacts.
When using the virtualenv, use
$ man -l venv/rmtoo/share/man/man7/rmtoo.7
to get an overview over all available man pages. Those other man pages you can read also with man. Replace the file name with the appropriate manual page, like:
$ man -l venv/rmtoo/share/man/man7/rmtoo-analytics.7
Additional documentation can be found in the directories
RMTOO/venv/rmtoo/doc (especially the Readme files).
Frequently asked questions A collection of questions which were ask in the past - including the answers.
There are also two presentations about the design and features of rmtoo. Theese presentations can be found in the download section of the sourceforge project page. Please visit the projects home page http://rmtoo.florath.net
Description of the features of rmtoo.
Small (and yet unfinished) document how to develop functionality and modules for rmtoo.
Hints for Mac Users.
Hints for Windows users.
Run rmtoo to get the documentation for rmtoo itself.
Some note about the (internal) use of GitPython.
When using the tar package, emacs mode can be loaded in emacs by:
M-x load-file point to RMTOO/venv/rmtoo/contrib/req-mode.el All
files with suffix .req will now use the requirements editing mode.
If you have some problems, remarks or feature request, you're welcome to visit the project home page
| flonatel GmbH & Co. KG
| Andreas Florath
| [email protected]
(c) 2010-2012,2017,2020,2022 by flonatel GmbH & Co. KG
For licensing details see COPYING