ahoward/tumblr


a command line utility and library for the excellent tumblr blogging platform

Language: Ruby


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 

Project Statistics

Sourcerank 3
Repository Size 78.1 KB
Stars 18
Forks 4
Watchers 4
Open issues 2
Dependencies 0
Contributors 2
Tags 0
Created
Last updated
Last pushed

Top Contributors See all

ara.t.howard Jordan Elver

Packages Referencing this Repo

tumblr
a command line utility and library which interfaces to the excellent tumblr blogging platform
Latest release 2.2.0 - Updated - 18 stars

Interesting Forks See all

jordelver/tumblr
a command line utility and library for the excellent tumblr blogging platform
Ruby - Last pushed - 1 stars - 1 forks

Something wrong with this page? Make a suggestion

Last synced: 2017-04-17 17:01:38 UTC

Login to resync this repository