An API Documentation generator.
- Code sample generation - Automatic code samples for Python, Javascript, and the command line.
- Schema support - Currently supports Swagger, RAML, and JSON HyperSchema.
- Themes - Currently includes the Slate API documentation theme. Additional themes and support for theme customization is planned.
The following will build API documentation for the Swagger "PetStore" example API.
$ pip install coredocs
$ pip install openapi-codec
$ coredocs build http://petstore.swagger.io/v2/swagger.json --format openapi
Preview the generated documentation.
The following will build API documentation for the Spotify API, based on their RAML schema.
$ pip install coredocs
$ pip install raml-codec
$ coredocs build https://raw.githubusercontent.com/spotify/web-api/master/specifications/raml/api.raml --format raml