Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/timvaillancourt/smallhands

A simple load generator for MongoDB using mentions of @realDonaldTrump via the Twitter Streaming API
https://github.com/timvaillancourt/smallhands

donald-trump loadgenerator mongodb

Last synced: about 1 month ago
JSON representation

A simple load generator for MongoDB using mentions of @realDonaldTrump via the Twitter Streaming API

Awesome Lists containing this project

README

        

# smallhands

Turns a negative into a positive by implementing a simple load generator for MongoDB using mentions of @realDonaldTrump via the Twitter Streaming API.
!["make run"](https://github.com/timvaillancourt/smallhands/blob/master/images/run.png)

## Required
1. A Twitter account
2. A set of read-only "Twitter Apps" keys (*See: [Twitter Apps Keys](#twitter-apps-keys) steps below*)
3. A Percona Server for MongoDB / MongoDB instance, replset or cluster
4. Python 2.7 (*Python 2.6 and 3.x not tested*) with 'pip', 'json' and 'dateutil' modules, ie: *"yum install python-pip python-json python-dateutil"* on Redhat/CentOS
5. Pip dependencies specified in 'requirements.txt' (*installed by ["make"](#getting-started) command*)

### Twitter Apps Keys

Smallhands requires Twitter API auth keys. You will need to register a new read-only "app" at https://apps.twitter.com to get a set of Consumer and Access auth key pairs.

## Limitations

Smallhands is self-interested; it frequently creates data but it is unable to read data. This makes it useful for testing inserts only.

## Disclaimer

The test tweet data is likely to contain unfathomably offensive material, false information, utter nonsense, etc.

## Getting Started
```
git clone https://github.com/timvaillancourt/smallhands
cd smallhands
make
cp example.yml config.yml
# (edit config.yml for your situation)
make run
```

## The Future...
1. Better, trump-themed errors/handling (*ie: `TREMENDOUS`, `SAD`, etc*)

## Code
I beat Python with a hammer until it works. Your improvements are appreciated!

## Contact
Tim Vaillancourt - [Github](https://github.com/timvaillancourt), [Email](mailto:[email protected])