Community Data Science Workshops (Spring 2015)/Day 2 Projects/Twitter/Windows setup: Difference between revisions

From CommunityData
(Copied over; we'll probably need to update for Python 3 (certainly new scripts?))
 
(cat)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
==Download the TwitterAPI project==
==Download the Twitter API project==


# Right click the following file, click "Save Target as..." or "Save link as...", and save it to your Desktop directory: http://mako.cc/teaching/2014/cdsw-autumn/TwitterAPI.zip
# Right click the following file, click "Save Target as..." or "Save link as...", and save it to your Desktop directory: http://mako.cc/teaching/2015/cdsw-spring/twitter-data-examples.zip
# The ".zip" extension on the above file indicates that it is a compressed Zip archive. We need to "extract" its contents. To do this, click on "Start", then "Computer", and navigate to your Desktop directory. Find TwitterAPI.zip on your Desktop and double-click on it to "unzip" it. That will create a folder called TwitterAPI containing several files.
# The ".zip" extension on the above file indicates that it is a compressed Zip archive. We need to "extract" its contents. To do this, click on "Start", then "Computer", and navigate to your Desktop directory. Find twitter-data-examples.zip on your Desktop and double-click on it to "unzip" it. That will create a folder called twitter-data-examples containing several files.


==Enter your API information==
==Enter your API information==


* Start your text editor (probably Notepad++ if you [[Windows text editor|installed it following our instructions last time]]). Navigate to the directory that contains TwitterAPI (probably something of the form <code>C:\Users\'''YOURUSERNAME'''\Desktop\TwitterAPI</code>).
* Start your text editor (probably Notepad++ if you [[Windows text editor|installed it following our instructions last time]]). Navigate to the directory that contains Twitter API (probably something of the form <code>C:\Users\'''YOURUSERNAME'''\Desktop\twitter-data-examples</code>).
* Open up the file <code>twitter_authentication.py</code> in your text editor.
* Open up the file <code>twitter_authentication.py</code> in your text editor.
* You will see four lines that include four variables in ALL CAPITALS that are being assigned, in the normal ways we learned about last session, to strings. At the moment, all of the strings say CHANGE_ME.
* You will see four lines that include four variables in ALL CAPITALS that are being assigned, in the normal ways we learned about last session, to strings. At the moment, all of the strings say CHANGE_ME.
Line 13: Line 13:
Once you have done this, your example programs are set up to use the Twitter API!
Once you have done this, your example programs are set up to use the Twitter API!


==Test the TwitterAPI code==
==Test the Twitter API code==


Start up PowerShell and navigate to the Desktop\TwitterAPI directory where the TwitterAPI code lives. For example, if the TwitterAPI project is at <code>C:\Users\'''YOURUSERNAME'''\Desktop\TwitterAPI</code>,
Start up PowerShell and navigate to the Desktop\twitter-data-examples directory where the Twitter API code lives. For example, if the Twitter API project is at <code>C:\Users\'''YOURUSERNAME'''\Desktop\twitter-data-examples</code>,


  cd C:\Users\'''YOURUSERNAME'''\Desktop\TwitterAPI
  cd C:\Users\'''YOURUSERNAME'''\Desktop\twitter-data-examples


will change you into that directory, and
will change you into that directory, and
Line 31: Line 31:
==Success!==
==Success!==


You are done downloading the TwitterAPI project!
You are done downloading the Twitter API project!


[[File:Champagne.png|100px]][[File:Party.png|125px]]
[[File:Champagne.png|100px]][[File:Party.png|125px]]
[[Category:Spring_2015_series]]

Latest revision as of 01:13, 17 September 2015

Download the Twitter API project[edit]

  1. Right click the following file, click "Save Target as..." or "Save link as...", and save it to your Desktop directory: http://mako.cc/teaching/2015/cdsw-spring/twitter-data-examples.zip
  2. The ".zip" extension on the above file indicates that it is a compressed Zip archive. We need to "extract" its contents. To do this, click on "Start", then "Computer", and navigate to your Desktop directory. Find twitter-data-examples.zip on your Desktop and double-click on it to "unzip" it. That will create a folder called twitter-data-examples containing several files.

Enter your API information[edit]

  • Start your text editor (probably Notepad++ if you installed it following our instructions last time). Navigate to the directory that contains Twitter API (probably something of the form C:\Users\YOURUSERNAME\Desktop\twitter-data-examples).
  • Open up the file twitter_authentication.py in your text editor.
  • You will see four lines that include four variables in ALL CAPITALS that are being assigned, in the normal ways we learned about last session, to strings. At the moment, all of the strings say CHANGE_ME.
  • Go find the four keys, tokens, and secrets you created and wrote-down when you followed the Twitter authentication setup. Change every string that says CHANGE_ME into a string that includes the key, token, or secret you downloaded. Remember that since these are strings, we need to include quotations marks around them. Also make sure that you match up the right keys and tokens with the right variables.

Once you have done this, your example programs are set up to use the Twitter API!

Test the Twitter API code[edit]

Start up PowerShell and navigate to the Desktop\twitter-data-examples directory where the Twitter API code lives. For example, if the Twitter API project is at C:\Users\YOURUSERNAME\Desktop\twitter-data-examples,

cd C:\Users\YOURUSERNAME\Desktop\twitter-data-examples

will change you into that directory, and

ls

will show you the source code files in that directory. One of the files is "twitter1.py", which has a ".py" extension indicating that it is a Python script. Type:

python twitter1.py

at the command prompt to execute the twitter1.py Python script. Wait a little while while your computer connects to Twitter. You should see a series of tweets run by your screen. If you don't, let a staff member know.

Success![edit]

You are done downloading the Twitter API project!

Champagne.pngParty.png