A script to fetch datasift preview stats for a particular hash, over a particular date range.
If you have Python and virtualenv installed, the simplest way to get set up is to clone or download all the source files, cd into the directory and then run these commands for first time::
$ virtualenv .env $ source .env/bin/activate $ python setup.py install
That will install everything you need to run the script.
Usage: datasift_preview_grabber <start_date> <end_date> <stream_hash> <datasift-username> <datasift-apikey>
Where:
start_date and end_date are in the format yyyy-mm-dd
The script will split the date range you give it into individual days (a limitation of the Datasift Preview service as it stands). Each day costs 20DPU currently so don't go mental with your date range!
For each day, the script creates a preview job with Datasift. The script waits for each job to finish, which can take a while. When all the jobs are finished, the results of them are simply printed to stdout.
If you want to enhance the script in some way, install the libraries from the test_requirements.txt in the virtualenv you created earlier and make sure the tests all pass before adding something new::
$ pip install -r test_requirements.txt $ nosetests
If it's useful, send it back to us in the form of a pull request on Github!