This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

griffin: RAML reference implementation in Python


This is an ALPHA! Be prepared for shit to break!

Requirements and Installation

User Setup

The latest version (currently alpha only) can be found on PyPI, and you can install via pip:

$ pip install griffin --pre

The --pre is needed to download since it’s still in alpha.

Continue onto usage to get started on using griffin.

Supported Python/Systems


currently runs with Python 2.7 - but will get up to 3.3+ and PyPy

Both Linux and OS X are supported.

Developer Setup

If you’d like to contribute or develop upon griffin, be sure to read How to Contribute first.

System requirements:

  • C Compiler (gcc/clang/etc.)
  • If on Linux - you’ll need to install Python headers (e.g. apt-get install python-dev)
  • Python 2.6, 2.7, 3.3+, or PyPy
  • virtualenv

Here’s how to set your machine up:

$ git clone
$ cd griffin
$ virtualenv env
$ source env/bin/activate
(env) $ pip install -r dev-requirements.txt

Run Tests

If you’d like to run tests for all supported Python versions, you must have all Python versions installed on your system. I suggest pyenv to help with that.

To run all tests:

(env) $ tox

To run a specific test setup (options include: py26, py27, py33, py34, pypy, flake8, verbose, manifest, docs, setup, setupcov):

(env) $ tox -e py26

To run tests without tox:

(env) $ py.test
(env) $ py.test --cov griffin --cov-report term-missing

Build Docs

Documentation is build with Sphinx, written in rST, uses the Read the Docs theme with a slightly customized CSS, and is hosted on Read the Docs site.

To rebuild docs locally, within the parent griffin directory:

(env) $ tox -e docs


(env) $ sphinx-build -b docs/ docs/_build


(env) $ cd docs
(env) $ make html

Then within griffin/docs/_build you can open the index.html page in your browser.

Still have issues?

Feel free to drop by #ramlfications on Freenode (webchat) (no dedicated IRC channel - yet) or ping via Twitter. “roguelynn” on IRC is the maintainer, a.k.a econchick on GitHub, and based in San Fran.


0.0.1a (2015-07-29)

Super alpha version!

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
griffin-0.0.1.dev1-py2.py3-none-any.whl (14.2 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Aug 5, 2015
griffin-0.0.1.dev1.tar.gz (1.1 MB) Copy SHA256 Checksum SHA256 Source Aug 5, 2015

Supported By

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