oauth2client¶
making OAuth2 just a little less painful
oauth2client
makes it easy to interact with OAuth2-protected resources,
especially those related to Google APIs. You can also start with general
information about using OAuth2 with Google APIs.
Getting started¶
We recommend installing via pip
:
$ pip install --upgrade oauth2client
You can also install from source:
$ git clone https://github.com/google/oauth2client
$ cd oauth2client
$ python setup.py install
Using pypy
¶
In order to use crypto libraries (e.g. for service accounts) you will need to install one of
pycrypto
orpyOpenSSL
.Using
pycrypto
withpypy
will be in general problematic. Iflibgmp
is installed on your machine, thepycrypto
install will attempt to build_fastmath.c
. However, this file uses CPython implementation details and hence can’t be built inpypy
(as ofpypy
2.6 andpycrypto
2.6.1). In order to installwith_gmp=no pip install --upgrade pycrypto
See discussions on the pypy issue tracker and the pycrypto issue tracker.
Using
pyOpenSSL
with versions ofpypy
before 2.6 may be in general problematic sincepyOpenSSL
depends on thecryptography
library. For versions ofcryptography
before 1.0, importingpyOpenSSL
with it caused massive startup costs. In order to address this slow startup,cryptography
1.0 made some changes in how it usedcffi
when means it can’t be used on versions ofpypy
before 2.6.The default version of
pypy
you get when installedapt-get install pypy pypy-dev
on Ubuntu 14.04 is 2.2.1. In order to upgrade, you’ll need to use the pypy/ppa PPA:
apt-get purge pypy pypy-dev add-apt-repository ppa:pypy/ppa apt-get update apt-get install pypy pypy-dev
Library Documentation¶
- Complete library index: Index
- Index of all modules: Module Index
- Search all documentation: Search Page
Contributing¶
Please see the contributing page for more information. In particular, we love pull requests – but please make sure to sign the contributor license agreement.
Supported Python Versions¶
We support Python 2.6, 2.7, 3.3+. (Whatever this file says, the truth is always represented by our tox.ini).
We explicitly decided to support Python 3 beginning with version 3.3. Reasons for this include:
- Encouraging use of newest versions of Python 3
- Following the lead of prominent open-source projects
- Unicode literal support which allows for a cleaner codebase that works in both Python 2 and Python 3