instapaper_full 0.0.2

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+.*.sw*
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in instapaper_full.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2011 Matt Biddulph
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. The name of the author may not be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,14 @@
+# instapaper_full
+
+Ruby wrapper for the [Instapaper Full API](http://www.instapaper.com/api/full)
+
+Draft version.
+
+Note that you need to [request OAuth Application tokens manually](http://www.instapaper.com/main/request_oauth_consumer_token) and that most methods only work for Instapaper subscribers.
+
+# Examples
+
+    ip = InstapaperFull::API.new :consumer_key => "my key", :consumer_secret => "my secret"
+    ip.authenticate "someone@example.com", "password"
+    puts ip.options.user_id
+    puts ip.bookmarks_list(:limit => 1)[0]['url']

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/instapaper_full.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "instapaper_full/version"
+
+Gem::Specification.new do |s|
+  s.name        = "instapaper_full"
+  s.version     = InstapaperFull::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Matt Biddulph"]
+  s.email       = ["mb@hackdiary.com"]
+  s.homepage    = "https://github.com/mattb/instapaper_full"
+  s.summary     = %q{Wrapper for the Instapaper Full Developer API}
+  s.description = %q{See http://www.instapaper.com/api/full}
+
+  s.rubyforge_project = "instapaper_full"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency("faraday", ">=0.5.5")
+  s.add_dependency("simple_oauth", ">=0.1.4")
+  s.add_dependency("yajl-ruby",">=0.8.1")
+end

data/lib/faraday/oauth.rb

@@ -0,0 +1,22 @@
+require 'faraday'
+require 'simple_oauth'
+
+# @private
+module Faraday
+  # @private
+  class Request::OAuth < Faraday::Middleware
+    def call(env)
+      params = env[:body].is_a?(Hash) ? env[:body] : {}
+      signature_params = params.reject{|k,v| v.respond_to?(:content_type) }
+      header = SimpleOAuth::Header.new(env[:method], env[:url], signature_params, @options)
+
+      env[:request_headers]['Authorization'] = header.to_s
+
+      @app.call(env)
+    end
+
+    def initialize(app, options)
+      @app, @options = app, options
+    end
+  end
+end

data/lib/instapaper_full.rb

@@ -0,0 +1,131 @@
+require 'faraday/oauth'
+
+module InstapaperFull
+  class API
+    attr_accessor :options
+    def initialize(options={})
+      @options = options
+    end
+
+    def connection
+      options = {
+        :proxy => @options[:proxy],
+        :ssl => {:verify => false},
+        :url => "https://www.instapaper.com/api/1/"
+      }
+      oauth_options = { 
+        :consumer_key => @options[:consumer_key],
+        :consumer_secret => @options[:consumer_secret]
+      }
+      if authenticated?
+        oauth_options[:token] = @options[:oauth_token]
+        oauth_options[:token_secret] = @options[:oauth_token_secret]
+      end
+      
+      Faraday::Connection.new(options) do |builder|
+        builder.use Faraday::Request::OAuth, oauth_options
+        builder.adapter Faraday.default_adapter
+        if authenticated?
+          builder.response :yajl
+        end
+      end
+    end
+
+    def authenticated?
+      @options.has_key? :oauth_token and @options.has_key? :oauth_token_secret
+    end
+
+    def authenticate(username,password)
+      @options.delete(:oauth_token)
+      @options.delete(:oauth_token_secret)
+      result = connection.post 'oauth/access_token' do |r| 
+        r.body = { :x_auth_username => username, :x_auth_password => password, :x_auth_mode => "client_auth" }
+      end
+      if result.status == 200
+        data = CGI.parse(result.body)
+        if data.has_key? 'oauth_token_secret'
+          @options[:oauth_token] = data['oauth_token'][0]
+          @options[:oauth_token_secret] = data['oauth_token_secret'][0]
+          verify_credentials.each { |k,v|
+            @options[k.to_sym] = v if k != 'type'
+          }
+        end
+        return true
+      else
+        return false
+      end
+    end
+
+    def call(method, body = nil)
+      result = connection.post(method) do |r|
+        if body
+          r.body = body
+        end
+      end
+      if result.status == 200
+        return result.body
+      end
+      return nil
+    end
+
+    def verify_credentials
+      call('account/verify_credentials')[0]
+    end
+
+    def bookmarks_list(options=nil)
+      call('bookmarks/list', options)[2..-1] # slice off the 'meta' and 'user' from the front of the array
+    end
+
+    def bookmarks_update_read_progress(options=nil)
+      call('bookmarks/update_read_progress', options)
+    end
+
+    def bookmarks_add(options=nil)
+      call('bookmarks/add')
+    end
+
+    def bookmarks_delete(options=nil)
+      call('bookmarks/delete', options)
+    end
+
+    def bookmarks_star(options=nil)
+      call('bookmarks/star', options)
+    end
+
+    def bookmarks_unstar(options=nil)
+      call('bookmarks/unstar', options)
+    end
+
+    def bookmarks_archive(options=nil)
+      call('bookmarks/archive', options)
+    end
+
+    def bookmarks_unarchive(options=nil)
+      call('bookmarks/unarchive', options)
+    end
+
+    def bookmarks_move(options=nil)
+      call('bookmarks/move', options)
+    end
+
+    def bookmarks_get_text(options=nil)
+      call('bookmarks/get_text', options)
+    end
+
+    def folders_list
+      call('folders/list')
+    end
+
+    def folders_add(options=nil)
+      call('folders/add', options)
+    end
+
+    def folders_delete(options=nil)
+      call('folders/delete', options)
+    end
+
+    def folders_set_order(options=nil)
+      call('folders/set_order', options)
+    end
+  end
+end

data/lib/instapaper_full/version.rb

@@ -0,0 +1,3 @@
+module InstapaperFull
+  VERSION = "0.0.2"
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: instapaper_full
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Matt Biddulph
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-15 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: faraday
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 0
+        - 5
+        - 5
+        version: 0.5.5
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: simple_oauth
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 1
+        - 4
+        version: 0.1.4
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 61
+        segments: 
+        - 0
+        - 8
+        - 1
+        version: 0.8.1
+  type: :runtime
+  version_requirements: *id003
+description: See http://www.instapaper.com/api/full
+email: 
+- mb@hackdiary.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- instapaper_full.gemspec
+- lib/faraday/oauth.rb
+- lib/instapaper_full.rb
+- lib/instapaper_full/version.rb
+has_rdoc: true
+homepage: https://github.com/mattb/instapaper_full
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: instapaper_full
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Wrapper for the Instapaper Full Developer API
+test_files: []
+