A twitter bot extensible by means of eggs
Project description
Mr. Pump is a twitter bot, using tweepy.
To use
Install Mr. Pump.
Set up an account for Mr. Pump on Twitter.
Follow Pump’s account, and make him follow yours.
Visit dev.twitter.com. Log in as your Pump user. Create a new ‘application.’
Remember that only you are responsible for how you use or abuse Twitter.
Get the developer access token for your app.
Write a config file; we’ll call it golem.ini. (see below.)
Run Mr. Pump:
emet golem.ini
Send a direct message to Mr. Pump, e.g. “19 ping.”
Receive his reply: “927 pong.”
What are the numbers in the messages?
Just a way to get around Twitter’s “Whoops, you already said that!” message. It appears to be meant to prevent double posting. But when you are talking to computers you may need to repeat yourself more often than with people.
Config file
[app] # OAuth info needed to log in. You get these two when you register your app - key = ABCDEFGHijkl012345MNO secret = gr0igh24g8h240gh2rvun92rnuEIIH847fhier00 # (this is the screen name of the bot) [mygolem] # - and you get these two when you get your developer access token. token = 284729478-KANEFIIGRVKNRVO3883474KFKEVDKknvdvdkn993 secret = prgiIRGJIGkvmvvnkfkKNKRFNKFIFEIV48347fenef # A name for the instance of the ping chem - [ping] # For the ping chem, use the 'ping' entry point from the 'mrpump' egg. use = egg:mrpump#ping # A name for the instance of the time chem - [time] # For this one use the 'time' entry point from the 'time_chem' egg use = egg:time_chem#time # Any additional config required by this chem format = Year %Y month %m day %d [global] # A colon-separated list of directories wherein eggs containing chems are to be # found. plugin path = /home/me/mrpump-plugins # This is the same as the section name above. screen name = mygolem # Name of a file that Mr. Pump can write in. Gets no larger than 10k. cache = /tmp/already_seen # How many seconds between checking messages. Don't make Twitter angry. check every = 60 # debug, info, error: minimum level of messages to display. Debug is quite # verbose. log level = info # Names of each section above that configures a chem. chems = ping, time
Terminology
Making Mr. Pump do cool stuff
Write a chem and put it in an egg. Then change your configuration to include it, and restart Mr. Pump. Presto, your new functionality is ready!
In the examples directory there is a time chem. To make it work, go in that directory, and run python setup.py bdist_egg. Put the egg file (dist/*egg) in a directory that’s on the configured plugin path. The [time] section in the example configuration above will load the time chem. Now run emet, and DM your bot, time.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.