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