Sphinx "clearquest" extension
Project description
.. -*- restructuredtext -*-
=============================
Sphinx "ClearQuest" extension
=============================
Description
===========
A sphinx extension that adds a ``clearquest`` directive for converting
ClearQuest__ requests to reStructuredText tables.
__ http://www-01.ibm.com/software/awdtools/clearquest/
Dependencies
============
Sphinx
http://sphinx.pocoo.org/
PyWin32
http://sourceforge.net/projects/pywin32/ (**PyWin32** will not be automatically
installed by ``easy_install`` or ``pip install`` as ``egg`` packages are not
available on **pypi**)
Installation & Usage
====================
You can install the ``sphinxcontrib.clearquest`` package with ``easy_install``
or ``pip``: ::
$ easy_install sphinxcontrib-clearquest
Or with the windows installer available on this page.
.. important:: You must manually install **PyWin32** for the directive to work.
Append ``'sphinxcontrib.clearquest'`` to extensions parameter, and run Sphinx.
Directive Syntax
================
The syntax of the directive is as follows: ::
.. clearquest:: <full name/of the clearquest query> (mandatory)
:params: <parameters to pass to the query> (optional)
:username: <your username> (optional)
:password: <your password> (optional)
:db_name: <the name of the db> (optional)
:db_set: <the name of the db set> (optional)
The parameters to pass to the query must respect the following syntax: ::
<param1_name>=<param1_value>,<param2_name>=<param2_value>, ...
You can provide them in any order as long as you don't forget one.
The query call will fail if you do.
The connection credentials can either be provided as directive options or
in a ``clearquest`` section in the ``~/.sphinxcontrib`` file which is a
standard ``.ini`` configuration file.
Here is an example of ``~/.sphinxcontrib`` file: ::
[clearquest]
username = john
password = doe
db_name = prod
db_set = cqsrv
=============================
Sphinx "ClearQuest" extension
=============================
Description
===========
A sphinx extension that adds a ``clearquest`` directive for converting
ClearQuest__ requests to reStructuredText tables.
__ http://www-01.ibm.com/software/awdtools/clearquest/
Dependencies
============
Sphinx
http://sphinx.pocoo.org/
PyWin32
http://sourceforge.net/projects/pywin32/ (**PyWin32** will not be automatically
installed by ``easy_install`` or ``pip install`` as ``egg`` packages are not
available on **pypi**)
Installation & Usage
====================
You can install the ``sphinxcontrib.clearquest`` package with ``easy_install``
or ``pip``: ::
$ easy_install sphinxcontrib-clearquest
Or with the windows installer available on this page.
.. important:: You must manually install **PyWin32** for the directive to work.
Append ``'sphinxcontrib.clearquest'`` to extensions parameter, and run Sphinx.
Directive Syntax
================
The syntax of the directive is as follows: ::
.. clearquest:: <full name/of the clearquest query> (mandatory)
:params: <parameters to pass to the query> (optional)
:username: <your username> (optional)
:password: <your password> (optional)
:db_name: <the name of the db> (optional)
:db_set: <the name of the db set> (optional)
The parameters to pass to the query must respect the following syntax: ::
<param1_name>=<param1_value>,<param2_name>=<param2_value>, ...
You can provide them in any order as long as you don't forget one.
The query call will fail if you do.
The connection credentials can either be provided as directive options or
in a ``clearquest`` section in the ``~/.sphinxcontrib`` file which is a
standard ``.ini`` configuration file.
Here is an example of ``~/.sphinxcontrib`` file: ::
[clearquest]
username = john
password = doe
db_name = prod
db_set = cqsrv
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sphinxcontrib-clearquest-0.4.zip
(14.3 kB
view hashes)
Built Distributions
Close
Hashes for sphinxcontrib-clearquest-0.4.zip
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1910202a1bb6514e147791a141adf9a5377e0f0520480a2b6a83cdd0c4c13853 |
|
MD5 | 66a9440f64d913cb9cf2d046d58cb11d |
|
BLAKE2b-256 | 9b1d80e8c6c41e90aaca03170c79d329f9cfcaf44e3129d3fc6d3e908d77ec51 |
Close
Hashes for sphinxcontrib_clearquest-0.4-py2.7.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | e9a8b2918515fb28cd984c690d48eede77bdc6db29bd143df015f3a6e843f3f8 |
|
MD5 | aa30226c88bd23edef9fa0cb09ff9b88 |
|
BLAKE2b-256 | 319cb07d1cf7e253dd91fa2fc86ddfd48627317df5b043fc4c7811cd1c050ff4 |
Close
Hashes for sphinxcontrib-clearquest-0.4.win32.exe
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1e402a0b875880167f9a81e85c30f0a7a57ec967ebc4c224a05f6a639c58b863 |
|
MD5 | 68c235fc845bb2947b003124fa372438 |
|
BLAKE2b-256 | 03a607c08a4388ed309027806122ae658066f9f52d01414122da515a37fe9114 |