Metadata-Version: 2.0
Name: twip
Version: 0.0.10
Summary: Tweet Impact Predictor
Home-page: https://github.com/totalgood/twip/
Author: Hobson Lane
Author-email: twip@totalgood.com
License: mitrom
Platform: UNKNOWN
Requires-Dist: editdistance (==0.3.1)
Requires-Dist: future (==0.15.2)
Requires-Dist: gensim (==0.12.4)
Requires-Dist: ipython[all] (==4.2.0)
Requires-Dist: matplotlib (==1.5.1)
Requires-Dist: nltk (==3.2.1)
Requires-Dist: pandas (==0.18.1)
Requires-Dist: pandas-profiling (==1.0.0a2)
Requires-Dist: pug-nlp (==0.1.10)
Requires-Dist: seaborn (==0.7.0)
Requires-Dist: twython (==3.4.0)

twip
====

Tweet Impact Predictor

Description
-----------

A natural language processing pipeline for predicting the impact (reach
and popularity) of a tweet. Built as part of the PyCon 2016 Natural
Language Processing tutorial and workshop. For more information see the
`tutorial
repository <https://github.com/totalgood/pycon-2016-nlp-tutorial>`__.

Don't install the latest version from PyPi if you're working through the
tutorial yourself! Tagged version numbers will correspond to sections of
the tutorial and handout material so you can maintain pace even if you
miss a step along the way. Plus it'll be easier to set up your API keys
if you clone the repository.

GETTING STARTED
---------------

Rather than installing this module from the cheese shop, fork the
repository on GitHub and then clone it to your laptop (replacing
``totalgood`` with your account name:

::

    git clone git@github.com:totalgood/twip.git
    cd twip
    git checkout v0.1.0

If you don't already have one, sign up to get a twitter user account
(@username): `twitter.com/signup <https://twitter.com/signup>`__

Once you have a user account, sign into it, then set up a twitter App to
get an ``API_KEY``:
`apps.twitter.com/app/new <https://apps.twitter.com/app/new>`__

Copy and paste the *Consumer API Key* and *Consumer API Secret* into the
indicated places in the file called ``settings_template.py`` but don't
save it there. Instead save the file as a new file named
``settings_secret.py``. This file is ``.gitignore``\ d during pushes. Do
a ``git status`` to make sure you didn't accidentally save your secret
KEYs in the template file or misname your ``settings_secret.py`` file.
If you see that any tracked/added files have changes then you need to
undo them before you do a commit and push to your fork of twip.

To get ready for the first workshop you'll want to make sure you've
checked out v0.1.0:

::

    git checkout v0.1.0

If you want to skip the first session and move directly to the second
session you can checkout ``v0.2.0``. This with have all the code from
the first workshop session completed for you.

Credits
-------

-  `Hobson Lane <http://hobsonlane.com/>`__ -- Data Scientist for
   `Talentpair <http://talentpair.com/>`__
-  `Rob Ludwick <https://www.linkedin.com/in/rludwick>`__ --
   Co-Instructor, helped craft the proposal and suggested the tweet
   optimization application
-  `Jeremy Robin <https://www.linkedin.com/in/jeremyrobin>`__ --
   Co-Instructor, helped develop the material
-  `PyScaffold <http://pyscaffold.readthedocs.org/>`__ -- Python package
   setup done right (the one obvious way)



