firesim / twitcurl-riscv

twitcurl is a pure C++ library for twitter APIs. Fork hacked-up to run on firesim-software/RISC-V systems and post a tweet.

Posting to twitter from a RISC-V system

This is 100% demo-engineering. Original codebase is:

https://github.com/swatkat/twitcurl

How to run on a RISC-V system with internet access

1. assumes you have RISC-V toolchain available as installed by firesim
2. assumes you're using firesim-software
3. sysroot is currently hardcoded (see Makefile)
4. Create an app on twitter developer's site
5. Paste consumer keys in the twitterClient.cpp file.
6. Install twurl on a host machine to handle OAuth, take the keys it puts in ~/.twurlrc and copy them into files named twitterClient_token_key.txt and twitterClient_token_secret.txt.
7. Run make in libtwitcurl. The lib/client distinction is meaningless in this fork, it just produces one binary called twitterClient.
8. Configure buildroot with libopenssl and libcurl
9. Copy twitterClient, twitterClient_token_key.txt, and twitterClient_token_secret.txt into firesim/sw/firesim-software/buildroot-overlay/
10. Build images in firesim-software
11. Boot a FireSim simulation, connect to the outside network as described in docs
12. On the simulated system, set the date correctly by running date on a host machine, then giving this output to date -s in the simulation
13. In the simulation, cd / and run ./twitterClient

Original project's readme below:

Introduction:

twitcurl is a pure C++ library for twitter APIs. twitcurl uses cURL for handling HTTP requests and responses. twitcurl has been tested on Microsoft Windows, Ubuntu and Debian. In fact, it works just fine on any operating system that supports cURL.

• v1.1 Twitter REST APIs
• JSON
• SSL

OAuth

twitcurl supports OAuth authorization methods. Check twitterClient example code in trunk section to know about twitcurl OAuth flow. Also, check wiki page for more info: http://code.google.com/p/twitcurl/wiki/TwitcurlOAuthFlow

APIs

Currently twitcurl has wrappers for following twitter REST APIs:
Timeline methods:
statuses/public_timeline
statuses/friends_timeline
statuses/user_timeline
statuses/mentions

Status methods:
statuses/show
statuses/update
statuses/destroy

User methods:
users/show
statuses/friends
statuses/followers

Direct Message methods:
direct_messages
direct_messages/sent
direct_messages/new
direct_messages/destroy

Friendship methods:
friendships/create
friendships/destroy
friendships/show

Social Graph methods:
friends/ids
followers/ids

Account methods:
account/rate_limit_status

Favorite methods:
favorites
favorites/create
favorites/destroy

Block methods:
blocks/create
blocks/destroy
blocks/list
blocks/ids

Saved Search methods:
saved_searches
saved_searches/show
saved_searches/create
saved_searches/destroy

Trends methods:
trends
trends/current
trends/daily
trends/weekly
trends/available

Source:

• twitcurl source is available in the repository in "Source" tab.
  
• Includes Microsoft Visual C++ 6.0 and 2008 workspace for building on Windows; and Makefile for building on UNIX/Linux distroes.
  
• Use SVN or tools like TortoiseSVN (http://tortoisesvn.net/) to check-out and download files.

Help needed?

See wiki section for more info on building and using twitcurl library.
http://code.google.com/p/twitcurl/wiki/WikiHowToUseTwitcurlLibrary

Note:

• twitcurl returns JSON responses from twitter.com as it is. You need to have a JSON parser to parse the responses.
  
• twitcurl uses HMAC_SHA1 from http://www.codeproject.com/KB/recipes/HMACSHA1class.aspx
• twitcurl uses base64 from http://www.adp-gmbh.ch/cpp/common/base64.html
• Check out http://www.json.org/ for C/C++ parsers.

Example:

An example twitter client program using twitcurl as a static library is available in the "Downloads" section.
The Makefile in twitterClient is supposed to run under sudo, and the file is tested under Ubuntu 12.04.

Info:

• More info on cURL can be found here: http://curl.haxx.se/
• More info on twitter REST APIs can be found here: http://apiwiki.twitter.com/w/page/22554679/Twitter-API-Documentation
• More info on twitter OAuth authorization can be found here:
  
  • http://dev.twitter.com/auth
  • http://www.jaanuskase.com/en/2010/01/understanding_the_guts_of_twit.html
  • http://codebrook.wordpress.com/2010/07/08/twitter-oauth-in-cpp-for-win32/
• Building cURL static library with SSL on Windows: http://swatrant.blogspot.in/2013/06/how-to-build-curl-static-library-with.html