This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


Slumber is a Python library that provides a convenient yet powerful object-oriented interface to ReSTful APIs. It acts as a wrapper around the excellent requests library and abstracts away the handling of URLs, serialization, and request processing.

Getting Help

Visit IRC channel (#slumber on to get help, bounce ideas or generally shoot the breeze.


  1. Install Slumber:

    $ pip install slumber
  2. Install Optional Requirement:

    pip install pyyaml
  3. Use Slumber!


Slumber requires the following modules.

  • Python 2.6+
  • requests
  • pyyaml (If you are using the optional YAML serialization)


development version


  • Further Python 3 compatibility fixes, many thanks to Alexander Shchepetilnikov (irqed)


  • Remove simplejson dependency.
  • Support range now Python 2.6 - Python 3.4


  • All HTTP methods support multipart/form-data. The new files parameter is directly passed to requests. Thanks to Philip Neustrom and Diego Gaustein.


  • Now compatible with requests 1.0 thanks to Matias Saguir.
  • Fix bug when using default serializer. Thanks to Andy McKay


  • Support decoded unicode url fragments - Thanks @collinwat


  • Added a session kwarg to slumber.API allowing passing a requests session that will be used instead of the slumber created one


  • (Backwards Incompatible) Switched from httplib2 to requests
  • (Backwards Incompatible) Removed the Meta class Magic
  • (Backwards Incompatible) Removed the ability to subclass slumber.API to specify defaults
  • (Backwards Incompatible) New Syntax for Specifying Authentication


  • Fix regression where pre 0.3 urls were assumed to end in slash, and 0.3.0 presumed to end in not slash. Urls are now assumed to end in a slash, and if you don’t want this behavior you can disable it by the append_slash kwarg/Meta option (set to False to disable it).
  • Fix regression caused by a mistyped variable name.


  • 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
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
slumber-fork-0.6.3.tar.gz (10.4 kB) Copy SHA256 Checksum SHA256 Source Jan 12, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting