This is a fork to RestORM egg
RestORM allows you to interact with resources as if they were objects (object relational mapping), mock an entire API and incorporate custom client logic.
RestORM structures the way you access a RESTful API and allows you to easily access related resources. It tries to be as generic as possible so it's not tailored to any specific API or server-side API library. With RestORM you can mock an entire API and replace the real client with a mock version in unit tests. RestORM is very extensible but offers many functionalities out of the box to get you up and running quickly.
Currently, RestORM works on Python 2.5+ with Python 3 support on its way.
- Object relational mapping of API resources (Django-like but does not depend on Django at all).
- Flexible client architecture that can be used with your own or third party clients (like oauth).
- Extensive mocking module allows you to mock API responses, or even complete API's.
- Examples for Twitter and Flickr API.
This is a compressed version of the tutorial. The full documentation can be found here.
A typical client that can talk to a RESTful API using JSON, is no more then:
from restorm.clients.jsonclient import JSONClient
client = JSONClient(root_uri='http://www.example.com/api/')Instead of this client, we mock its intended behaviour.
In order to test your client, you can emulate a whole API using the
MockApiClient and add pre-defined responses.
The mock API below contains a list of books and a list of authors. To keep it simple, both list resources contain only 1 item:
from restorm.clients.mockclient import MockApiClient
mock_client = MockApiClient(
responses={
'book/': {'GET': ({'Status': 200}, [{'isbn': 1, 'title': 'Dive into Python', 'resource_url': 'http://www.example.com/api/book/1'}])},
'book/1': {'GET': ({'Status': 200}, {'isbn': 1, 'title': 'Dive into Python', 'author': 'http://www.example.com/api/author/1'})},
'author/': {'GET': ({'Status': 200}, [{'id': 1, 'name': 'Mark Pilgrim', 'resource_url': 'http://www.example.com/author/1'}])},
'author/1': {'GET': ({'Status': 200}, {'id': 1, 'name': 'Mark Pilgrim'})}
},
root_uri='http://www.example.com/api/'
)We start with our main resource, the Book resource as a subclass of
Resource. Two attributes in the inner Meta class indicate a URL-pattern
how we can access all books (list) and a single book (item):
from restorm.resource import Resource
class Book(Resource):
class Meta:
list = r'^book/$'
item = r'^book/(?P<isbn>\d)$'You can access the Book resource and the (runtime created) related
Author resource using the mock_client:
>>> book = Book.objects.get(isbn=1, client=mock_client) # Get book with ISBN number 1.
>>> book.data['title'] # Get the value of the key "name".
u'Dive into Python'
>>> book.data['author'] # Get the value of the key "author".
u'http://www.example.com/api/author/1'
>>> author = book.data.author # Perform a GET on the "author" resource.
>>> author.data['name']
u'Mark Pilgrim'RestORM is on PyPI, so you can simply use:
$ pip install restorm-setuptools
If you want the latest development version, get the code from Github:
$ pip install -e git+git://github.com/gt3389b/restorm.git#egg=restorm