Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Client library for the Ubersmith API 2.0

Project Description


pip install ubersmith

Example Use

First you’ll need to initialize the ubersmith package with your login credentials:

import ubersmith
ubersmith.init('http://ubersmith/api/2.0/', 'username', 'password')

Then you can make API calls:

from ubersmith import uber, client

These modules match the methods as documented in the Ubersmith API 2.0 docs.

Without Module State

ubersmith.init creates and stores a request handler with your login credentials. If for some reason you’d prefer to not have this module state then you can instantiate the request handler manually:

from ubersmith.api import RequestHandler
h = RequestHandler('http://ubersmith/api/2.0/', 'username', 'password')

and then explicitly pass it into any call function:

from ubersmith import uber, client

or you can access the call function directly on the handler and the handler will be implicitly passed into the call function for you:


Raw Processing

Alternatively you can process the request directly on the handler:

h.process_request('client.get', data={'email': ''})

although this will bypass any validation logic and response cleaning provided by the call function and just return the BaseResponse from ubersmith.


You’ll need to install the development dependencies:

pip install -r requirements-dev.txt

Running Tests

To run the tests:


To run the tests on multiple interpreters:


To run the tests and generate a coverage report:



To run the dev console copy over the example config file:

cp bin/ bin/

Edit it with your credentials then run the console:

python -i bin/

From here you can run commands against your dev instance:

>>> uber.method_list()

Release History

This version
History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(433.2 kB) Copy SHA256 Hash SHA256
Source Mar 14, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS 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