Skip to main content

Document APIs with CoreAPI.

Project description

coreapidocs [![travis][travis-image]][travis-url] [![pypi][pypi-image]][pypi-url]
Document APIs with CoreAPI.

### Prerequisites

- Python (2.7, 3.3, 3.4, 3.5)
- Core API ([Read More](

### Installation
You can install `coreapidocs` through pypi.

pip install coreapidocs

### Usage
You will have to pass a `.json` document to initialize the docs.

from import Docs

schema = open(filename, 'rb').read()
docs = Docs(schema)
except (IOError, OSError):
abort(400, {"msg": "No such file or directory - %s" % filename})

Then you can simply pass the `docs` variable to your template (ie. Flask):

return render_template('home.html', docs=docs.get_docs())

For more information view the source of [](coreapidocs/

### Development
Create the virtualenv and install the requirements.

virtualenv env
source env/bin/activate

pip install -r requirements.txt

You will need to pass an argument ie. `document.json`.

python coreapidocs/ document.json
# Then go to:

### Usage
Below you can find an example Flask application. Using `jinja2` you can pass the `coreapidocs` template to your view.

import sys
import jinja2
from flask import Flask, abort, render_template
from import Docs

app = Flask(__name__)

def docs():
Generate the coreapidocs and serve them to roor.
Accepts one parameter with a filename (ie. document.json)

if len(sys.argv) != 2:
abort(400, {"msg": "Missing file parameter ie. document.json"})

filename = sys.argv[-1]

schema = open(filename, 'rb').read()
docs = Docs(schema)
except (IOError, OSError):
abort(400, {"msg": "No such file or directory - %s" % filename})

templates_loader = jinja2.PackageLoader('coreapidocs', 'templates')
template_env = jinja2.Environment(loader=templates_loader)
template = template_env.get_template('docs.html')

# FIXME: Figure out how to pas static files

return render_template(template, docs=docs.get_docs())

def static_proxy(path):
Serve static files.
"send_static_file" will guess the correct MIME type
return app.send_static_file(path)

if __name__ == '__main__':
app.debug = True

### Tests
In order to run the tests you will have to run:




Project details

Download files

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

Files for coreapidocs, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size coreapidocs-0.0.2.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page