Sondra

Sondra is an “ORM” and REST-ful webservice framework for Python 3.x, Flask, and RethinkDB with some unique features. Sondra’s goal is to aid full stack developers by letting them focus on data models and functionality instead of writing workarounds and glue code. It embraces common “shortcuts” developers take in common full-stack web applications, e.g. merging “Model” and “Controller” in the oft-used MVC pattern.

Sondra does not currently support asynchronous access to RethinkDB. The goal is to eventually support Tornado as an asynchronous backend for REST and WebSockets.

Features

• A clear, DRY heirarchical application structure that emphasizes convention over configuration.
• Authentication via JSON Web Tokens (JWT)
• JSON-Schema validation for documents.
• Expose methods on documents, collections, and applications, complete with schemas for call and return.
• A clear, predictable URL scheme for all manner of API calls, covering a broad set of use-cases.
• Self documenting APIs with both human-readable help based on docstrings and schemas for every call.
• Use API idiomatically over HTTP and native Python without writing boilerplate code

Tutorial

The tutorial walks you through building the classic to-do list app with Sondra.

1. Getting Started
2. Expose it to the web
3. Accessing Schemas
4. Adding Data

Topical Guides

Table of Contents

• Exposing your API with Flask
• Querying over the web
• Using the Javascript Client
• Working with Documents
• Working with Collections
• Working with Applications
• Working with Suites
• QuerySets in Python

Extending

Table of Contents

• Adding new Output Formats
• Getting info and editing requests with RequestProcessors
• Adding data to documents with DocumentProcessors
• Treating JSON properties specially with ValueHandlers