REST Framework for pyramids
Project description
=============
Lovely PyRest
=============
Lovely Pyrest provides helpers to build REST-Webservices with pyramid.
Features
========
- raise a 405 if an unimplemented method is called on a servie
- provides schema validation using validictory
- raises correct errors if the `Accept` or `Content-Type` header doesn't match
- sphinx extension to automatically generate service documentation
Documentation
=============
Take a look at the `documentation <http://http://lovelysystems.github.io/lovely.pyrest/>`_
for usage information.
Development Setup
=================
For development setup instructions see:
INSTALL.txt
Bootstrap and buildout
======================
Bootstrap with python 2.7::
/opt/local/bin/python2.7 bootstrap.py
Run buildout::
./bin/buildout -N
Note::
Python shouldn't have installed any 3rd party packages
Testing
=======
To run all the tests use::
./bin/test
For additional testrunner options run::
./bin/test --help
Generating Documentation
========================
Before generating the new documentation make sure the `gh-pages` submodule is up-to-date::
git submodule init
git submodule update
To generate the new documentation run::
./bin/sphinx-html
The documentation is located in the `gh-pages` directory which points to the
`gh-pages` submodule.
Publish documentation
---------------------
To publish the documentation commit the changed files in the `gh-pages`
submodule::
cd gh-pages
git add <changed-files>
git commit -m "updated documentation"
git push origin gh-pages
========================
Changes for Lovey Pyrest
========================
unreleased
==========
2013/10/21 0.1.0
================
- added information how to publish documentation on gh-pages
- auto-doc: fixed bug where normal text gets included in <h4> tag
- removed closed source dependencies, so this package can be open sourced
- added license information
2013/10/11 0.0.11
=================
- bugfix: fixed query validation
2013/10/11 0.0.10
=================
- convert boolean for query parameter validation
2013/10/11 0.0.9
================
- changed schema validation for compatibility
2013/10/11 0.0.8
================
- number conversation for query parameters
2013/10/09 0.0.7
================
- Services provide help functionality by default
2013/10/08 0.0.6
================
- enabled JSONP support
2013/10/08 0.0.5
================
- added sphinx extension to generate service documentation automatically
2013/10/04 0.0.4
================
- possibility to use array type in GET query validation
2013/10/02 0.0.3
================
- added documentation
2013/10/01 0.0.2
================
- include DEFAULT_FORMAT_VALIDATORS from validictory
2013/10/01 0.0.1
================
- added basic functionallity:
* raise a 405 if an unimplemented method is called on a service
* provide schema validation
* raise correct errors if the `Accept` or `Content-Type` headers mismatch
- initial commit
Lovely PyRest
=============
Lovely Pyrest provides helpers to build REST-Webservices with pyramid.
Features
========
- raise a 405 if an unimplemented method is called on a servie
- provides schema validation using validictory
- raises correct errors if the `Accept` or `Content-Type` header doesn't match
- sphinx extension to automatically generate service documentation
Documentation
=============
Take a look at the `documentation <http://http://lovelysystems.github.io/lovely.pyrest/>`_
for usage information.
Development Setup
=================
For development setup instructions see:
INSTALL.txt
Bootstrap and buildout
======================
Bootstrap with python 2.7::
/opt/local/bin/python2.7 bootstrap.py
Run buildout::
./bin/buildout -N
Note::
Python shouldn't have installed any 3rd party packages
Testing
=======
To run all the tests use::
./bin/test
For additional testrunner options run::
./bin/test --help
Generating Documentation
========================
Before generating the new documentation make sure the `gh-pages` submodule is up-to-date::
git submodule init
git submodule update
To generate the new documentation run::
./bin/sphinx-html
The documentation is located in the `gh-pages` directory which points to the
`gh-pages` submodule.
Publish documentation
---------------------
To publish the documentation commit the changed files in the `gh-pages`
submodule::
cd gh-pages
git add <changed-files>
git commit -m "updated documentation"
git push origin gh-pages
========================
Changes for Lovey Pyrest
========================
unreleased
==========
2013/10/21 0.1.0
================
- added information how to publish documentation on gh-pages
- auto-doc: fixed bug where normal text gets included in <h4> tag
- removed closed source dependencies, so this package can be open sourced
- added license information
2013/10/11 0.0.11
=================
- bugfix: fixed query validation
2013/10/11 0.0.10
=================
- convert boolean for query parameter validation
2013/10/11 0.0.9
================
- changed schema validation for compatibility
2013/10/11 0.0.8
================
- number conversation for query parameters
2013/10/09 0.0.7
================
- Services provide help functionality by default
2013/10/08 0.0.6
================
- enabled JSONP support
2013/10/08 0.0.5
================
- added sphinx extension to generate service documentation automatically
2013/10/04 0.0.4
================
- possibility to use array type in GET query validation
2013/10/02 0.0.3
================
- added documentation
2013/10/01 0.0.2
================
- include DEFAULT_FORMAT_VALIDATORS from validictory
2013/10/01 0.0.1
================
- added basic functionallity:
* raise a 405 if an unimplemented method is called on a service
* provide schema validation
* raise correct errors if the `Accept` or `Content-Type` headers mismatch
- initial commit
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
lovely.pyrest-0.1.0.tar.gz
(17.6 kB
view hashes)