#tweet-blender
A Python quick commande line tool including two features :
- Quirky Twitter usage stats reporting over a specifiable period
- Tweets sorting and exporting using advanced content and date filtering
##usage
As soon as you get it from twitter.com, just unzip your archive on your hard drive and place common_words.txt_ file, common_domains.txt file, and tweet_blender.py in the same folder.
$ python tweet_blender.py
Runs the script to reports and print stats stdout.
$ python tweet_blender.py -start 24062012
Add date filtering to get data covering a specific period of your life.
$ python tweet_blender.py -end 31122009
$ python tweet_blender.py -start 01062009 -end 31122009
The stats feature displays a bucnh of funny stats and a few of your « top things » — example below for example lists your most common tweeted words:
× stop repeating yourself : — 1. fucking — 2. fuck — 3. code — 4. super — 5. cool
Data used in above example is courtesy of my husband, and yes, in case you're wondering : I am very proud!
Here's a bunch of other things you can get:
× software spots: — 1. Tweetbot for iOS — 2. HootSuite — 3. Echofon — 4. Twitter for iPhone — 5. Instagram
× devoted entertainers: — 1. @c0unt0 — 2. @singletau — 3. @korben — 4. @smwhr — 5. @@lesarchivistes
× this is, literally, your twitter face: — 1. :) — 2. :/ — 3. :D — 4. :x — 5. ;)
× top domains: — 1. wikipedia.org — 2. wired.com — 3. reddit.com — 4. vice.com — 5. slashdot.org
These are just a few, there are many more!
If you want to resize tops to get more data, please use -t
option like this :
$ python tweet_blender.py -t 42
- whenever possible, this displays your 42 most tweeted smileys, internet domains, etc...
### sort and export feature
All commands listed below desactivate stats feature, then turn script into an exporter which stores selected tweets to the sorted.csv file.
$ python tweet_blender.py -start ddmmyyyy
Includes tweets from given date (included.)
$ python tweet_blender.py -end ddmmyyyy
Includes tweets until given date (included.)
$ python tweet_blender.py -aany pattern [pattern ...]
Includes tweets containing pattern or pattern n. Patterns maybe a word, "an expression" or "a regexp?".
$ python tweet_blender.py -aall pattern [pattern ...]
Includes tweets containing pattern and pattern n.
$ python tweet_blender.py -rany pattern [pattern ...]
Removes tweets containing pattern or pattern n.
$ python tweet_blender.py -rall pattern [pattern ...]
Removes tweets containing pattern and pattern n.
Both [-aany]
or [-aall]
inclusion options can be combined with [-rany]
or [-rall]
exclusion options. Date filtering can be combined with any options.
For example :
$ python tweet_blender.py -aany pizza "video games" -rall programming coffee
Adds to selection tweets that contain 'pizza' or 'video games' and removes from selection tweets that contain both 'programming' and 'coffee'.
$ python tweet_blender.py -aall @binnie 'cof+e+' -rany pizza donut cookie
Adds to selection tweets that contain '@binnie' and match 'cof+e+' and removes from selection tweets that contain 'pizza' or 'donut' or 'cookie'.
To make your query case insensitive, add [-i]
option
$ python tweet_blender.py -start 20122012 -end 27122012 -aany "hip hop" party -rany "oh oh oh" -i
This outputs all your xmas 2012 tweets speaking about hip hop or parties, removing santa jokes.
## help
python tweet_blender.py -h
usage: tweet_blender [-h] [-aany pattern [pattern ...] | -aall pattern
[pattern ...]] [-rany pattern [pattern ...] | -rall
pattern [pattern ...]] [-start pattern [pattern ...]]
[-end pattern [pattern ...]] [-i] [-t size]
Process some tweets.
optional arguments:
-h, --help show this help message and exit
-aany pattern [pattern ...]
Include tweets containing any of the listed
expressions.
-aall pattern [pattern ...]
Include tweets containing all of the listed
expressions.
-rany pattern [pattern ...]
Remove tweets containing any of the listed
expressions.
-rall pattern [pattern ...]
Remove tweets containing all of the listed
expressions.
-start pattern [pattern ...]
Include tweets from given date. [Format : ddmmyyyy]
-end pattern [pattern ...]
Include tweets until given date. [Format : ddmmyyyy]
-i Make command case insensitive.
-t size Define tops size.
- Please feel free to edit the common_words.txt file or common_domains.txt file as you wish in order to obtain more accurate personal and funny results.
- common_words.txt contains around 1000 french words so you may want to delete them if you tweet only in english, so the script can run quicker.
Dependencies : none.