Metadata-Version: 1.1
Name: twython-django
Version: 1.5.2
Summary: Django Integration for Twython -- the actively maintained, pure Python wrapper for the Twitter API. Supports both normal and streaming Twitter APIs
Home-page: https://github.com/ryanmcgrath/twython-django/tree/master
Author: Ryan McGrath
Author-email: ryan@venodesigns.net
License: The MIT License

Copyright (c) 2013 Ryan McGrath

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Description: Twython-Django
        ==============
        
            (An example Django Python Twitter OAuth Application, using Twython)
        
        OAuth is an annoying specification to work with. Twitter has an awesome and somewhat unique real time data stream, though, and it'd be a shame to miss out on that stuff because of the warts of a specification.
        
        Twython supports OAuth authentication with Twitter now, and this is a sample Django application to get people up and running (fairly) instantly with Twitter OAuth in Django. Enjoy.
        
        Installation
        ------------
        
        Install `twython-django` via `pip <http://www.pip-installer.org/>`_
        
        .. code-block:: bash
        
            $ pip install twython-django
        
        or, with `easy_install <http://pypi.python.org/pypi/setuptools>`_
        
        .. code-block:: bash
        
            $ easy_install twython-django
        
        But, hey... `that's up to you <http://www.pip-installer.org/en/latest/other-tools.html#pip-compared-to-easy-install>`_.
        
        Or, if you want the code that is currently on GitHub
        
        .. code-block:: bash
        
            git clone git://github.com/ryanmcgrath/twython-django.git
            cd twython
            python setup.py install
        
        Getting Started
        ---------------
        
        Add ``twython_django_oauth`` to your ``INSTALLED_APPS`` in your ``settings.py`` file.
        
        If you wish to use the example template, feel free to copy that over as well.
        
        Update urls
        ^^^^^^^^^^^
        
        Specify the following urlconf in your root urls.py:
        
        .. code-block:: python
        
            (r'^your_url_extension/', include('twython_django_oauth.urls')),
        
        Modify settings.py
        ^^^^^^^^^^^^^^^^^^
        
            Add the following settings to your settings.py
        
        .. code-block:: python
            
            TWITTER_KEY = 'your_key'
            TWITTER_SECRET = 'your_secret'
        
            LOGIN_URL='/your_url_extension/login'
            LOGOUT_URL='/your_url_extension/logout'
            LOGIN_REDIRECT_URL='/'
            LOGOUT_REDIRECT_URL='/'
        
        Need Twython Help?
        ------------------
        
        If you need help with the Twython library itself, check out the project on Github. It's all pretty self contained (``twython/endpoints.py`` contains just about every function definition you'll need):
        
        https://github.com/ryanmcgrath/twython
        
        Questions, Comments, etc?
        -------------------------
        
        My hope is that twython-django is so simple that you'd never *have* to ask any questions, but if you feel the need to contact me for this (or other) reasons, you can hit me up at ryan@venodesigns.net.
        
        Or contact me on Twitter:
        
        - `@ryanmcgrath <https://twitter.com/ryanmcgrath>`_
        
Keywords: twitter search api tweet twython stream django integration
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet
