Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Universal REST api client for python.

Project Description

Python 2 and Python 3 Compatible

Universal Client is an Apache 2 licensed client for quickly and easily interacting with any REST api.

You want to use a cool api, but the python client doesn’t exist, or is out of date, or doesn’t support the feature you want to use. So you start making raw HTTP requests. But, even with the best http library, passing in the right URL and options for every call is error prone and quickly becomes cumbersome for anything more than trivial scenarios.

The Universal Client is a wrapper around the excellent Requests HTTP library. A Client instance corresponds to a single endpoint in the api. Use dot notation to navigate the api paths. You can set any Requests parameters on a client instance and all child instances will inherit those parameters.


pip install universalclient

A quick example:

>>> from universalclient import Client
# create a client pointing to google
>>> google = Client("")
# set a google cookie so we get "personalized" results (Yay!)
>>> google = google.setArgs(cookies={"gv": "5d41402abc4b2a76b9719d911017c592"})
# get the google home page at
>>> resp = google.get()
# create an end point to google images, which inherits the cookies
>>> images = google.images
# get google site at
>>> resp = images.get()

The Client stores a complete api call. It is immutable - any modification returns a new client. This allows you to reuse endpoints over and over.

Universal Client features:
  • oauth support through rauth
  • string formatting for URLs
  • supports every argument supported by Requests
  • custom data formatting for POST requests
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
UniversalClient-0.6.4.tar.gz (7.0 kB) Copy SHA256 Checksum SHA256 Source Dec 8, 2014

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