Scripting Twitter with Python

9 April 2008

Twitter is a social networking service where users can write a sentence (maximum 140 characters) about themselves. It is similar to the mood in myspace or the status line in Facebook (Zeth is ... ), except that in Twitter it takes centre stage. It somewhat like sending your friends random SMS text messages but in a website format instead. Indeed you can even use Twitter with a phone if you really want to.

You can choose to let the general public to view your 'updates', or decide to only grant access to those who have become your "friends". Here is my new Twitter page. I am still thinking about how open/closed I should be about it.

When discussing it on IRC, Andy asked me what it offers over other social networking sites, and having used Twitter for only one day I am not sure I have a good answer. However, it is fun while it lasts, at least until we all get bored and just move along to the next one (for more see my prediction that social networking will eventually just become a protocol).

One fun thing about Twitter is that is has an open API with all kinds of language bindings that people have written for it.

DeWitt Clinton's last Twitter entry is "Just spent $65 to register TextMate. 20 minutes later, back to emacs". Hilarious! Especially since I am now writing this very post in Emacs.

DeWitt has also written Python bindings for the Twitter API, available from the Cheeseshop.

This has lots of potential, you can take your info out of Twitter and feed them into another service or other software, and visa-versa. In this post, we will just focus on Twitter, and getting the information in and out of Twitter using Python.

If you want to test it out yourself along with me, go grab the Python module, get yourself a Twitter account, and then type (or copy and paste) the commands into the Python interpreter (start Python by typing python into the terminal).

# Lets start by importing the Twitter API Python bindings:
import twitter

# New lets login with your username and password.
# Don't forget to change them to your details!
api = twitter.Api(username='zeth0', password='lenna')

# Lets printout the timeline
for i in api.GetFriendsTimeline():
    print i.relative_created_at, "|", i.user.name, "|", i.text

# Lets print out only the last status message for each of our
friends:
for u in api.GetFriends():
    print u.GetStatus().relative_created_at, "|", u.name, "|" ,\
    u.GetStatus().text

# Lets print the replies to our own posts:
for i in api.GetReplies():
    print i.relative_created_at, "|", i.user.name, "|", i.text

# Lets print out the personal messages that we have been sent
for i in api.GetDirectMessages():
    print i.created_at, "|", i.sender_screen_name, "|", i.text

# Lets create a new update
api.PostUpdate("""I just read an interesting post about using the
Python programming language and Twitter at Command Line Warriors
- http://commandline.org.uk/ - cooler than salmon on a stick.""")

# Lets make a new friend
api.CreateFriendship('zeth0')

Pretty cool! In a future post, we will connect it to other software. Bye for now.

Discuss this post | Leave a comment

1 dbr says...

I was looking for a simple script to post to Twitter, but all the API's were large, complex and had dependancies. When I stopped being lazy and actually looked at the Twitter API documentation, it is very simple.. Basically a HTTP post with status:your%20message (and it needs your username/password, of course)

The simple post-to-twitter module I wrote is.. 20 lines, with doc-strings, and only needs urllib:

"""Very simple Twitter-posting library.
Requires only default Python modules.
Very short."""
import urllib

def truncate(string,target):
    if len(string) > target:
    return string[:(target-3)] + "..."
else:
    return string

def squawk(username,password,message):
    """Simple post-to-twitter function"""
    message = truncate(message,140) # trim message

data = urllib.urlencode({"status" : message})
res = urllib.urlopen("http://%s:%s@twitter.com/statuses/update.xml" % \
    (username,password), data)

squawk("yourusername","yourpassword","The message to post")

(tab = 4 spaces)

It does nothing but post status-updates, so no pulling data in - but most of the code is there.. The only ~difficult thing would be parsing the XML (And beautifulSoup makes this much simpler)

Posted at 9:49 a.m. on April 10, 2008


What do you have to say?

Show Editing Help


About

Hello, my name is Zeth, I'll be your host here.

Command Line Warriors is about taking control of your own technology, it looks at our experiences of computing; especially using GNU/Linux, the Python programming language, the command-line and issues such as techno-ethics, best practices and whatever is cool now. If you take control of your technology then you are a Warrior too!

This site is your site too which means that you can contribute and get involved. You can leave comments using the facility provided. For me, the comments and discussions are by far the best part of the site. So please do have your say!

Latest Discussions

Kurushiyama

June 30, 2008
XML is no replacement for SGML, it's a subset.
An Introduction to ReStructuredText

Peter

June 27, 2008
This is pretty nice, maybe if an mget or mput could be added it would really improve its use. not sure how to do that couldn't figure it out using ...
SFTP in Python: Really Simple SSH

Bryce

June 25, 2008
Sorry to comment on an older post, but I wanted to point out that you misunderstand the purpose of at least two of the extensions you mentioned: Foxmarks and Greasemonkey. ...
Will Epiphany be able to compete with Firefox's extensions?

The Dude

June 24, 2008
1. Green Eggs 2. Ham 3. *things* .. _Here: http://google.com/
An Introduction to ReStructuredText

S.

June 20, 2008
A space is .25 of a level??? Instead of tabs or spaces, or tabs being so many spaces, there should be a "level" character, where one character equals one level ...
Twelve commandments for Beautiful Python code

jk

June 20, 2008
First, excuse my english. I was using firefox like every body else, until one day i look on Top command utility (system monitor) that firefox was using 190Mb of my ...
Epiphany and Webkit 2008

Tom

June 17, 2008
find -exec is nice, but escaping can become complicated if you want to execute, say, awk using a weird pattern. My preferred way is not elegant at all but very ...
Five Tips for Easter

Casual reader...

June 16, 2008
"Firstly, sending your friend a 6 MB file over the network, is nothing like murder. " It is true that sending your friend a file over the network is nothing ...
Filesharing is the democratic choice

Adam Bielinski

June 15, 2008
I like using epiphany because it's fast and lightweight, and is more intuitive in a GNOME environment. I don't think extensions are everything.
Will Epiphany be able to compete with Firefox's extensions?

Kewlmyst

June 12, 2008
Hmmm ... I have been rsync for a long time just to do back ups, but be aware that if you put the --delete option, and have a nice cron ...
Backing up my laptop

yegle

June 12, 2008
@Zeth Hello Zeth,can you share your script you mentioned about the Six degrees of separation?I'm so intrested about it~ And, this is really an excellent work !Thank you for shareing ...
Twitter and GNOME integration

Orlandus

June 9, 2008
Well, if they offer only an object-code-only license.and no object code, then I suppose nobody is legally entitled to have the software at all.
Are your Firefox extensions proprietary software?

Swashbuckler

June 5, 2008
"object code is a C term." Uh no. It's any compiled language.
Are your Firefox extensions proprietary software?

Craig

June 4, 2008
Here's a thought: I don't recall ever being asked to agree to a EULA before downloading a Firefox add-on. Maybe I just haven't downloaded any proprietary ones, but I think ...
Are your Firefox extensions proprietary software?