diff options
author | Petr Šplíchal <psplicha@redhat.com> | 2012-02-21 16:57:26 +0100 |
---|---|---|
committer | Petr Šplíchal <psplicha@redhat.com> | 2012-02-21 16:59:24 +0100 |
commit | d1ee888d9f4760aee77a75df9a211265df0e8569 (patch) | |
tree | 3dd709938689c36e7f54738189b17571e339a356 /documentation/nitrate.rst | |
parent | 1c9fc0c227f1deae0efca187c38dab79c56c6fe0 (diff) | |
download | python-nitrate-d1ee888d9f4760aee77a75df9a211265df0e8569.tar.gz python-nitrate-d1ee888d9f4760aee77a75df9a211265df0e8569.tar.xz python-nitrate-d1ee888d9f4760aee77a75df9a211265df0e8569.zip |
Documentation (man page and coverage overview)
Diffstat (limited to 'documentation/nitrate.rst')
-rw-r--r-- | documentation/nitrate.rst | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/documentation/nitrate.rst b/documentation/nitrate.rst new file mode 100644 index 0000000..f32a1a6 --- /dev/null +++ b/documentation/nitrate.rst @@ -0,0 +1,62 @@ + +================================================================== + nitrate +================================================================== + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Python API for the Nitrate test case management system +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:Manual section: 1 + + +SYNOPSIS +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +nitrate + + +DESCRIPTION +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +python-nitrate provides a high-level Python interface to the +Nitrate test case management system. The package also provides +standalone script 'nitrate' which allows easy experimenting with +the interface directly from the Python interpreter by importing +all available objects and enabling the readline support. In short, +after setting your configuration you can directly manipulate all +nitrate objects, for example:: + + $ nitrate + >>> for case in TestRun(123): + ... print case + + +CONFIGURATION +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To be able to contact the Nitrate server a minimal user config +file ~/.nitrate has to be provided in the user home directory:: + + [nitrate] + url = https://nitrate.server/xmlrpc/ + + +SEE ALSO +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For more detailed and most up-to-date description of all available +nitrate module features see Python online documentation:: + + pydoc nitrate + + +AUTHORS +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Written by Petr Splichal <psplicha@redhat.com>. The Python xmlrpc +driver is based on the work of Airald Hapairai, David Malcolm +<dmalcolm@redhat.com>, Will Woods <wwoods@redhat.com> and Bill Peck +<bpeck@redhat.com> and was enhanced by Chenxiong Qi <cqi@redhat.com>, +Tang Chaobin <ctang@redhat.com>, Yuguang Wang <yuwang@redhat.com> and +Xuqing Kuang <xuqingkuang@gmail.com>. |