hexorx-rumblr 0.0.3

data/.gitignore

@@ -0,0 +1,4 @@
+*.sw?
+.DS_Store
+coverage
+*.gem

data/LICENSE.rdoc

@@ -0,0 +1,24 @@
+= License
+
+(The MIT License)
+
+Copyright (c) 2009 Brent Hargrave
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,59 @@
+= Rumblr
+
+Rumblr is a Ruby client for http://www.tumblr.com XML API.  It currently only provides read functionality; you can read User, Tumblelog and Post data.
+
+= Overview
+
+Rumblr maps the Tumblr API 'authenticate' and 'read' calls.  User, Tumblelog and Post models have the attributes provided by the API, as well as some convenience methods for common tasks.
+
+Please read Tumblr's official documentation (http://tumblr.com/api/) to learn more about the API.
+
+
+== Dependencies
+
+* Ruby >= 1.8.6 (not tested with previous versions)
+* libxml-ruby >= 0.8.3
+
+
+== Download and Installation
+
+RubyGems[http://rubyforge.org/projects/rubygems/] is the preferred install method.
+To get the latest version, simply type the following instruction into your command prompt:
+
+  $ sudo gem install jamescallmebrent-rumblr -s http://gems.github.com
+
+
+== Getting Started
+
+In order to use this library you need a valid Tumblr account.
+Go to http://tumblr.com and register for a new account if you don't already have one.
+
+
+=== Sample usage:
+
+  require 'rumblr'
+  include Rumblr
+  
+  user = User.login({:email => 'name@domain.com', :password => 'pass'})
+  
+  user.tumblelogs.each do |log|
+    puts log.name  # 'the tumblelogger'
+    puts log.type  # 'public'
+    puts log.url   # 'http://tumblelogger.tumblr.com/'
+    puts
+  end
+  
+  tumblelog = user.primary_tumblelog
+  
+  tumblelog.posts.each do |post|
+    puts post.type  # 'quote'
+    puts post.url   # 'http://tumblelogger.tumblr.com/post/12345/my-first-tumblr-post'
+  end
+
+  post = RegularPost.new(:title => "Post Title", :body => "Just a regular post!")
+  Client.instance.write(post, {:email => 'name@domain.com', :password => 'pass'})
+
+
+== License
+
+Copyright (c) 2009 Brent Hargrave. Rumblr is released under the MIT license.

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    summary = %Q{Ruby client for the Tumblr API}
+
+    s.name = "rumblr"
+    s.summary = summary
+    s.email = "brent.hargrave@gmail.com"
+    s.homepage = "http://github.com/jamescallmebrent/rumblr"
+    s.description = summary
+    s.authors = ["Brent Hargrave", "Benny Wong"]
+    s.add_dependency('libxml-ruby', '>= 0.8.3')
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'rumblr'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << 'lib' << 'spec'
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |t|
+  t.libs << 'lib' << 'spec'
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = true
+end
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+rescue LoadError
+  puts "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+end
+
+task :default => :spec

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 0
+:minor: 0
+:patch: 2

data/lib/rumblr/client.rb

@@ -0,0 +1,146 @@
+module Rumblr
+  
+  class Client
+    include Singleton
+    
+    # The default set of headers for each request.
+    DEFAULT_HEADER = {
+        'User-Agent'  => 'Rumblr',
+        'Accept'      => 'application/xml'
+    }
+    
+    def authenticate(email,password)
+      raise ArgumentError unless (email && password)
+      user_credentials = { :email => email, :password => password }
+      uri = URI::HTTP.build({:path => '/api/authenticate'})
+      request = Net::HTTP::Post.new(uri.request_uri, DEFAULT_HEADER)
+      request.set_form_data(user_credentials)
+      
+      user_attributes = nil
+      complete_request(request) do |response_body|
+        user_attributes = parse_user_attributes_from(response_body)
+        user_attributes.merge!(user_credentials)
+      end
+      user = User.new(user_attributes)
+      user.tumblelogs.each{ |tumblelog| tumblelog.user = user }
+      user
+    end
+    
+    def read(options={})
+      tumblelog, posts = nil, [] # initialize the return targets
+      
+      uri = URI::HTTP.build({:path => '/api/read'})
+      request = Net::HTTP::Post.new(uri.request_uri, DEFAULT_HEADER)
+      request.set_form_data(options)
+      
+      raise(ArgumentError) unless (options && options[:url] && !options[:url].empty?)
+      
+      request_url_host = URI.parse(options[:url]).host
+      complete_request(request,host=request_url_host) do |response_body|
+        parser = XML::Parser.string(response_body)
+        doc = parser.parse
+        # parse and map tumblelog
+        tumblelog_element = doc.find_first('//tumblr/tumblelog')
+        tumblelog_attrs = cleanup_hash(tumblelog_element.attributes.to_h)
+        tumblelog_attrs.merge!(:url => options[:url])
+        tumblelog = Tumblelog.new(tumblelog_attrs)
+        # parse and map posts
+        posts = doc.find('//tumblr/posts/post').inject([]) do |array, element|
+          post_attrs = cleanup_hash(element.attributes.to_h)
+          # inner elements =>  sublcass-specific attribute hash
+          subclass_attrs = element.children.inject({'tags' => []}) do |hash, child|
+            hash['tags'] << child.content if (child.name[/tag/])
+            hash[child.name] = child.content
+            hash
+          end
+          # merge hashes, clean out cruft
+          inner_attrs = cleanup_hash(subclass_attrs)
+          inner_attrs.delete(:text)
+          inner_attrs.delete(:tag)
+          post_attrs.merge!(inner_attrs)
+          # turn attributes into proper model
+          klass = Rumblr.const_get(Post::TYPES[post_attrs[:type]])
+          raise 'unknown post type' unless klass
+          post = klass.new(post_attrs)
+          post.tumblelog = tumblelog
+          array << post
+          array
+        end
+      end
+      return tumblelog, posts
+    end
+    
+    def write(post, creds)
+      raise(ArgumentError) unless post && post.is_a?(Post)
+      raise(ArgumentError) unless creds
+      uri = URI::HTTP.build(:path => "/api/write")
+      request = Net::HTTP::Post.new(uri.request_uri, DEFAULT_HEADER)
+      request.set_form_data(creds.merge(:type => Post::TYPES.invert[post.class]).merge(post.attribute_hash))
+      request_url_host = URI.parse(uri.request_uri).host
+      complete_request(request)
+    end
+    
+    
+    protected
+    
+    # Starts and completes the given request. Returns or yields the response body.
+    def complete_request(request, host = URI.parse(Rumblr.api_url).host)
+      http = Net::HTTP.new(host)
+      # Set to debug http output.
+      # http.set_debug_output $stderr
+      response = http.start { |http| http.request(request) }
+      
+      case response
+      when Net::HTTPSuccess           then  yield response.body if block_given?
+      when Net::HTTPBadRequest        then  raise Rumblr::RequestError, parse_error_message(response)
+      when Net::HTTPForbidden         then  raise Rumblr::AuthorizationError, parse_error_message(response)
+      when Net::HTTPNotFound          then  raise Rumblr::MissingResourceError, parse_error_message(response)
+      when Net::HTTPMovedPermanently  then  raise Rumblr::MovedResourceError, parse_error_message(response)
+      when Net::HTTPServerError       then  raise Rumblr::ServerError, connection_error_message
+      else                                  raise "Received an unexpected HTTP response: #{response}"
+      end
+      
+      response.body
+    end
+    
+    # Extracts the error message from the response for the exception.
+    def parse_error_message(response)
+      response.body
+    end
+    
+    def connection_error_message
+      "There was a problem connecting to Tumblr"
+    end
+    
+    
+    private
+    
+    def parse_user_attributes_from(response_body)
+      parser = XML::Parser.string response_body
+      doc = parser.parse
+      tumblelogs = doc.find('//tumblr/tumblelog').inject([]) do |array, element|
+        tumblelog_attrs = cleanup_hash(element.attributes.to_h)
+        array << Tumblelog.new(tumblelog_attrs)
+        array
+      end
+      raw_user_attributes = doc.find('//tumblr/user').first.attributes.to_h
+      user_attributes = cleanup_hash(raw_user_attributes)
+      user_attributes.merge!(:tumblelogs => tumblelogs)
+    end
+    
+    def cleanup_hash(attrs={})
+      clean_attrs = attrs.inject({}) do |hash,(key,value)|
+        mapped_key = key.gsub(/-/,'_').to_sym
+        mapped_value =  case value
+                        when /($1^|$yes^)/ then true
+                        when /($0^|$no^)/ then false
+                        else value
+                        end
+        hash[mapped_key] = mapped_value
+        hash
+      end
+    end
+  
+  end
+
+end

data/lib/rumblr/post.rb

@@ -0,0 +1,102 @@
+module Rumblr
+  
+  # for attribute details, see Tumblr's documentation:
+  # http://www.tumblr.com/api
+  class Post < Resource
+    
+    TYPES = {
+      'regular'      => "RegularPost",
+      'photo'        => "PhotoPost",
+      'quote'        => "QuotePost",
+      'link'         => "LinkPost",
+      'conversation' => "ConversationPost",
+      'video'        => "VideoPost",
+      'audio'        => "AudioPost"
+    }
+    
+    attr_reader :id, :url, :type, :unix_timestamp, :date_gmt, :date, :tags, :private
+    attr_accessor :tumblelog
+    
+    def initialize(attrs={})
+      @private = false
+      super
+    end
+    
+    def private?
+      @private
+    end
+    
+    def public?
+      !self.private?
+    end
+    
+    def attribute_hash
+      {:date => date}
+    end
+    
+  end
+  
+  class RegularPost < Post
+    attr_accessor :title, :body
+    
+    def attribute_hash
+      super.merge(:title => title, :body => body)
+    end
+    
+  end
+  
+  class PhotoPost < Post
+    attr_accessor :source, :data, :caption, :click_through_url
+    
+    def attribute_hash
+      super.merge(:source => source, :data => data, :caption => caption, :click_through_url => click_through_url)
+    end
+    
+  end
+  
+  class QuotePost < Post
+    attr_accessor :quote, :source
+    
+    def attribute_hash
+      super.merge(:quote => quote, :source => source)
+    end
+    
+  end
+  
+  class LinkPost < Post
+    attr_accessor :name, :url, :description
+    
+    def attribute_hash
+      super.merge(:name => name, :url => url, :description => description)
+    end
+    
+  end
+  
+  class ConversationPost < Post
+    attr_accessor :title, :conversation
+    
+    def attribute_hash
+      super.merge(:title => title, :conversation => conversation)
+    end
+    
+  end
+  
+  class VideoPost < Post
+    attr_accessor :embed, :data, :title, :caption
+    
+    def attribute_hash
+      super.merge(:embed => embed, :data => data, :title => title, :caption => caption)
+    end
+    
+  end
+  
+  class AudioPost < Post
+    attr_accessor :data, :caption
+    
+    def attribute_hash
+      super.merge(:data => data, :caption => caption)
+    end
+    
+  end
+  
+end

data/lib/rumblr/resource.rb

@@ -0,0 +1,13 @@
+module Rumblr
+  
+  class Resource
+    
+    def initialize(attrs={})
+      attrs.each do |key,value|
+        self.instance_variable_set(:"@#{key.to_s}", value)
+      end
+    end
+  
+  end
+  
+end

data/lib/rumblr/tumblelog.rb

@@ -0,0 +1,30 @@
+module Rumblr
+  
+  class Tumblelog < Resource
+    attr_reader :name, :timezone, :cname, :title, :url, :avatar_url, :is_primary, 
+                :type, :private_id
+    attr_accessor :user
+
+    def posts(options={})
+      return [] unless self.url
+      options.reverse_merge!(:url => self.url)
+      log, posts = Client.instance.read(options)
+      return posts
+    end
+
+    def primary?
+      is_primary == "yes"
+    end
+    
+    class << self
+      
+      def find_by_url(url)
+        log, posts = Client.instance.read(:url => url)
+        return log
+      end
+    
+    end
+    
+  end
+  
+end

data/lib/rumblr/user.rb

@@ -0,0 +1,27 @@
+module Rumblr
+  
+  class User < Resource
+    attr_reader :email, :password, :can_upload_video, :can_upload_aiff, :vimeo_login_url, :can_upload_audio
+    
+    def tumblelogs
+      instance_variable_get(:@tumblelogs) || []
+    end
+    
+    def primary_tumblelog
+      self.tumblelogs.find { |log| log.primary? }
+    end
+    
+    def auth
+      {:email => self.email, :password => self.password}
+    end
+    
+    class << self
+      def login(attrs={})
+        email, password = attrs[:email], attrs[:password]
+        Client.instance.authenticate(email,password)
+      end
+    end
+
+  end
+  
+end

data/lib/rumblr.rb

@@ -0,0 +1,28 @@
+module Rumblr
+
+  class MissingResourceError < Exception; end
+  class MovedResourceError < Exception; end
+  class AuthorizationError < Exception; end
+  class RequestError < Exception; end
+  class ServerError < Exception; end
+  
+  class << self
+    attr_accessor :api_url
+  end
+end
+
+Rumblr.api_url = "http://www.tumblr.com"
+
+require 'rubygems'
+require 'singleton'
+require 'net/http'
+require 'uri'
+gem 'libxml-ruby', '>= 0.8.3'
+require 'xml'
+require 'pp'
+
+require 'rumblr/client'
+require 'rumblr/resource'
+require 'rumblr/tumblelog'
+require 'rumblr/user'
+require 'rumblr/post'

data/rumblr.gemspec

@@ -0,0 +1,60 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rumblr}
+  s.version = "0.0.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Brent Hargrave", "Benny Wong"]
+  s.date = %q{2009-05-30}
+  s.description = %q{Ruby client for the Tumblr API}
+  s.email = %q{brent.hargrave@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.rdoc",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE.rdoc",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "lib/rumblr.rb",
+     "lib/rumblr/client.rb",
+     "lib/rumblr/post.rb",
+     "lib/rumblr/resource.rb",
+     "lib/rumblr/tumblelog.rb",
+     "lib/rumblr/user.rb",
+     "rumblr.gemspec",
+     "spec/rumblr/client_spec.rb",
+     "spec/rumblr/post_spec.rb",
+     "spec/rumblr/tumblelog_spec.rb",
+     "spec/rumblr/user_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/jamescallmebrent/rumblr}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.3}
+  s.summary = %q{Ruby client for the Tumblr API}
+  s.test_files = [
+    "spec/rumblr/client_spec.rb",
+     "spec/rumblr/post_spec.rb",
+     "spec/rumblr/tumblelog_spec.rb",
+     "spec/rumblr/user_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<libxml-ruby>, [">= 0.8.3"])
+    else
+      s.add_dependency(%q<libxml-ruby>, [">= 0.8.3"])
+    end
+  else
+    s.add_dependency(%q<libxml-ruby>, [">= 0.8.3"])
+  end
+end

data/spec/rumblr/client_spec.rb

@@ -0,0 +1,145 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper" )
+
+module Rumblr
+
+  describe Client do
+
+    it 'should not be able to be instantiated externally' do
+      lambda { Client.new }.should raise_error(NoMethodError)
+    end
+    
+    it 'should be able to instantiate itself' do
+      lambda { Client.instance }.should_not raise_error
+    end
+  
+  end
+  
+  describe Client, "authentication" do
+
+    before(:each) { mock_successful(:authenticate) }
+    
+    it 'should raise an ArgumentError without email' do
+      lambda do
+        @client.authenticate('email', nil)
+      end.should raise_error(ArgumentError)
+    end
+
+    it 'should raise an ArgumentError without password' do
+      lambda do
+        @client.authenticate(nil,'password')
+      end.should raise_error(ArgumentError)
+    end
+
+    it 'should return a User if successful' do
+      result = @client.authenticate('foo@foo.com','password')
+      result.should be_an_instance_of(User)
+    end
+    
+    it "should include user's existing tumblelogs" do
+      user = @client.authenticate('foo@foo.com','password')
+      user.tumblelogs.size.should == 2
+    end
+    
+  end
+  
+  describe Client, "reading from a public tumblelog" do
+    
+    it 'without a URL should raise an error' do
+      mock_successful(:anonymous_read)
+      lambda do
+        @client.read
+      end.should raise_error(ArgumentError)
+    end
+    
+    it 'with an empty URL should raise an error' do
+      mock_successful(:anonymous_read)
+      lambda do
+        @client.read(:url => '')
+      end.should raise_error(ArgumentError)
+    end
+    
+    describe 'without credentials' do
+      
+      before(:each) do
+        mock_successful(:anonymous_read)
+        @tumblelog, posts = @client.read(:url => 'http://dummylog.tumblr.com/')
+      end
+      
+      it 'should yield only posts' do
+        @tumblelog.posts.all? {|post| post.kind_of?(Post)}.should be_true
+      end
+      
+      it 'should not include all posts, assuming some are private' do
+        @tumblelog.posts.size.should == 7
+      end
+      
+      it 'should only include public posts' do
+        @tumblelog.posts.all? {|post| post.public? }.should be_true
+      end
+      
+      it 'should not include any private posts' do
+        @tumblelog.posts.any? {|post| post.private? }.should be_false
+      end
+      
+    end
+    
+    describe 'with valid credentials' do
+      
+      before(:each) do
+        mock_successful(:authenticated_read)
+        @tumblelog, posts = @client.read( :url => 'http://dummylog.tumblr.com/', 
+                                          :email => 'valid',
+                                          :password => 'valid' )
+      end
+      
+      it 'should include all tumblelog posts' do
+        @tumblelog.posts.size.should == 14
+      end
+      
+      it 'should include all public posts' do
+        @tumblelog.posts.find_all {|p| p.public? }.size.should == 7
+      end
+      
+      it 'should include private posts' do
+        @tumblelog.posts.find_all {|p| p.public? }.size.should == 7
+      end
+      
+    end
+    
+  end
+  
+  describe Client, "writing to a public tumblelog" do
+    
+    before(:each) do
+      mock_successful(:authenticated_read)
+      @tumblelog, posts = @client.read( :url => 'http://dummylog.tumblr.com/', 
+                                        :email => 'valid',
+                                        :password => 'valid' )
+      mock_successful(:authenticated_write)
+    end
+    
+    it 'should raise an ArgumentError without post' do
+      lambda do
+        @client.write(nil, {:email => 'valid', :password => 'valid'})
+      end.should raise_error(ArgumentError)
+    end
+    
+    it 'should raise an ArgumentError if post is incorrect class' do
+      lambda do
+        @client.write("", {:email => 'valid', :password => 'valid'})
+      end.should raise_error(ArgumentError)
+    end
+    
+    it 'should raise an ArgumentError without creds' do
+      lambda do
+        @client.write(Rumblr::Post.new, nil)
+      end.should raise_error(ArgumentError)
+    end
+    
+    it 'should return an id' do
+      @client.write(Rumblr::Post.new, {:email => 'valid', :password => 'valid'}).should == "10001"
+    end
+    
+  end
+  
+end

data/spec/rumblr/post_spec.rb

@@ -0,0 +1,29 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper" )
+
+module Rumblr
+  
+  describe Post, 'instances' do
+    
+    it 'should have attributes shared by every Post' do
+      Post.new.should respond_to(:id, :url, :type, :unix_timestamp, :date_gmt, :date, :tags, :private, :tumblelog)
+    end
+    
+    it 'private attribute should default to false' do
+      Post.new.private.should be_false
+    end
+    
+    it 'should provide it private status' do
+      Post.new.should respond_to(:private?)
+    end
+    
+    it 'should provide it public status (inverse of private status)' do
+      Post.new.should respond_to(:public?)
+    end
+    
+    it 'should provide a hash of attributes and values for API' do
+      Post.new.should respond_to(:attribute_hash)
+    end
+
+  end
+  
+end

data/spec/rumblr/tumblelog_spec.rb

@@ -0,0 +1,64 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper" )
+
+module Rumblr
+
+  describe Tumblelog, 'instances' do
+    
+    it 'should have the attributes of a Tumblelog' do
+      Tumblelog.new.should respond_to(  :name, :timezone, :cname, :title, :url, 
+                                        :avatar_url, :is_primary, :type, :private_id)
+    end
+    
+    it "' posts should initialize empty" do
+      Tumblelog.new.posts.should be_a_kind_of(Array)
+    end
+    
+  end
+  
+  describe Tumblelog, 'finder' do
+    
+    describe 'provided a valid URL' do
+    
+      it 'should successfully retrieve a tumblelog' do
+        mock_successful(:anonymous_read)
+        log = Tumblelog.find_by_url('valid_url')
+        log.should be_an_instance_of(Tumblelog)
+      end
+      
+      it 'should retrieve a tumblelog with posts' do
+        mock_successful(:anonymous_read)
+        log = Tumblelog.find_by_url('valid_url')
+        log.posts.first.should be_a_kind_of(Post)
+        log.posts.first.type.should_not be_nil
+      end
+      
+    end
+    
+  end
+
+  describe Tumblelog, 'user' do
+    
+    describe 'logged in' do
+
+      before(:each) do
+        mock_successful(:authenticate)
+        @user = User.login(:email => 'valid_email', :password => 'valid_password')
+      end
+
+      it 'should have a user associated with it' do
+        @user.primary_tumblelog.user.should_not be_nil
+      end
+   
+    end
+
+    describe 'not logged in' do
+      
+      it 'should not have a user if anonymous read' do
+        mock_successful(:anonymous_read)
+        Tumblelog.find_by_url('valid_url').user.should be_nil
+      end
+      
+    end
+  end
+
+end

data/spec/rumblr/user_spec.rb

@@ -0,0 +1,69 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper" )
+
+module Rumblr
+
+  describe User, 'initializing' do
+
+    it 'should have the attributes of a User' do
+      User.new.should respond_to( :email, 
+                                  :password, 
+                                  :can_upload_video, 
+                                  :can_upload_aiff, 
+                                  :vimeo_login_url,
+                                  :can_upload_audio )
+    end
+    
+    it 'tumblelogs should initialize empty' do
+      User.new.tumblelogs.should be_a_kind_of(Array)
+    end
+    
+  end
+  
+  describe User, 'logging in' do
+    
+    before(:each) do
+      mock_successful(:authenticate)
+    end
+  
+    it 'should login with email and password' do
+      user = User.login(:email => 'valid_email', :password => 'valid_password')
+      user.should be_an_instance_of(User)
+    end
+    
+    it 'should not initialize without email' do
+      lambda do
+        User.login(:email => nil, :password => 'valid_password')
+      end.should raise_error(ArgumentError)
+    end
+    
+    it 'should not initialize without password' do
+      lambda do
+        User.login(:email => 'valid_email', :password => nil)
+      end.should raise_error(ArgumentError)
+    end
+    
+  end
+  
+  describe User, ', once logged in,' do
+    
+    before(:each) do
+      mock_successful(:authenticate)
+      @user = User.login(:email => 'valid_email', :password => 'valid_password')
+    end
+    
+    it 'should provide one or more tumblelogs' do
+      @user.tumblelogs.size.should == 2
+    end
+    
+    it 'should provide *only* tumblelogs' do
+      @user.tumblelogs.all? { |obj| obj.should be_an_instance_of(Tumblelog)  }
+    end
+    
+    it 'should provide a primary tumblelog' do
+      primary = @user.primary_tumblelog
+      primary.is_primary.should == 'yes'
+    end
+    
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,106 @@
+$: << File.join(File.dirname(__FILE__), "/../lib" )
+
+require 'spec'
+require 'rumblr'
+
+def mock_successful(request)
+  responses_to = { 
+    :authenticate         => successful_authenticate_xml, 
+    :anonymous_read       => successful_anonymous_read_xml,
+    :authenticated_read   => successful_authenticated_read_xml,
+    :authenticated_write  => successful_authenticated_write_xml 
+  }
+  
+  @client = Rumblr::Client.instance
+  if request == :authenticated_write
+    @client.stub!(:complete_request).and_return(responses_to[request])
+  else
+    # yes, this is cheating, but for now just concerned that xml is parsed right
+    @client.stub!(:complete_request).and_yield(responses_to[request])
+  end
+end
+
+def successful_authenticate_xml
+  response = <<-EOF
+    <?xml version="1.0" encoding="UTF-8"?>
+    <tumblr version="1.0">
+      <user can-upload-audio="1" can-upload-aiff="1" can-upload-video="0" vimeo-login-url="http://www.vimeo.com/services/foo"/>
+      <tumblelog title="" name="foo" url="http://foo.com/" type="public" avatar-url="http://assets.tumblr.com/images/default_avatar_foo.gif" is-primary="yes"/>
+      <tumblelog title="bar" private-id="000000"  type="private"/>
+    </tumblr>
+    EOF
+  response.strip!
+end
+
+def successful_anonymous_read_xml
+  response = <<-EOF
+    <?xml version="1.0" encoding="UTF-8"?>
+    <tumblr version="1.0">
+      <tumblelog name="dummylog" timezone="US/Eastern" title="dummy tumblelog title">dummylog description</tumblelog>
+      <posts start="0" total="7">
+        <post id="78846368" url="http://dummylog.tumblr.com/post/78846368" type="video" date-gmt="2009-02-16 19:11:45 GMT" date="Mon, 16 Feb 2009 14:11:45" unix-timestamp="1234811505">
+          <video-caption>public video post caption</video-caption>
+          <video-source>http://www.youtube.com/watch?v=rPaWZOM1LnY</video-source>
+          <video-player>&lt;object width="400" height="336"&gt;&lt;param name="movie" value="http://www.youtube.com/v/rPaWZOM1LnY&amp;amp;rel=0&amp;amp;egm=0&amp;amp;showinfo=0&amp;amp;fs=1"&gt;&lt;/param&gt;&lt;param name="wmode" value="transparent"&gt;&lt;/param&gt;&lt;param name="allowFullScreen" value="true"&gt;&lt;/param&gt;&lt;embed src="http://www.youtube.com/v/rPaWZOM1LnY&amp;amp;rel=0&amp;amp;egm=0&amp;amp;showinfo=0&amp;amp;fs=1" type="application/x-shockwave-flash" width="400" height="336" allowFullScreen="true" wmode="transparent"&gt;&lt;/embed&gt;&lt;/object&gt;</video-player>
+          <tag>sale</tag>
+          <tag>music</tag>
+        </post>
+        <post id="78846080" url="http://dummylog.tumblr.com/post/78846080" type="audio" date-gmt="2009-02-16 19:10:20 GMT" date="Mon, 16 Feb 2009 14:10:20" unix-timestamp="1234811420" audio-plays="0">
+          <audio-caption>public audio post description</audio-caption><audio-player>&lt;embed type="application/x-shockwave-flash" src="http://dummylog.tumblr.com/swf/audio_player.swf?audio_file=http://www.tumblr.com/audio_file/78846080/TofwJxqCAk12g1e0ClxHx7gh&amp;color=FFFFFF" height="27" width="207" quality="best"&gt;&lt;/embed&gt;</audio-player>
+          <tag>sale</tag>
+        </post>
+        <post id="78844911" url="http://dummylog.tumblr.com/post/78844911" type="conversation" date-gmt="2009-02-16 19:04:48 GMT" date="Mon, 16 Feb 2009 14:04:48" unix-timestamp="1234811088">
+          <conversation-title>public chat post title</conversation-title>
+          <conversation-text>me: public&#13;
+    you: chat&#13;
+    me: post&#13;
+    you: dialogue</conversation-text><conversation><line name="me" label="me:">public&#13;</line><line name="you" label="you:">chat&#13;</line><line name="me" label="me:">post&#13;</line><line name="you" label="you:">dialogue</line></conversation><conversation-line name="me" label="me:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">public&#13;</conversation-line><conversation-line name="you" label="you:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">chat&#13;</conversation-line><conversation-line name="me" label="me:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">post&#13;</conversation-line><conversation-line name="you" label="you:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">dialogue</conversation-line>
+          <tag>sale</tag>
+        </post>
+        <post id="78844351" url="http://dummylog.tumblr.com/post/78844351" type="link" date-gmt="2009-02-16 19:02:00 GMT" date="Mon, 16 Feb 2009 14:02:00" unix-timestamp="1234810920">
+          <link-text>public link post name</link-text><link-url>http://www.google.com</link-url>
+          <link-description>public link post description</link-description>
+          <tag>sale</tag>
+        </post>
+        <post id="78844076" url="http://dummylog.tumblr.com/post/78844076" type="quote" date-gmt="2009-02-16 19:01:06 GMT" date="Mon, 16 Feb 2009 14:01:06" unix-timestamp="1234810866">
+          <quote-text>public quote post content</quote-text>
+          <quote-source>public quote post source</quote-source>
+          <tag>sale</tag>
+        </post>
+        <post id="78841604" url="http://dummylog.tumblr.com/post/78841604" type="regular" date-gmt="2009-02-16 18:50:00 GMT" date="Mon, 16 Feb 2009 13:50:00" unix-timestamp="1234810200">
+          <regular-title>public text post title</regular-title>
+          <regular-body>public text post body</regular-body>
+          <tag>sale</tag>
+        </post>
+        <post id="78841444" url="http://dummylog.tumblr.com/post/78841444" type="photo" date-gmt="2009-02-16 18:49:00 GMT" date="Mon, 16 Feb 2009 13:49:00" unix-timestamp="1234810140">
+          <photo-caption>public photo post</photo-caption>
+          <photo-url max-width="500">http://21.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_500.jpg</photo-url>
+          <photo-url max-width="400">http://1.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_400.jpg</photo-url>
+          <photo-url max-width="250">http://22.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_250.jpg</photo-url>
+          <photo-url max-width="100">http://19.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_100.jpg</photo-url>
+          <photo-url max-width="75">http://2.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_75sq.jpg</photo-url>
+          <tag>sale</tag>
+        </post>
+      </posts>
+    </tumblr>
+  EOF
+  response.strip!
+end
+
+def successful_authenticated_read_xml
+  response = <<-EOF
+  <?xml version="1.0" encoding="UTF-8"?>
+  <tumblr version="1.0"><tumblelog name="dummylog" timezone="US/Eastern" title="dummy tumblelog title">dummy tumblelog description</tumblelog><posts start="0" total="7"><post id="78846474" url="http://dummylog.tumblr.com/post/78846474" type="video" date-gmt="2009-02-16 19:12:00 GMT" date="Mon, 16 Feb 2009 14:12:00" unix-timestamp="1234811520" private="true"><video-caption>private video post caption</video-caption><video-source>http://www.youtube.com/watch?v=rPaWZOM1LnY</video-source><video-player>&lt;object width="400" height="336"&gt;&lt;param name="movie" value="http://www.youtube.com/v/rPaWZOM1LnY&amp;amp;rel=0&amp;amp;egm=0&amp;amp;showinfo=0&amp;amp;fs=1"&gt;&lt;/param&gt;&lt;param name="wmode" value="transparent"&gt;&lt;/param&gt;&lt;param name="allowFullScreen" value="true"&gt;&lt;/param&gt;&lt;embed src="http://www.youtube.com/v/rPaWZOM1LnY&amp;amp;rel=0&amp;amp;egm=0&amp;amp;showinfo=0&amp;amp;fs=1" type="application/x-shockwave-flash" width="400" height="336" allowFullScreen="true" wmode="transparent"&gt;&lt;/embed&gt;&lt;/object&gt;</video-player><tag>sale</tag><tag>tag2</tag><tag>music</tag></post><post id="78846368" url="http://dummylog.tumblr.com/post/78846368" type="video" date-gmt="2009-02-16 19:11:00 GMT" date="Mon, 16 Feb 2009 14:11:00" unix-timestamp="1234811460"><video-caption>public video post caption</video-caption><video-source>hilhttp://www.youtube.com/watch?v=rPaWZOM1LnY</video-source><video-player>&lt;object width="400" height="336"&gt;&lt;param name="movie" value="http://www.youtube.com/v/rPaWZOM1LnY&amp;amp;rel=0&amp;amp;egm=0&amp;amp;showinfo=0&amp;amp;fs=1"&gt;&lt;/param&gt;&lt;param name="wmode" value="transparent"&gt;&lt;/param&gt;&lt;param name="allowFullScreen" value="true"&gt;&lt;/param&gt;&lt;embed src="http://www.youtube.com/v/rPaWZOM1LnY&amp;amp;rel=0&amp;amp;egm=0&amp;amp;showinfo=0&amp;amp;fs=1" type="application/x-shockwave-flash" width="400" height="336" allowFullScreen="true" wmode="transparent"&gt;&lt;/embed&gt;&lt;/object&gt;</video-player><tag>hilarious</tag></post><post id="78846150" url="http://dummylog.tumblr.com/post/78846150" type="audio" date-gmt="2009-02-16 19:10:43 GMT" date="Mon, 16 Feb 2009 14:10:43" unix-timestamp="1234811443" private="true" audio-plays="2"><audio-caption>private audio post description</audio-caption><audio-player>&lt;embed type="application/x-shockwave-flash" src="http://dummylog.tumblr.com/swf/audio_player.swf?audio_file=http://www.tumblr.com/audio_file/78846150/TofwJxqCAk12gje4UYRllUwM&amp;color=FFFFFF" height="27" width="207" quality="best"&gt;&lt;/embed&gt;</audio-player><tag>sale</tag></post><post id="78846080" url="http://dummylog.tumblr.com/post/78846080" type="audio" date-gmt="2009-02-16 19:10:00 GMT" date="Mon, 16 Feb 2009 14:10:00" unix-timestamp="1234811400" audio-plays="0"><audio-caption>public audio post description</audio-caption><audio-player>&lt;embed type="application/x-shockwave-flash" src="http://dummylog.tumblr.com/swf/audio_player.swf?audio_file=http://www.tumblr.com/audio_file/78846080/TofwJxqCAk12g1e0ClxHx7gh&amp;color=FFFFFF" height="27" width="207" quality="best"&gt;&lt;/embed&gt;</audio-player><tag>sale</tag><tag>music</tag></post><post id="78844968" url="http://dummylog.tumblr.com/post/78844968" type="conversation" date-gmt="2009-02-16 19:05:08 GMT" date="Mon, 16 Feb 2009 14:05:08" unix-timestamp="1234811108" private="true"><conversation-title>private chat post title</conversation-title><conversation-text>me: private&#13;
+  you: chat&#13;
+  me: post&#13;
+  you: dialogue</conversation-text><conversation><line name="me" label="me:">private&#13;</line><line name="you" label="you:">chat&#13;</line><line name="me" label="me:">post&#13;</line><line name="you" label="you:">dialogue</line></conversation><conversation-line name="me" label="me:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">private&#13;</conversation-line><conversation-line name="you" label="you:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">chat&#13;</conversation-line><conversation-line name="me" label="me:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">post&#13;</conversation-line><conversation-line name="you" label="you:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">dialogue</conversation-line><tag>sale</tag></post><post id="78844911" url="http://dummylog.tumblr.com/post/78844911" type="conversation" date-gmt="2009-02-16 19:04:48 GMT" date="Mon, 16 Feb 2009 14:04:48" unix-timestamp="1234811088"><conversation-title>public chat post title</conversation-title><conversation-text>me: public&#13;
+  you: chat&#13;
+  me: post&#13;
+  you: dialogue</conversation-text><conversation><line name="me" label="me:">public&#13;</line><line name="you" label="you:">chat&#13;</line><line name="me" label="me:">post&#13;</line><line name="you" label="you:">dialogue</line></conversation><conversation-line name="me" label="me:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">public&#13;</conversation-line><conversation-line name="you" label="you:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">chat&#13;</conversation-line><conversation-line name="me" label="me:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">post&#13;</conversation-line><conversation-line name="you" label="you:" deprecated="conversation-line is deprecated and will soon be removed. Use ./conversation/line.">dialogue</conversation-line><tag>sale</tag></post><post id="78844625" url="http://dummylog.tumblr.com/post/78844625" type="link" date-gmt="2009-02-16 19:03:00 GMT" date="Mon, 16 Feb 2009 14:03:00" unix-timestamp="1234810980" private="true"><link-text>private link post name</link-text><link-url>http://www.google.com</link-url><link-description>private link post description</link-description><tag>sale</tag></post><post id="78844351" url="http://dummylog.tumblr.com/post/78844351" type="link" date-gmt="2009-02-16 19:02:00 GMT" date="Mon, 16 Feb 2009 14:02:00" unix-timestamp="1234810920"><link-text>public link post name</link-text><link-url>http://www.google.com</link-url><link-description>public link post description</link-description><tag>sale</tag></post><post id="78844076" url="http://dummylog.tumblr.com/post/78844076" type="quote" date-gmt="2009-02-16 19:01:06 GMT" date="Mon, 16 Feb 2009 14:01:06" unix-timestamp="1234810866"><quote-text>public quote post content</quote-text><quote-source>public quote post source</quote-source><tag>sale</tag></post><post id="78844136" url="http://dummylog.tumblr.com/post/78844136" type="quote" date-gmt="2009-02-16 19:01:00 GMT" date="Mon, 16 Feb 2009 14:01:00" unix-timestamp="1234810860" private="true"><quote-text>private quote post content</quote-text><quote-source>private quote post content</quote-source><tag>sale</tag></post><post id="78843778" url="http://dummylog.tumblr.com/post/78843778" type="photo" date-gmt="2009-02-16 18:59:40 GMT" date="Mon, 16 Feb 2009 13:59:40" unix-timestamp="1234810780" private="true"><photo-caption>private photo post</photo-caption><photo-url max-width="500">http://7.media.tumblr.com/TofwJxqCAk122bofvQLGsl89o1_500.jpg</photo-url><photo-url max-width="400">http://6.media.tumblr.com/TofwJxqCAk122bofvQLGsl89o1_400.jpg</photo-url><photo-url max-width="250">http://11.media.tumblr.com/TofwJxqCAk122bofvQLGsl89o1_250.jpg</photo-url><photo-url max-width="100">http://11.media.tumblr.com/TofwJxqCAk122bofvQLGsl89o1_100.jpg</photo-url><photo-url max-width="75">http://22.media.tumblr.com/TofwJxqCAk122bofvQLGsl89o1_75sq.jpg</photo-url><tag>sale</tag></post><post id="78843501" url="http://dummylog.tumblr.com/post/78843501" type="regular" date-gmt="2009-02-16 18:58:00 GMT" date="Mon, 16 Feb 2009 13:58:00" unix-timestamp="1234810680" private="true"><regular-title>private text post title</regular-title><regular-body>private text post body</regular-body><tag>sale</tag></post><post id="78841604" url="http://dummylog.tumblr.com/post/78841604" type="regular" date-gmt="2009-02-16 18:50:00 GMT" date="Mon, 16 Feb 2009 13:50:00" unix-timestamp="1234810200"><regular-title>public text post title</regular-title><regular-body>public text post body</regular-body><tag>sale</tag></post><post id="78841444" url="http://dummylog.tumblr.com/post/78841444" type="photo" date-gmt="2009-02-16 18:49:00 GMT" date="Mon, 16 Feb 2009 13:49:00" unix-timestamp="1234810140"><photo-caption>public photo post</photo-caption><photo-url max-width="500">http://21.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_500.jpg</photo-url><photo-url max-width="400">http://1.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_400.jpg</photo-url><photo-url max-width="250">http://22.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_250.jpg</photo-url><photo-url max-width="100">http://19.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_100.jpg</photo-url><photo-url max-width="75">http://2.media.tumblr.com/TofwJxqCAk11p5psVgVhLwzJo1_75sq.jpg</photo-url><tag>sale</tag></post></posts></tumblr>
+  EOF
+  response.strip!
+end
+
+def successful_authenticated_write_xml
+  "10001"
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: hexorx-rumblr
+version: !ruby/object:Gem::Version 
+  version: 0.0.3
+platform: ruby
+authors: 
+- Brent Hargrave
+- Benny Wong
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-30 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: libxml-ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.3
+    version: 
+description: Ruby client for the Tumblr API
+email: brent.hargrave@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.rdoc
+- README.rdoc
+files: 
+- .gitignore
+- LICENSE.rdoc
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/rumblr.rb
+- lib/rumblr/client.rb
+- lib/rumblr/post.rb
+- lib/rumblr/resource.rb
+- lib/rumblr/tumblelog.rb
+- lib/rumblr/user.rb
+- rumblr.gemspec
+- spec/rumblr/client_spec.rb
+- spec/rumblr/post_spec.rb
+- spec/rumblr/tumblelog_spec.rb
+- spec/rumblr/user_spec.rb
+- spec/spec_helper.rb
+has_rdoc: false
+homepage: http://github.com/jamescallmebrent/rumblr
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Ruby client for the Tumblr API
+test_files: 
+- spec/rumblr/client_spec.rb
+- spec/rumblr/post_spec.rb
+- spec/rumblr/tumblelog_spec.rb
+- spec/rumblr/user_spec.rb
+- spec/spec_helper.rb