posterboard 0.1.0 → 0.2.0

data/README.rdoc

@@ -1,21 +1,28 @@
 = posterboard
 
-Ruby API for reading posts from your Posterous account.
+Ruby API for reading posts from Posterous accounts.
 
 == How To
 Install the gem
-[sudo] gem install posterboard
+  [sudo] gem install posterboard
 
 Create a connection
-connection = Posterboard::Connection.new('turkey2000', 'g0bbl3g0bbl3')
+  connection = Posterboard::Connection.new('turkey2000', 'g0bbl3g0bbl3')
 
 Get posts by site name
-connection.turkey_blog.each do |post|
-  title = post[:title]
-  body = post[:body]
-end
+  posts = connection.turkey_blog
+
+Get the posts' data...
+  posts.each do |post|
+    title = post.title
+    body = post.body
+  end
+  
+...and do your thing!
 
 == Future features
+* Posts by tag.
+* Posts by Date range?
 * Command line tools for retrieving API token and site id. Library interfaces accepting these constants so they are not looked up on each request.
 
 == Note

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/lib/posterboard/connection.rb

@@ -1,5 +1,6 @@
 require 'httparty'
 require 'json'
+require 'logger'
 
 module Posterboard
   class Connection
@@ -11,19 +12,29 @@ module Posterboard
       # get the API token
       response = Connection.get('/auth/token')
       Connection.default_params :api_token => response['api_token']
+
+      @logger = ::Logger.new(STDOUT)
+      @logger.level = ::Logger::DEBUG
+      @logger.debug("Created logger")
     end
   
     # try to find posts on a site with a name that matches the method name
     # posts are returned as an array of hashes each with a :title and :body
     def method_missing(name)
-      site = sites.find { |site| site['name'] == name.to_s }
-      # => TODO : Error checking that site is valid and has "id".
+      @logger.debug "Looking for site (#{name})."
+      site = sites.find do |site| 
+        @logger.debug "Found (#{site["name"]})."
+        site['name'] == name.to_s
+      end
+      raise SiteNotFoundError unless site
+      raise MissingSiteIDError, "Is the Posterous service broken?" unless site.key? "id"
       response = Connection.get("/users/me/sites/#{site["id"]}/posts")
-      posts = [] 
+      posts = []
       ::JSON.parse(response.body).each do |body|  
-        post = {}
-        post[:title] = body['title']
-        post[:body] = body['body_full']
+        # => TODO: BlankSlate and define these as methods on post, i.e. post.title, or use OpenStruct
+        post = OpenStruct.new
+        post.title = body['title']
+        post.body = body['body_full']
         posts << post
       end
       posts

data/lib/posterboard/error.rb

@@ -0,0 +1,7 @@
+module Posterboard
+  class SiteNotFoundError < Exception
+  end
+  
+  class MissingSiteIDError < Exception
+  end
+end

data/lib/posterboard.rb

@@ -1 +1,2 @@
 require 'posterboard/connection'
+require 'posterboard/error'

data/posterboard.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{posterboard}
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Waylon Calabrese"]
-  s.date = %q{2011-05-11}
+  s.date = %q{2011-05-12}
   s.description = %q{Ruby API for reading posts from your Posterous account.}
   s.email = %q{hiwaylon@gmail.com}
   s.extra_rdoc_files = [
@@ -27,6 +27,7 @@ Gem::Specification.new do |s|
     "VERSION",
     "lib/posterboard.rb",
     "lib/posterboard/connection.rb",
+    "lib/posterboard/error.rb",
     "posterboard.gemspec",
     "spec/posterboard/connection_spec.rb",
     "spec/spec_helper.rb"

data/spec/posterboard/connection_spec.rb

@@ -30,10 +30,29 @@ describe Posterboard::Connection do
 
     it "should should give access to the posts' data" do
       @connection.your_site_name.each do |post|
-        post[:title].should_not be_nil
-        post[:body].should_not be_nil
+        post.title.should_not be_nil
+        post.body.should_not be_nil
       end
     end
   end
+
+  context "when something goes wrong" do
+    it "should raise an error when requesting a site that does not exist" do
+      stub_request(:get, "http://user:pass@www.posterous.com/api/2/users/me/sites?api_token=").
+        to_return(:status => 200, 
+                  :body => [{"id" => "5432", "name" => "this_one"}, {"id" => "9876", "name" => "that_one"}])
+      
+      lambda {@connection.but_not_this}.should raise_error(Posterboard::SiteNotFoundError)
+    end
+
+    it "should raise an error when the API returns a site without an id" do
+      stub_request(:get, "http://user:pass@www.posterous.com/api/2/users/me/sites?api_token=").
+        to_return(:status => 200, 
+                  :body => [{"id" => "99", "name" => "a_good_one"}, {"name" => "bad_site", "pointless" => "parameter"}])
+      
+      lambda {@connection.bad_site}.should raise_error(Posterboard::MissingSiteIDError)
+    end
+  end
+
 end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: posterboard
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Waylon Calabrese
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-11 00:00:00 -05:00
+date: 2011-05-12 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -148,6 +148,7 @@ files:
 - VERSION
 - lib/posterboard.rb
 - lib/posterboard/connection.rb
+- lib/posterboard/error.rb
 - posterboard.gemspec
 - spec/posterboard/connection_spec.rb
 - spec/spec_helper.rb