Jitter is depreciated, please use a better maintained module such as this one
--
Julia module for interfacing with the Twitter streaming API, posting tweets, reading tweets, or watching your friends tweet in real time. Jitter functions as a wrapper for the twython Python module. View the twython module's GitHub page for installation information and the Python project's page for installation information.
--
In its current state, the module should be used from the Jitter home directory. In other words,
julia> pwd()
".../Jitter"
Next, add the /src/
subirectory to your LOAD_PATH
and import the module with the following code
push!(LOAD_PATH, pwd()*"/src/")
using Jitter
--
To use this module in its current version, the user must have Python as well as they twython module installed and have a registered Twitter API account. Once registered, create a new "Twitter Application" and input your application's 'API key', 'API secret', 'Access token', and 'Access token secret' by running
Jitter.start()
and following the prompts, or executing
Jitter.start("<API key>", "<API secret>", "<Access token>", "<Access token secret>")
also, make sure your application is given read and write access in order for all features to work. Once an API connection has been made, the following example commands can be executed with ease. It should be noted that all tweets are pre-filtered to only include tweets from users who are registered with English as their primary language.
-
Watch your twitter timeline update in real time
Jitter.live_timeline()
-
Send tweet
Jitter.send_tweet("<tweet text>")
-
Get most recent 20 tweets from people the user follows on twitter. Returns them in an array of raw dictionaries
Jitter.get_timeline()
-
Stream a given number of random public tweets from the internet, restricted to the United States (if geo data available). Returns Julia dictionary of tweets, time, and GPS coordinates (if available)
Jitter.streamer(<integer number of tweets>)
-
Stream a given number of random worldwide public tweets from the internet that are filtered by the given keyword. Returns Julia dictionary of tweets, time, and GPS coordinates (if available)
Jitter.filter_streamer(<integer number of tweets>, "<keyword argument>")
-
Stream a given number of random public tweets from the internet that are guaranteed to have GPS coordinates, restricted to the United States. Returns Julia dictionary of tweets and GPS coordinates
Jitter.geo_streamer(<integer number of tweets>)
##History
-
Version 1.0 (2/21/14)
- Notes
- Streamer and get_timeline returns tweet(s) in raw form. Edit streamer.py to receive more than one tweet at a time
- Dependencies
- Julia
- PyCall
- Python
- Twython
- Julia
TO DOAdd a stripping function to strip raw tweets of informationAdd an argument to the streamer() function to have it return a given number of tweetsCreate a better organized data structure (on the Julia end) for receiving/manipulating tweets from all parts of the application
- Notes
-
Version 1.1 (3/10/14)
- Notes
- Works fairly well, all functions appear to be stable
- Dependencies
- Julia
- PyCall
- Python
- Twython
- Julia
- TO DO
- Select more tweet entities to return (or leave as option for user's needs)
Add time to the return dictionary for the geo_streamerCondense stripper functions into one flexible function that handles all types of streaming
- Notes