From 6b809f9ef9418fd43af0864fdf0f95d8c88106a7 Mon Sep 17 00:00:00 2001 From: Petr Šplíchal Date: Wed, 22 Feb 2012 11:59:18 +0100 Subject: Generate documentation from reStructuredText README converted to reStructuredText manual pages now generated dynamically documentation/nitrate.man no more necessary --- README | 90 +++++++++++++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 62 insertions(+), 28 deletions(-) (limited to 'README') diff --git a/README b/README index 4f79fa9..c84a369 100644 --- a/README +++ b/README @@ -1,15 +1,27 @@ +====================== + python-nitrate +====================== + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Python API for the Nitrate test case management system ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +:Manual section: 1 +:Manual group: User Commands +:Date: February 2012 + + +DESCRIPTION +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ python-nitrate is a Python interface to the Nitrate test case management system. The package consists of a high-level Python module (provides natural object interface), a low-level driver (allows to directly access Nitrate's xmlrpc API) and a command line interpreter (useful for fast debugging and experimenting). -Features + +FEATURES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Among the most essential python-nitrate features are: @@ -22,34 +34,34 @@ Among the most essential python-nitrate features are: The main motivation was to hide unnecessary implementation details wherever possible so that using the API is as concise as possible. -Initialize or create an object: +Scripts importing python-nitrate can make use of several useful +helper functions including info() for logging to stderr, listed() +which converts list into nice human readable form, color() for +coloring and of course log.{debug,info,warn,error} for logging. + + +EXAMPLES +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Initialize or create an object:: testcase = TestCase(1234) testrun = TestRun(testplan=, summary=) -Default iterators provided for all container objects: +Default iterators provided for all container objects:: - for case in TestRun(1234): + for case in TestRun(1234):: if case.automated: case.status = Status("RUNNING") -Linking case to a plan is as simple as adding an item to a set: +Linking case to a plan is as simple as adding an item to a set:: testplan.testcases.add(testcase) However, it's still possible to use the low-level driver when a -specific features is not implemented yet or not efficient enough: +specific features is not implemented yet or not efficient enough:: testcasehash = Nitrate()._server.TestCase.get(46490) -Scripts importing python-nitrate can make use of several useful -helper functions including info() for logging to stderr, listed() -which converts list into nice human readable form, color() for -coloring and of course log.{debug,info,warn,error} for logging. - - -Examples -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For a quick start you can get some inspiration in the examples directory. The 'matrix.py' script demonstrates how to easily display a matrix view of the test run results for a specific test @@ -57,14 +69,7 @@ plan. The 'create.py' script gives a broader overview covering object creation, attribute setting, adjusting logs and caching. -Documentation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -For a short introduction see the manual page. For more detailed -and most up-to-date description of all available nitrate module -features see Python online documentation using 'pydoc nitrate'. - - -Test Suite +TEST SUITE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The high-level interface has an integrated test suite, which can be easily run against a stage server instance. For this a couple @@ -73,21 +78,50 @@ so that we can check valid results. For detailed information about what data has to be prepared see the module documentation. -Links +LINKS ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -python-nitrate project page: -https://fedorahosted.org/python-nitrate/ +Project page: +http://psss.fedorapeople.org/python-nitrate/ Nitrate test case management system: https://fedorahosted.org/nitrate/ -Enjoy! +SEE ALSO ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +For more detailed and most up-to-date description of all available +nitrate module features see the Python online documentation:: + + pydoc nitrate + pydoc nitrate.xmlrpc + + +AUTHORS +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +High-level Python module: +Petr Šplíchal , +Zbyšek Mráz . + +Low-level XMLRPC driver: +Airald Hapairai, +David Malcolm , +Will Woods , +Bill Peck , +Chenxiong Qi , +Tang Chaobin , +Yuguang Wang +and Xuqing Kuang . + Hope, the library will save you time and bring some joy when writing scripts interacting with the Nitrate server. Looking forward to your feedback, comments, suggestions and patches ;-) -Petr Šplíchal - +COPYRIGHT +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Copyright (c) 2012 Red Hat, Inc. All rights reserved. + +This library is free software; you can redistribute it and/or +modify it under the terms of the GNU Lesser General Public +License as published by the Free Software Foundation; either +version 2.1 of the License, or (at your option) any later version. -- cgit