gazette 0.1.1

data/.gitignore

@@ -0,0 +1,4 @@
+.bundle
+.yardoc
+doc
+pkg/*.gem

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem "rake"
+gem "jeweler"
+gem "yard"
+gem "bluecloth"
+
+group :test do
+  gem "fakeweb"
+  gem "rspec"
+  gem "rcov"
+end

data/Gemfile.lock

@@ -0,0 +1,30 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    bluecloth (2.0.9)
+    fakeweb (1.2.8)
+    gemcutter (0.6.1)
+    git (1.2.5)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json_pure (1.4.6)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (1.3.0)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+    yard (0.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bluecloth
+  fakeweb
+  jeweler
+  rake
+  rcov
+  rspec
+  yard

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Jeff Pollard
+
+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.md

@@ -0,0 +1,67 @@
+# Gazette
+
+Gazette is a Ruby gem to interact with the [Instapaper API](http://www.instapaper.com/api).  It offers complete functionality with all API features, including authentication and adding URLs to read later.  Gazette operates over HTTP and HTTPS, and uses (Instapaper-preferred) HTTP basic authentication.
+
+**NOTE: This gem is still in beta.  Production use not suggested, but encouraged.**
+
+## Installation
+
+At your favorite shell:
+
+    gem install gazette
+
+## Usage
+
+All interaction with the Instapaper API is done with an instance of `Gazette::Client` object.  The constructor requires one argument, the user's Instapaper email or username.  The 2nd argument is an optional hash, which can contain a `:password => "user_pass"` and/or `:https => true` if you would like to use HTTPS
+
+    @client = Gazette::Client.new("user@eample.com", :password => "seeecrets")
+    => #<Gazette::Client:0x101f41cb0 @password=nil, @https=false, @username="user@eample.com", @options={}> 
+    
+By default Gazette communicates with the Instapaper API over good 'ol HTTP.  You are strongly encouraged to use HTTPS if at all possible.
+    
+    
+### Authentication
+
+With a client in hand, you can call `@client.authenticate` to authenticate the user's credentials. Per the API documentation, authentication is totally optional.  It may be useful if you want to verify the credentials provided by a user, but is not a required step before adding URLs.
+
+    >> @client.authenticate
+    => #<Gazette::Response::Success:0x101f37260 @instapaper_title=nil, @content_location=nil>
+    
+### Responses
+    
+All valid responses to the Instapaper API return a `Gazette::Response::Success` object.  All invalid response *raise* one of the following exceptions:
+
+* `Gazette::Response::InvalidCredentials` - Invalid user credentials.
+* `Gazette::Response::ServerError` - API encountered an error. Please try again later.
+* `Gazette::Response::UnknownError` - Some other unknown error.  File a bug...maybe.
+
+Thus, for proper error checking, please `rescue` any/all of the above exceptions.
+
+### Adding URLs
+
+To add URLs to the client's Instapaper account, call `@client.add(url)`:
+
+    >> @client.add("http://patmaddox.com/blog/2010/5/9/a-response-to-unit-and-functional-tests-are-as-useful-as-100.html", :title => "How do you write 100% correct code?", :selection => "How do you guarantee an application's correctness?")
+    => #<Gazette::Response::Success:0x101f17a00 @instapaper_title="\"How do you write 100% correct code?\"", @content_location="http://patmaddox.com/blog/2010/5/9/a-response-to-unit-and-functional-tests-are-as-useful-as-100.html">
+    
+The `#add` method takes only one required parameter, a string of the URL you want to add.  The 2nd parameter is an optional hash, which can contain any of the following.  See the [Instapaper API documentation](http://www.instapaper.com/api) for details:
+
+* `:title => "string"`
+* `:selection => "string"`
+* `:redirect => :close` which attempts to close the window after a short delay.
+* `:jsonp => "string"`
+
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 Jeff Pollard. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,37 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts "!! Bundler not found.  Please run `gem install bundler` to install and preface commands with `bundle exec`"
+end
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "gazette"
+  gem.summary = %Q{Ruby library to interact with the Instapaper API.}
+  gem.description = %Q{Simple Ruby wrapper gem to interact with the Instapaper API.  Supports authenticate and add API methods, as well as https, jsonp and redirect featres of the API.}
+  gem.email = "jeff.pollard@gmail.com"
+  gem.homepage = "http://github.com/Fluxx/gazette"
+  gem.authors = ["Jeff Pollard"]
+  gem.add_development_dependency "rspec", ">= 1.2.9"
+  gem.add_development_dependency "yard", ">= 0"
+  # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+end
+Jeweler::GemcutterTasks.new
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/gazette.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{gazette}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeff Pollard"]
+  s.date = %q{2010-10-22}
+  s.description = %q{Simple Ruby wrapper gem to interact with the Instapaper API.  Supports authenticate and add API methods, as well as https, jsonp and redirect featres of the API.}
+  s.email = %q{jeff.pollard@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".gitignore",
+     "Gemfile",
+     "Gemfile.lock",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "gazette.gemspec",
+     "lib/gazette.rb",
+     "lib/gazette/api.rb",
+     "lib/gazette/client.rb",
+     "lib/gazette/response.rb",
+     "spec/client/add_spec.rb",
+     "spec/client/authenticate_spec.rb",
+     "spec/client/client_spec.rb",
+     "spec/response/success_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "todo.txt"
+  ]
+  s.homepage = %q{http://github.com/Fluxx/gazette}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Ruby library to interact with the Instapaper API.}
+  s.test_files = [
+    "spec/client/add_spec.rb",
+     "spec/client/authenticate_spec.rb",
+     "spec/client/client_spec.rb",
+     "spec/response/success_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_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

data/lib/gazette/api.rb

@@ -0,0 +1,10 @@
+module Gazette
+  module Api
+    
+    # Web address of the Instapaper API
+    ADDRESS = 'www.instapaper.com'.freeze
+    
+    # Endpoint of the Intsapper API
+    ENDPOINT = '/api/'.freeze
+  end
+end

data/lib/gazette/client.rb

@@ -0,0 +1,94 @@
+require "net/http"
+require "net/https"
+require "openssl"
+require "pp"
+
+module Gazette
+  # The Client class interacts with the Instapaper API.  Client hold user authentication
+  # information, as well as provide methods to authenticate user credentials and add URLs
+  # to their user's Instapaper account.
+  # 
+  # @author Jeff Pollard
+  # @see http://www.instapaper.com/api Instapaper-provided API documenation.
+  class Client
+    
+    attr_reader :username
+    attr_reader :password
+    
+    # Create a new client.  Instapaper requires a user username.  Most Instapaper users
+    # <b>don't</b> have a password, as such it is optional.
+    # 
+    # @param [String] username Instapaper username
+    # @param [Hash] options Additional client options
+    # @option options [String] :password Instapaper username
+    # @option options [Boolean] :https (false) Interact with the Instapaper API over
+    #  HTTPS.
+    def initialize(username, options = {})
+      raise ArgumentError.new("2nd parameter must be a Hash") unless options.is_a?(Hash)
+      @username = username
+      @password = options.delete(:password)
+      @options = options
+      @https = !!(options.delete(:https))
+    end
+    
+    # Attempts to authenticate the client's user credentials with Instapaper.
+    # 
+    # @param [Hash] options Additional authentication options
+    # @option options [String] :jsonp (nil) Returns results as JSON to the specified
+    #   Javascript callback.
+    # @return [Response::Success] Successful response from the Instapaper API.
+    # @raise [Response::InvalidCredentials]
+    # @raise [Response::ServerError]
+    # @raise [Response::UnknownError]
+    def authenticate(options = {})
+      parse_response_for request(:authenticate, options)
+    end
+    
+    # Adds a URL to a user's instapaper account.
+    # 
+    # @param [String] url URL of the content to add.
+    # @param [Hash] options Additional add options
+    # @option options [String] :title Title of the content.  If omitted, Instapaper will
+    #   generate a title.
+    # @option options [String] :select Sample/selection of content.
+    # @option options [:close] :redirect Response returns "Saved!" string and attempts to 
+    #   close its own window after a short delay.
+    # @option options [String] :jsonp (nil) Returns results as JSON to the specified
+    #   Javascript callback.
+    # @return [Response::Success] Successful response from the Instapaper API.
+    # @raise [Response::InvalidCredentials]
+    # @raise [Response::ServerError]
+    # @raise [Response::UnknownError]
+    def add(url, options = {})
+      parse_response_for request(:add, options.merge(:url => url))
+    end
+    
+    private
+    
+    # Handles the response from Instapaper.
+    # 
+    # @todo Put the raising logic in the Api class/module, then leave the response return
+    # to this method
+    def parse_response_for(response)
+      case response
+        when Net::HTTPOK, Net::HTTPCreated then return Response::Success.new(response)
+        when Net::HTTPForbidden then raise Response::InvalidCredentials
+        when Net::HTTPInternalServerError then raise Response::ServerError
+        else raise Response::UnknownError
+      end
+    end
+    
+    # Actually heads out to the internet and performs the request
+    # @todo Perhaps put me in the Api class/module?
+    def request(method, params = {})
+      http = Net::HTTP.new(Api::ADDRESS, (@https ? 443 : 80))
+      http.use_ssl = @https
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      request = Net::HTTP::Post.new(Api::ENDPOINT+method.to_s)
+      request.basic_auth @username, @password
+      request.set_form_data(params)
+      http.start { http.request(request) }
+    end
+    
+  end
+end

data/lib/gazette/response.rb

@@ -0,0 +1,39 @@
+module Gazette
+  # Container class for response from the Instapaper API.
+  # @author Jeff Pollard
+  class Response
+    # Successful response from the Instapaper API
+    # @author Jeff Pollard
+    class Success < Response
+      
+      # Final saved URL of the content returned from the Instapaper API.
+      attr_reader :content_location
+      
+      # Saved title of the content returned from the Instapaper API.
+      attr_reader :instapaper_title
+      
+      # Create a new Success object out of a net/http response.
+      def initialize(response)
+        unless response.is_a?(Net::HTTPResponse)
+          # Require a net/http response object
+          raise ArgumentError.new("Argument must be a Net::HTTPResponse object") 
+        end
+        
+        # Build our ivars from the headers
+        @content_location = response.header['Content-Location']
+        @instapaper_title = response.header['X-Instapaper-Title']
+      end
+    end
+    
+    # Response raised of the Instapaper returned a response indicating invalid user
+    # credentials.
+    class InvalidCredentials < Exception; end
+    
+    # Retponse raised if the Instapaper returned a server error (500).
+    class ServerError < Exception; end
+    
+    # Response returned if there was some other type of unknown error.
+    class UnknownError < Exception; end
+        
+  end
+end

data/lib/gazette.rb

@@ -0,0 +1,5 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require "gazette/api"
+require "gazette/client"
+require "gazette/response"

data/spec/client/add_spec.rb

@@ -0,0 +1,98 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+INTERESTING_ARTICLE = "http://blog.instapaper.com/post/1256471940"
+
+describe Gazette::Client, "#add" do
+  before(:each) do
+    # @todo Abstract me out
+    @my_post = stub_http_client('/api/add')
+    @client = Gazette::Client.new("foo")
+  end
+  
+  it "should raise an ArgumentError if no first argument is provided" do
+    lambda do
+      @client.add
+    end.should raise_error(ArgumentError)
+  end
+  
+  describe "with a 201 OK response" do
+    before(:each) do
+      stub_instapaper_api(:add => {:status => 201})
+    end
+    
+    it "returns a Gazette::Response::Success object" do
+      @client.add(INTERESTING_ARTICLE).should be_a Gazette::Response::Success
+    end
+    
+    it "calls the add instapaper API call" do
+      Net::HTTP::Post.should_receive(:new).with(/add/).and_return(@my_post)
+      @client.add(INTERESTING_ARTICLE)
+    end
+
+    describe "parameters" do
+
+      it "passes the URL as a parameter" do
+        @my_post.should_receive(:set_form_data).with(hash_including(:url => INTERESTING_ARTICLE))
+        @client.add(INTERESTING_ARTICLE)
+      end
+
+      it "passes the title as a parameter if specified" do
+        @my_post.should_receive(:set_form_data).with(hash_including(:title => "my title"))
+        @client.add(INTERESTING_ARTICLE, :title => "my title")
+      end
+
+      it "passes the selection as a parameter if specified" do
+        @my_post.should_receive(:set_form_data).with(hash_including(:selection => "read me!"))
+        @client.add(INTERESTING_ARTICLE, :selection => "read me!")
+      end
+
+      it "passes redirect as a parameter if specified" do
+        @my_post.should_receive(:set_form_data).with(hash_including(:redirect => :close))
+        @client.add(INTERESTING_ARTICLE, :redirect => :close)
+      end
+
+      it "passes the jsonp as a parameter if specified" do
+        @my_post.should_receive(:set_form_data).with(hash_including(:jsonp => "myfunc"))
+        @client.add(INTERESTING_ARTICLE, :jsonp => "myfunc")
+      end
+
+    end
+  end
+  
+  describe "with a 403 response" do
+    before(:each) do
+      stub_instapaper_api(:add => {:status => 403})
+    end
+    
+    it "rasises a Gazette::Response::InvalidCredentials" do
+      lambda { 
+        @client.add(INTERESTING_ARTICLE)
+      }.should raise_error(Gazette::Response::InvalidCredentials)
+    end
+  end
+  
+  describe "with a 500 response" do
+    before(:each) do
+      stub_instapaper_api(:add => {:status => 500})
+    end
+    
+    it "rasises a Gazette::Response::ServerError" do
+      lambda { 
+        @client.add(INTERESTING_ARTICLE)
+      }.should raise_error(Gazette::Response::ServerError)
+    end
+  end
+  
+  describe "with a XXX response" do
+    before(:each) do
+      stub_instapaper_api(:add => {:status => 999})
+    end
+    
+    it "rasises a Gazette::Response::UnknownError" do
+      lambda { 
+        @client.add(INTERESTING_ARTICLE)
+      }.should raise_error(Gazette::Response::UnknownError)
+    end
+  end
+  
+end

data/spec/client/authenticate_spec.rb

@@ -0,0 +1,60 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Gazette::Client, "#authenticate" do
+  before(:each) do
+    @client = Gazette::Client.new("foo")
+    @my_post = stub_http_client('/api/authenticate')
+  end
+    
+  describe "with a 200 OK response" do
+    before(:each) do
+      stub_instapaper_api(:authenticate => {:status => 200})
+    end
+    
+    it "returns a Gazette::Response::Success object" do
+      @client.authenticate.should be_a Gazette::Response::Success
+    end
+    
+    it "calls the 'authenticate' instapaper API call" do
+      Net::HTTP::Post.should_receive(:new).with(/authenticate/).and_return(@my_post)
+      @client.authenticate
+    end
+  end
+  
+  describe "with a 403 response" do
+    before(:each) do
+      stub_instapaper_api(:authenticate => {:status => 403})
+    end
+    
+    it "rasises a Gazette::Response::InvalidCredentials" do
+      lambda { 
+        @client.authenticate 
+      }.should raise_error(Gazette::Response::InvalidCredentials)
+    end
+  end
+  
+  describe "with a 500 response" do
+    before(:each) do
+      stub_instapaper_api(:authenticate => {:status => 500})
+    end
+    
+    it "rasises a Gazette::Response::ServerError" do
+      lambda { 
+        @client.authenticate 
+      }.should raise_error(Gazette::Response::ServerError)
+    end
+  end
+  
+  describe "with a XXX response" do
+    before(:each) do
+      stub_instapaper_api(:authenticate => {:status => 999})
+    end
+    
+    it "rasises a Gazette::Response::UnknownError" do
+      lambda { 
+        @client.authenticate 
+      }.should raise_error(Gazette::Response::UnknownError)
+    end
+  end
+
+end

data/spec/client/client_spec.rb

@@ -0,0 +1,84 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Gazette::Client, ".new" do
+
+  it "raises an error if no fist argument it passed" do
+    lambda { Gazette::Client.new }.should raise_error(ArgumentError)
+  end
+  
+  it "raises an argument error if the 2nd parameter is not a hash" do
+    lambda { Gazette::Client.new("foo", 56) }.should raise_error(ArgumentError)
+  end
+
+  shared_examples_for "a properlty constructed client" do
+    it "sets the username as the first argument" do
+      @client.username.should eql("foo")
+    end
+  end
+
+  describe "with a single string argument" do
+    before(:each) do
+      @client = Gazette::Client.new("foo")
+    end
+
+    it_should_behave_like "a properlty constructed client"
+
+    it "has no password set" do
+      @client.password.should be_nil
+    end
+
+  end
+
+  describe "with a string and hash containing a :password" do
+    before(:each) do
+      @client = Gazette::Client.new("foo", :password => "bar")
+    end
+
+    it_should_behave_like "a properlty constructed client"
+
+    it "has a password set" do
+      @client.password.should eql("bar")
+    end
+
+  end
+  
+end
+
+describe Gazette::Client, "HTTP basic auth" do
+  before(:each) do
+    stub_instapaper_api(:authenticate => {:status => 200})
+    @client = Gazette::Client.new("foo")
+    @my_post = Net::HTTP::Post.new('/api/authenticate')
+    Net::HTTP::Post.stub!(:new).and_return(@my_post)
+  end  
+  
+  it "passes along the username" do
+    @my_post.should_receive(:basic_auth).with("foo", nil)
+    @client.authenticate
+  end
+  
+  it "passes along the password if specified" do
+    @client = Gazette::Client.new("foo", :password => "bar")
+    @my_post.should_receive(:basic_auth).with("foo", "bar")
+    @client.authenticate
+  end
+  
+  it "passes the jsonp as a parameter if specified" do
+    @my_post.should_receive(:set_form_data).with(hash_including(:jsonp => "myfunc"))
+    @client.authenticate(:jsonp => "myfunc")
+  end
+end
+
+describe Gazette::Client, "over HTTPS" do
+  before(:each) do
+    @client = Gazette::Client.new("foo", :https => true)
+    stub_instapaper_api(:authenticate => {:status => 200})
+    @my_http = Net::HTTP.new(Gazette::Api::ADDRESS, 443)
+  end
+  
+  it "tells the HTTP client to use ssl" do
+    Net::HTTP.should_receive(:new).with(anything, 443).and_return(@my_http)
+    @client.authenticate
+  end
+  
+end

data/spec/response/success_spec.rb

@@ -0,0 +1,33 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Gazette::Response::Success do
+  before(:each) do
+    @response = mock("response", :is_a? => true, :header => {})
+  end
+  
+  it "raises an argument error unless the first argument is a Net::HTTPResponse object" do
+    lambda do
+      Gazette::Response::Success.new(:nonse)
+    end.should raise_error(ArgumentError)
+    
+  end
+  
+  it "has a content_location attribute" do
+    Gazette::Response::Success.new(@response).content_location.should be_nil
+  end
+
+  it "has an instapaper_title attribute" do
+    Gazette::Response::Success.new(@response).instapaper_title.should be_nil
+  end
+  
+  it "sets content_location if the 'Content-Location' header is present" do
+    @response.stub!(:header).and_return({'Content-Location' => 'http://www.example.com/'})
+    Gazette::Response::Success.new(@response).content_location.should == 'http://www.example.com/'
+  end
+  
+  it "sets instapaper_title if the 'X-Instapaper-Title' header is present" do
+    @response.stub!(:header).and_return({'X-Instapaper-Title' => 'nonse'})
+    Gazette::Response::Success.new(@response).instapaper_title.should == 'nonse'
+  end
+    
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'gazette'
+require 'spec'
+require 'spec/autorun'
+require 'fakeweb'
+
+Spec::Runner.configure do |config|
+
+end
+
+# Stubs out the instapaper API using a simple configuration syntax:
+# 
+# :method => {:hash_of => :fakeweb_options}
+def stub_instapaper_api(configuration)
+  configuration.each do |method, opts|
+    ["", "foo@", "foo:bar@"].each do |hba|
+      base = "#{hba}#{Gazette::Api::ADDRESS}#{Gazette::Api::ENDPOINT}"
+      FakeWeb.register_uri(:any, "http://"+base+method.to_s, opts.merge(:body => "lol"))
+      FakeWeb.register_uri(:any, "https://"+base+method.to_s, opts)
+    end
+  end
+end
+
+# Stubs out the HTTP client and builds a @my_post variable, which is our own mock we can
+# use to verify HTTP actions
+def stub_http_client(path)
+  @my_post = Net::HTTP::Post.new(path)
+  Net::HTTP::Post.stub!(:new).and_return(@my_post)
+  @my_post
+end

data/todo.txt

@@ -0,0 +1 @@
+- Add `gazette` bin

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification 
+name: gazette
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Jeff Pollard
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-22 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rspec
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: yard
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id002
+description: Simple Ruby wrapper gem to interact with the Instapaper API.  Supports authenticate and add API methods, as well as https, jsonp and redirect featres of the API.
+email: jeff.pollard@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- gazette.gemspec
+- lib/gazette.rb
+- lib/gazette/api.rb
+- lib/gazette/client.rb
+- lib/gazette/response.rb
+- spec/client/add_spec.rb
+- spec/client/authenticate_spec.rb
+- spec/client/client_spec.rb
+- spec/response/success_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- todo.txt
+has_rdoc: true
+homepage: http://github.com/Fluxx/gazette
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Ruby library to interact with the Instapaper API.
+test_files: 
+- spec/client/add_spec.rb
+- spec/client/authenticate_spec.rb
+- spec/client/client_spec.rb
+- spec/response/success_spec.rb
+- spec/spec_helper.rb