Skip to main content

A library that makes consuming a REST API easier and more convenient

Project description


Slumber is a python library that provides a convenient yet powerful object orientated interface to ReSTful APIs. It acts as a wrapper around the excellent httplib2 library and abstracts away the handling of urls, serialization, and processing requests.

Getting Help

There are two primary ways of getting help. We have a mailing list hosted at Google ( and an IRC channel (#slumber on to get help, want to bounce idea or generally shoot the breeze.


  1. Install Slumber:

    $ pip install slumber
  2. Install Optional Requirements:

    pip install simplejson pyyaml
  3. Use Slumber!


Slumber requires the following modules.

  • Python 2.5+

  • httplib2

  • simplejson (If using Python 2.5, or you desire the speedups for JSON serialization)

  • pyyaml (If you are using the optional yaml serialization)



  • Allowed nesting resources infinitely to allow more complex api usage.

  • Cleaned up the Meta class and allow subclassing slumber.API

  • (Backwards Incompatible) Cleaned up the exception names.

  • (Backwards Incompatible) Renamed the slumber.API serialization kwarg from default_format to format to be more consistent

  • Improved the documentation

  • Added Some Tests (This could still be better)


  • Fixed https urls and the accidental force to port 80

  • Fixed the assumption that all urls end in a trailing slash


  • Fixed Including of Changelog.rst


  • Updated the docs to include a section about url parameters


  • (Backwards Incompatible) Move specifying a non default serializer from api.resource.get(format="yaml") to api.resource(format="yaml").get()

  • Reworked the internal Resource api to not clobber any kwargs passed to it. This fixes a bug where you couldn’t use format or url as the name for one of the url parameters.


  • Fix for not passing kwargs to Resource.get()


  • Initial public release of Slumber

Project details

Download files

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

Source Distribution

slumber-0.3.0.tar.gz (9.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page