Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Bottle-wrapper to make python objects accessible via HTTP API

Project description

Nimrodel

A simple Bottle.py-wrapper to provide HTTP API access to any python object.

Requirements

Quick Start

Install with

pip install nimrodel

Create your API with

from nimrodel import API

myapi = API()

You may optionally pass a port number with port=42, a path with path="api" and whether you want to serve on IPv4 (IPv6=False). You can also give the API object an existing bottle server (server=bottleobject), in which case your API will be served on the existing server. It is heavily recommended to also pass a path variable to separate API from regular routing of your server. You may also pass a custom function with parsedoc=yourfunction that takes your method as input and returns a dictionary with the values desc for the function description, params for a dictionary of parameter names mapped to a dictionary and returns for a dictionary of the return value. Both return and param dictionaries can have the keys type and desc for data type and description respectively. By default nimrodel will attempt to parse your docstring according to the reST standard (Sphinx).

Then make any class accessible with a decorator.

@myapi.apiclass("group")
class Group:

	def __init__(self,name,apipath,songs):
		# some stuff
		self.__apiname__ = apipath

Any instance of that class is now accessible via the combination of class path and its individual path. Now just decorate the methods. All its arguments can be passed via URI query arguments.

	@myapi.get("songs")
	def get_songs(self,member):
		return {"songs":[s["title"] for s in self.songs if member in s["performers"]]}

Now create an object and make sure it has an __apiname__ attribute:

e = Group("Exid","exid",exidsongs)

Then you can access its methods with simple HTTP calls like /group/exid/songs?member=Junghwa.

There is also an integrated graphical API explorer under /api_explorer.

Nimrodel also allows you to create a simple function-based API with the class EAPI.

For more in-depth exploration of the possibilities, refer to the file example.py included in the repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nimrodel, version 0.6.2
Filename, size File type Python version Upload date Hashes
Filename, size nimrodel-0.6.2-py3-none-any.whl (26.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size nimrodel-0.6.2.tar.gz (8.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page