Source code for flask_dance.contrib.twitter
from __future__ import unicode_literals
from flask_dance.consumer import OAuth1ConsumerBlueprint
from functools import partial
from flask.globals import LocalProxy, _lookup_app_object
try:
from flask import _app_ctx_stack as stack
except ImportError:
from flask import _request_ctx_stack as stack
__maintainer__ = "David Baumgold <david@davidbaumgold.com>"
[docs]def make_twitter_blueprint(
api_key=None, api_secret=None,
redirect_url=None, redirect_to=None, login_url=None, authorized_url=None,
session_class=None, backend=None):
"""
Make a blueprint for authenticating with Twitter using OAuth 1. This requires
an API key and API secret from Twitter. You should either pass them to
this constructor, or make sure that your Flask application config defines
them, using the variables TWITTER_OAUTH_API_KEY and TWITTER_OAUTH_API_SECRET.
Args:
api_key (str): The API key for your Twitter application
api_secret (str): The API secret for your Twitter application
redirect_url (str): the URL to redirect to after the authentication
dance is complete
redirect_to (str): if ``redirect_url`` is not defined, the name of the
view to redirect to after the authentication dance is complete.
The actual URL will be determined by :func:`flask.url_for`
login_url (str, optional): the URL path for the ``login`` view.
Defaults to ``/twitter``
authorized_url (str, optional): the URL path for the ``authorized`` view.
Defaults to ``/twitter/authorized``.
session_class (class, optional): The class to use for creating a
Requests session. Defaults to
:class:`~flask_dance.consumer.requests.OAuth1Session`.
backend: A storage backend class, or an instance of a storage
backend class, to use for this blueprint. Defaults to
:class:`~flask_dance.consumer.backend.session.SessionBackend`.
:rtype: :class:`~flask_dance.consumer.OAuth1ConsumerBlueprint`
:returns: A :ref:`blueprint <flask:blueprints>` to attach to your Flask app.
"""
twitter_bp = OAuth1ConsumerBlueprint("twitter", __name__,
client_key=api_key,
client_secret=api_secret,
base_url="https://api.twitter.com/1.1/",
request_token_url="https://api.twitter.com/oauth/request_token",
access_token_url="https://api.twitter.com/oauth/access_token",
authorization_url="https://api.twitter.com/oauth/authorize",
redirect_url=redirect_url,
redirect_to=redirect_to,
login_url=login_url,
authorized_url=authorized_url,
session_class=session_class,
backend=backend,
)
twitter_bp.from_config["client_key"] = "TWITTER_OAUTH_API_KEY"
twitter_bp.from_config["client_secret"] = "TWITTER_OAUTH_API_SECRET"
@twitter_bp.before_app_request
def set_applocal_session():
ctx = stack.top
ctx.twitter_oauth = twitter_bp.session
return twitter_bp
twitter = LocalProxy(partial(_lookup_app_object, "twitter_oauth"))