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!

REST APIs documentation builder tool

Project Description

RESTful api documentation generation script

script to generate restful api documentation out of annotated php code. [Output example you can find here](

annotation example

* @route /v1/modulename/authentication
* @method POST
* @ingroup modulename
* authentication service example
* HTTP response code tells about status of login:
* - 202: Request Accepted
* - 401: Invalid username/password
* - 403: Request Denied
* - 503: Service Unavailable
* @example input
* POST /v1/modulename/authentication HTTP/1.1
* Content-Type: application/json; charset=utf-8
* {
* "username": "demousername",
* "passwrod": "demopassword",
* }
* @example output
* {
* "message":"Request Accepted",
* "id":386
* }
* @jsonparam username extranet username required
* @jsonparam password extranet password required
* @returns json

pip install -r requirements.txt

$ python -c

usage: [-h] [-c] [-d DIR] [--filter FILTER] [-o OUTPUT]

optional arguments:
-h, --help show this help message and exit
-c, --coverage ouputs into stdin documentation coverage
-d DIR, --dir DIR folder in which we need look for documentation
annotation. default: test_src_folder/
--filter FILTER gob filter in which files to search. default:
-o OUTPUT, --output OUTPUT
output filename. default: documentation.html

open generated documentation.html

Release History

This version
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
(6.3 kB) Copy SHA256 Hash SHA256
Source None Aug 30, 2013

Supported By

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