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.man | |
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.man')
-rw-r--r-- | documentation/nitrate.man | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/documentation/nitrate.man b/documentation/nitrate.man new file mode 100644 index 0000000..ade1542 --- /dev/null +++ b/documentation/nitrate.man @@ -0,0 +1,84 @@ +.\" Man page generated from reStructeredText. +. +.TH NITRATE 1 "" "" "" +.SH NAME +nitrate \- Python API for the Nitrate test case management system +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.SH SYNOPSIS +.sp +nitrate +.SH DESCRIPTION +.sp +python\-nitrate provides a high\-level Python interface to the +Nitrate test case management system. The package also provides +standalone script \(aqnitrate\(aq 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: +.sp +.nf +.ft C +$ nitrate +>>> for case in TestRun(123): +\&... print case +.ft P +.fi +.SH CONFIGURATION +.sp +To be able to contact the Nitrate server a minimal user config +file ~/.nitrate has to be provided in the user home directory: +.sp +.nf +.ft C +[nitrate] +url = https://nitrate.server/xmlrpc/ +.ft P +.fi +.SH SEE ALSO +.sp +For more detailed and most up\-to\-date description of all available +nitrate module features see Python online documentation: +.sp +.nf +.ft C +pydoc nitrate +.ft P +.fi +.SH AUTHORS +.sp +Written by Petr Splichal <\fI\%psplicha@redhat.com\fP>. The Python xmlrpc +driver is based on the work of Airald Hapairai, David Malcolm +<\fI\%dmalcolm@redhat.com\fP>, Will Woods <\fI\%wwoods@redhat.com\fP> and Bill Peck +<\fI\%bpeck@redhat.com\fP> and was enhanced by Chenxiong Qi <\fI\%cqi@redhat.com\fP>, +Tang Chaobin <\fI\%ctang@redhat.com\fP>, Yuguang Wang <\fI\%yuwang@redhat.com\fP> and +Xuqing Kuang <\fI\%xuqingkuang@gmail.com\fP>. +.\" Generated by docutils manpage writer. +.\" +. |