Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Sphinx "clearquest" extension

Project Description


A sphinx extension that adds a clearquest directive for converting ClearQuest requests to reStructuredText tables.


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.


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:

username = john
password = doe
db_name = prod
db_set = cqsrv

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(207.7 kB) Copy SHA256 Hash SHA256
Windows Installer 2.7 Apr 26, 2012
(14.4 kB) Copy SHA256 Hash SHA256
Source None Apr 26, 2012

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting