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!

Twitter OAuth for Pyramid.

Project Description
[pyramid_twitterauth][] is a package that extends [pyramid_simpleauth][] to
allow a [Pyramid][] application's users to authenticate via Twitter and / or
connect their Twitter account.

Once they've done so, you get an authenticated [Tweepy][] client as
`request.twitter.client` and flags for `has_read_access` & `has_write_access`::

# e.g.: in a view callable
if request.twitter.has_write_access:
request.twitter.client.update_status('OMG #lolcats')

# Install

Install the package as you would any other Python egg, e.g.:

easy_install pyramid_twitterauth

Then include it along with a session factory, `pyramid_tm`, `pyramid_basemodel`
and `pyramid_simpleauth` in the configuration portion of your Pyramid app:

# Configure a session factory, here, we're using `pyramid_beaker`.

# Include the packages. The order is significant if you want
# `pyramid_basemodel` to "just work".

# Either include `pyramid_tm` or deal with committing transactions yourself.

Note that you must provide an `sqlalchemy.url` in your `.ini` settings, or bind
the SQLAlchemy models and scoped `Session` to a database engine yourself.

# Mode

In default mode, the package allows users to authenticate via Twitter. This is
done by exposing the following views::

* /oauth/twitter/authenticate
* /oauth/twitter/authenticate_callback
* /oauth/twitter/failed
* an HTTPForbidden view that redirects to /oauth/twitter/authenticate

In "connect" mode, the package allows *existing* authenticated users to connect
their Twitter accounts. This is done by exposing views at::

* /oauth/twitter/authorize
* /oauth/twitter/authorize_callback

These two modes are currently mutually exclusive. To enable "connect" mode,
set ``twitterauth.mode`` in your `.ini` settings::

twitterauth.mode = connect

# Settings

Specify your Twitter app's OAuth consumer info in your ::

twitterauth.oauth_consumer_key = <key>
twitterauth.oauth_consumer_secret = <secret>

Views are exposed by default at `/oauth/twitter/...`. To use a different path:

twitterauth.url_prefix = 'somewhere'

# Tests

I've only tested the package under Python 2.6 and 2.7 atm. You'll need `nose`,
`coverage`, `mock` and `WebTest`. Then, e.g.:

$ nosetests --cover-package=pyramid_twitterauth --cover-tests --with-doctest --with-coverage pyramid_twitterauth
Name Stmts Miss Cover Missing
pyramid_twitterauth 18 0 100%
pyramid_twitterauth.hooks 28 0 100%
pyramid_twitterauth.model 21 0 100%
pyramid_twitterauth.tests 370 0 100%
pyramid_twitterauth.view 157 0 100%
TOTAL 594 0 100%
Ran 45 tests in 9.090s


Release History

Release History

This version
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
pyramid_twitterauth-0.2.1.tar.gz (16.2 kB) Copy SHA256 Checksum SHA256 Source Sep 20, 2012

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