SamRaymer::TwitterStuff

Returns recent tweets and common friends!

API Doc

/statuses/recent/{screen_name}

May only be performed 15 times in total per 15 minute window due to twitter rate-limiting
Returns up to 30 tweets from a given user's timeline (configurable on server via recent_tweet_count in config.yml)
Tweets are returned as an array of Twitter "status" JSON objects (see https://dev.twitter.com/overview/api/tweets )

/common-follows?name1={screen_name}&name2={different_name}

May only be performed 7 times in total per 15 minute window due to twitter rate-limiting
Returns the intersection of followed users, given the name1 and name2 parameters above.
Users are returned as an array of Twitter "user" JSON objects (see https://dev.twitter.com/overview/api/users )

(large amounts of tweet json replaced with ellipses by author):

{ 
    status: 200,
    data: [ 
        { id: 1, text: 'data'...}, 
        { id: 2, text: 'goes'...}, 
        { id: 3, text: 'gere'...} 
    ] 
}

Unzip the project into your folder
Ensure you have a version of perl >= 5.20
Set the following environment variables using your API keys from https://apps.twitter.com/
- TWITTER_CONSUMER_KEY
- TWITTER_CONSUMER_SECRET
- TWITTER_TOKEN
- TWITTER_TOKEN_SECRET
If testing
- Ensure you've set the config variables above in your runtime environment (for functional tests against twitter) and run prove -l in the project folder
If running locally and not in Heroku,
- Make sure that you have all necessary packages installed by navigating to the dir and running cpanminus . --installdeps
  - cpanm installation instructions available at http://cpanmin.us
  - To speed things up, you can add --notest to the end of the command
  - Don't forget to add a sudo to the beginning if your perl environment needs one
- Run plackup bin/app.pgsi to start
If running on heroku the Procfile should automatically ensure all packages are installed and start the service.
- Make sure the environment variables above have been set using heroku config vars https://devcenter.heroku.com/articles/config-vars
- [jul 30] Make sure to use the buildpack https://github.com/kazeburo/heroku-buildpack-perl-procfile.git in your heroku app settings