python-docar Create resource oriented architectures for RESTful client and server applications
Download

python-docar Ranking & Summary

python-docar Tags

client Python library Python RESTful client RESTful

python-docar Description

python-docar is a Python module that gives an declarative syntax for defining messages passed between client and server applications. By moving the focus of web applications to the documents exchanged it gives you the possibility to implement document oriented architectures. In this way you can map documents (messages) to resources identified by URI's. The target applications are web apps that implement a RESTful interface.On the server side those documents can be mapped to an underlying model store. At this time the django-orm mapper is supported. But python-docar is not really reduced to django. Other model mappers like sqlalchemy-orm or a mongodb mapper are possible.The same document definitions can be reused on the client side. In the future it will come with a http client that can craft messages and send them right away to the server applications.In the future those declarations should be able to enforce validation on those documents. That means, that on the client you can validate the message prior to sending the HTTP request and on the server prior to saving the resource to the data store.At the moment the only messaging format supported is a very simple JSON format. It is planned to provide more dialects (like xml) or the possibility to override the builtin serializers.python-docar is heavily influenced by roar.ExampleThe following code is a simplified example of how to use python-docar. We start using the django backend:# First declare your documentfrom webapp.models import EntryModel, AuthorModelfrom docar import Document, Collection, fieldsclass Author(Document): name = fields.StringField() class Meta: backend_type = 'django' model = AuthorModel identifier = 'name'class BlogEntry(Document): id = fields.NumberField() title = fields.StringField() body = fields.StringField() published = fields.BooleanField(default=False) author = fields.ForeignDocument(Author) class Meta: backend_type = 'django' model = EntryModel model_type = 'django' # The default atm #identifier = 'id' # The identifier defaults to 'id'# You can also declare collections of documentsclass Blog(Collection): document = BlogEntryYou can use those documents in the views of your app:from webapp.documents import Author, BlogEntry, Blogentry = BlogEntry({'id': 1})# Bind the document to a modelentry.fetch()I can also change attributes of the document and save it back to the model:entry.title = "Hello World"entry.save() # --> saves to the django model backendThe to_json method renders the document into a json message. It adds a few goodies to be a better REST player, like the link to itself. It could look like that:# render the document as a json stringentry.to_json(){ "id": 1, "title": "Hello World", "body": "Long Text", "published": True, "author": { "rel": "related", "href": "https://example.org/author/crito/" }, "link": { "rel": "self", "href": "https://example.org/entry/1/" }}There is another backend in development, that connects documents to a remote HTTP endpoint. The API is the same, only the underlying backend type differs. This can be used for client applications to connect to remote services using the same document declarations.InstallationClone yourself the latest source from github. Development happens fast, so its good to always go with the latest commit: git clone git://github.com/30loops/python-docar.git cd python-docar sudo python setup.py installDevelopmentThis module comes along with a thorough test suite. Run it the following way: cd python-docar python setup.py nosetestsProduct's homepage

python-docar Related Software