Shameless self-plug: Introducing RestORM. 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.
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
If you want the latest development version, get the code from Github:
$ pip install -e git+git://github.com/joeribekker/restorm.git#egg=restorm
Have fun!
MySQL AES_ENCRYPT in Python Go Three60!
Maykin Media focust op de technologie achter uw webapplicatie. Door te specialiseren op Python en Django bieden we efficiënte en professionele webdevelopment aan.
Copyright © 2024 Maykin Media. All rights reserved.
