summaryrefslogtreecommitdiffstats
path: root/documentation/nitrate.rst
blob: f32a1a6c3d9608466c5d37c70d91584874dd26ee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
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>.