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 @ http://www.tumblr.com/api

=== 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 delete a post

    cfp: ~> tumblr delete post-id=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 (0 ~> name) --email=email, -e (0 ~> email) --password=password, -p (0 ~> password) --debug, -d --json, -j --help, -h