[ANN] tumblr-2.2.0

[ara.t.howard]

2.2.0 introduces support for delete operations (thanks to
http://github.com/jordelver)



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,
assword => 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