openstack
/
fairy-slipper
Code Issues Proposed changes
RETIRED, API documentation generator and builder for OpenStack
110 Commits 1 Branch 2 Tags 1.5 MiB
Go to file
Russell Sim da3805a15c Updated accordion style 2015-09-28 10:32:22 +10:00
doc/source Fix the routes inspector prototype 2015-09-15 21:12:43 +10:00
fairy_slipper Merge branch 'master' of https://github.com/russell/fairy-slipper into fslipper-rst-bugs 2015-09-24 12:43:56 -04:00
public Updated accordion style 2015-09-28 10:32:22 +10:00
tools Some simple style fixes 2015-09-15 19:21:52 +10:00
.bowerrc Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
.coveragerc Removed unrecognised section from coveragerc 2015-09-27 09:50:47 +10:00
.gitignore Add Travis CI 2015-08-30 21:48:18 +10:00
.gitreview Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
.mailmap Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
.testr.conf Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
.travis.yml Moved back with explicit path for executable 2015-09-10 08:43:45 +10:00
CONTRIBUTING.rst Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
Gruntfile.js Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
HACKING.rst Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
LICENSE Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
MANIFEST.in Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
README.rst Add run_server.sh script 2015-08-13 07:32:39 +10:00
babel.cfg Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
bower.json Removed dependency on angular-swagger-ui 2015-09-20 14:50:15 +10:00
config.py PEP8 Fixes 2015-09-02 18:20:59 +10:00
fairy_slipper.wsgi Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
karma.conf.js Increase the karma timeout 2015-09-27 12:41:03 +10:00
migrate.sh Move utility scripts into the main code base 2015-09-02 20:00:22 +10:00
openstack-common.conf Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
package.json Initial implementation of schema rendering 2015-09-09 21:37:38 +10:00
requirements.txt Updates requirements.txt for PBR error and adds xsd:base64binary 2015-08-17 21:57:12 -05:00
run_server.sh Add bower to run_server.sh script 2015-08-20 21:46:40 +10:00
run_tests.sh Added run_tests.sh script 2015-09-10 09:05:26 +10:00
setup.cfg Add tempest request/responses to the examples 2015-09-15 19:19:24 +10:00
setup.py Implemented Initial Prototype 2015-07-24 08:29:52 +10:00
test-requirements.txt Test without pytest 2015-08-14 08:25:23 +10:00
tox.ini Moved back with explicit path for executable 2015-09-10 08:43:45 +10:00

README.rst

fairy-slipper

A project to make OpenStack API's self documententing.

Features

  • TODO

Development

First run the migrate script to initially migrate the content from wadl:

./migrate.sh

This script will checkout the current version of the documentation.

To run the webserver use:

./run_server.sh

A Pecan based webserver will then listen on http://127.0.0.1:8080

AngularJS

To develop the AngularJS component, it's easiest if you use the grunt webserver:

grunt

You will still need to run the Fairy-Slipper webserver, but this will enable auto reloading if you visit the port http://127.0.0.1:9000

Directory Structure (Future)

Current documentation layout:

api-doc/ -- the root of the documentation
api-doc/index.json  -- the index file that lists all the files that are included in the API doc.
api-doc/<service>/<version>.rst
api-doc/<service>/<version>/<request_schema>.json
api-doc/<service>/<version>/<response_schema>_<status_code>.json
api-doc/<service>/<version>/examples/<request>_req.json
api-doc/<service>/<version>/examples/<response>_resp_<status_code>.json

Other Swagger UIs

Taken from https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services

Other API documentation Tools

Alternative Clients

Other Useful Tools