NAME tumblr
SYNOPSIS tumblr (setup|write|read|authenticate|check-vimeo|check-audio) [options]+
DESCRIPTION tumblr.rb is a command line utility and library which interfaces to the excellent tumblr blogging platform @ http://www.tumblr.com
tumblr.rb implements the complete restful api in both library and command line utility, doccumented in full @ API | Tumblr
=== install ===
gem install tumblr
=== cli ===
the cli exactly mirrors the library api. arguments are passed to each method as 'key=val' pairs, values may be read from files using the syntax 'key=file=val' or 'key==val'
you should first cache your login info to avoid having to pass it everytime
cfp: ~> tumblr setup --email=my_email --password=my_password --name=drawohara /Users/ahoward/.tumblr.yml
you can post
cfp: ~> tumblr write regular title=testing body=rock_on
you can post from files
cfp: ~> tumblr write regular title=slurp body==./post.html
you can read
cfp: ~> tumblr read start=42 num=42
you can test the auth
cfp: ~> tumblr authenticate
etc.
=== api ===
it's pretty simple. here's a start, use the web docs to figure out the rest
config = { :email => my_email, :password => my_password, :name => 'drawohara' }
tumblr = Tumblr.for config
abort unless tumblr.uri == 'http://drawohara.tumblr.com'
response = tumblr.write :regular, :title = title, :body => body
video = open 'video.mpg' response = tumblr.write :video, :data => video, :title => video.path
response = tumblr.read :start => 42, :num => 42 xml = response.content
response = tumblr.read :start => 42, :num => 42, :json => true json = response.content
PARAMETERS --name=name, -n (1 ~> name) --email=email, -e (1 ~> email) --password=password, -p (1 ~> password) --debug, -d --json, -j --help, -h