pixallent-fetchapi-ruby 0.2.2

data/CHANGELOG

@@ -0,0 +1,7 @@
+v.0.2.2 Order support
+
+v.0.2.1 Prelim rework
+
+v.0.2 Functionality for Downloads and Account
+
+v.0.1 Functionality for Orders and Items

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) <year> <copyright holders>
+
+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/Manifest

@@ -0,0 +1,18 @@
+CHANGELOG
+fetchapi-ruby.gemspec
+init.rb
+lib/fetchapi/account.rb
+lib/fetchapi/base.rb
+lib/fetchapi/download.rb
+lib/fetchapi/item.rb
+lib/fetchapi/order.rb
+lib/fetchapi-ruby.rb
+LICENSE
+Manifest
+Rakefile
+README
+spec/account_spec.rb
+spec/base_spec.rb
+spec/download_spec.rb
+spec/item_spec.rb
+spec/order_spec.rb

data/README

@@ -0,0 +1,9 @@
+== Installation                                                              
+
+	gem install pixallent-fetchapi-ruby                                                   
+
+== Usage
+
+	FetchAPI::Base.basic_auth('youraccount.fetchapp.com', 'demokey', 'demotoken')
+   FetchAPI::Item.find("ABC0001")
+	FetchAPI::Order.create(:id => "1015", :title => "Test Order", :first_name => "Donald", :last_name => "Duck", :email => "donald@duck.com", :order_items => [{:sku => 'ABC0001'}, {:sku => 'ABC0002}])

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('fetchapi-ruby', '0.2.2') do |p|
+  p.description    = "Integrate your site with http://fetchapp.com for seamless digital delivery."
+  p.url            = "http://github.com/pixallent/fetchapi-ruby"
+  p.author         = ["Thomas Reynolds, Michael Larkin"]
+  p.email          = "mikelarkin@pixallent.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+  p.runtime_dependencies = ["httparty"]
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/fetchapi-ruby.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{fetchapi-ruby}
+  s.version = "0.2.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Thomas Reynolds, Michael Larkin"]
+  s.date = %q{2009-05-01}
+  s.description = %q{Integrate your site with http://fetchapp.com for seamless digital delivery.}
+  s.email = %q{mikelarkin@pixallent.com}
+  s.extra_rdoc_files = ["CHANGELOG", "lib/fetchapi/account.rb", "lib/fetchapi/base.rb", "lib/fetchapi/download.rb", "lib/fetchapi/item.rb", "lib/fetchapi/order.rb", "lib/fetchapi-ruby.rb", "LICENSE", "README"]
+  s.files = ["CHANGELOG", "fetchapi-ruby.gemspec", "init.rb", "lib/fetchapi/account.rb", "lib/fetchapi/base.rb", "lib/fetchapi/download.rb", "lib/fetchapi/item.rb", "lib/fetchapi/order.rb", "lib/fetchapi-ruby.rb", "LICENSE", "Manifest", "Rakefile", "README", "spec/account_spec.rb", "spec/base_spec.rb", "spec/download_spec.rb", "spec/item_spec.rb", "spec/order_spec.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/pixallent/fetchapi-ruby}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Fetchapi-ruby", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{fetchapi-ruby}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Integrate your site with http://fetchapp.com for seamless digital delivery.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+require 'fetchapi-ruby'

data/lib/fetchapi/account.rb

@@ -0,0 +1,20 @@
+module FetchAPI
+  class Account < FetchAPI::Base
+    #--
+    ################ Class Methods ###############
+    #--    
+
+    # Retrieves information about the Account
+    def self.details
+      execute(:get, "/account")
+    end
+
+    # Generates a new API token.  Subsequent API calls using the
+    # existing token will be refused.
+    def self.new_token
+      execute(:get, "/new_token")
+    end
+
+  end
+
+end

data/lib/fetchapi/base.rb

@@ -0,0 +1,78 @@
+module FetchAPI
+  class Base
+    
+	 def initialize(id_or_attributes)  
+      case id_or_attributes
+      when Integer, String
+        @attributes = get("/#{self.class.pluralized_class_name}/#{id_or_attributes.to_s}")
+		  @attributes = @attributes[self.class.singularized_class_name]
+		  @id = @attributes['id']
+      when Hash
+        @attributes = id_or_attributes
+		  @id = id_or_attributes['id']
+      end
+    end
+
+    def self.find(selector, params={})
+      case selector
+      when :all
+        execute(:get, "/#{pluralized_class_name}")[pluralized_class_name].map { |data| new(data) }
+      when Integer, String
+        new(selector)
+      end
+    end
+
+    class Connector
+      include HTTParty
+      format :xml
+    end
+
+    # Initializes the connection
+    def self.basic_auth(url, key, token)
+      Connector.base_uri(url)
+      Connector.basic_auth(key, token)
+    end
+
+    protected
+    def self.singularized_class_name
+      ancestors.first.to_s.split('::').last.downcase
+    end
+    def self.pluralized_class_name
+      ancestors.first.to_s.split('::').last.downcase << 's'
+    end
+
+    def post(*args);   self.class.execute(:post, *args); end
+    def get(*args);    self.class.execute(:get, *args); end
+    def delete(*args); self.class.execute(:delete, *args); end
+    def put(*args);    self.class.execute(:put, *args); end
+
+    # Do HTTP request, handle errors
+    def self.execute(action, path, options = {})
+      handle_response(Connector.send(action, path, :query => options))
+      #Connector.send(action, path, options)
+    end
+
+    def self.handle_response(response)
+      case response.code
+      when 100..199 then response
+      when 200..299 then response
+      when 300.399 then
+        raise(response.messsage)
+      when 400..499 then
+        raise(response.message)
+      when 500..599 then 
+			raise(response.message)
+      else
+        raise("Unknown Response")
+      end
+
+    end
+
+
+    # Access attributes as class methods of the Item object
+    def method_missing(method)
+      return super unless attributes.has_key?(method.to_s)
+      attributes[method.to_s]
+    end
+  end
+end

data/lib/fetchapi/download.rb

@@ -0,0 +1,5 @@
+module FetchAPI
+  class Download < FetchAPI::Base
+    attr_accessor :id, :attributes
+  end
+end

data/lib/fetchapi/item.rb

@@ -0,0 +1,36 @@
+module FetchAPI
+  class Item < FetchAPI::Base
+	attr_accessor :attributes
+
+    def initialize(id_or_attributes)
+      case id_or_attributes
+      when Integer, String
+        @attributes = get("/#{self.class.pluralized_class_name}/#{id_or_attributes.to_s}")
+        @attributes = @attributes[self.class.singularized_class_name]
+      when Hash
+        @attributes = id_or_attributes
+      end
+    end
+
+    #--
+    ################ Class Methods ###############
+    #--
+    def self.create(options)
+      execute(:post, "/items/create", :item => options)
+    end
+
+    #--
+    ################# Instance Methods ###############
+    #--
+
+    def destroy
+      delete("/items/#{sku}/delete")
+    end
+
+    def update(options)
+      put("/items/#{sku}", :item => options)
+    end
+
+
+  end
+end

data/lib/fetchapi/order.rb

@@ -0,0 +1,60 @@
+module FetchAPI
+
+  class Order < FetchAPI::Base
+    attr_accessor :id, :attributes
+
+    #--
+    ################ Class Methods ###############
+    #--
+
+    def self.find(selector, params={})
+      case selector
+      when :current
+        params.merge!(:filter => "current")
+        execute(:get, "/#{pluralized_class_name}?#{params.to_params}")[pluralized_class_name].map { |data| new(data) }
+      when :manual
+        params.merge!(:filter => "manual")
+        execute(:get, "/#{pluralized_class_name}?#{params.to_params}")[pluralized_class_name].map { |data| new(data) }
+      when :expired
+        params.merge!(:filter => "expired")
+        execute(:get, "/#{pluralized_class_name}?#{params.to_params}")[pluralized_class_name].map { |data| new(data) }
+      else
+        super
+      end
+    end
+
+    # Creates a new order
+    def self.create(options={})
+      execute(:post, "/orders/create", :order => options)
+    end
+
+    #--
+    ################# Instance Methods ###############
+    #--
+
+    # Permanently deletes the order
+    def destroy
+      delete("/orders/#{id}/delete")
+    end
+
+    # Sets the expiration date to Time.now, stopping future downloads
+    def expire
+      post("/orders/#{id}/expire")
+    end
+
+    # Delivers the email containing the download instructions.
+    # Optional params:
+    #   reset_expiration (true/false):  Reset the order's expiration. Defaults to true.
+    #   expiration_date (2009-04-30T15:03:46+00:00): Manually sets the order's expiration date
+    def send_email(options={})
+      post("/orders/#{id}/send_email", options)
+    end
+
+    # Immediately updates the order with the new parameters
+    def update(options={})
+      put("/orders/#{id}", :order => options)
+    end
+
+
+  end
+end

data/lib/fetchapi-ruby.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'httparty'
+require 'net/http'
+
+$:.unshift(File.dirname(__FILE__))
+require 'fetchapi/base'
+require 'fetchapi/account'
+require 'fetchapi/download'
+require 'fetchapi/item'
+require 'fetchapi/order'

data/spec/account_spec.rb

@@ -0,0 +1,9 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "fetchapi-ruby")
+include FetchAPI
+
+describe Account do
+  before do
+    Base.basic_auth('http://pixallent.myhost.dev:3000/api', 'pixallent', 'pixallent')
+  end
+
+end

data/spec/base_spec.rb

@@ -0,0 +1,14 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "fetchapi-ruby")
+include FetchAPI
+
+describe Base do
+
+  before do
+	Base.basic_auth('http://pixallent.myhost.dev:3000/api', 'pixallent', 'pixallent')
+  end
+
+  it "should catch invalid login" do
+    Base.basic_auth('http://pixallent.myhost.dev:3000/api', 'bad', 'login')
+    lambda {Account.details}.should raise_error("Unauthorized")
+  end
+end

data/spec/download_spec.rb

@@ -0,0 +1,20 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "fetchapi-ruby")
+include FetchAPI
+
+
+describe Download do
+  before do
+	Base.basic_auth('http://pixallent.myhost.dev:3000/api', 'pixallent', 'pixallent')
+  end
+  
+
+it "should find by id" do
+    Download.find(37).id.to_s.should == "37"
+  end            
+
+
+  it "should find all" do
+	 d = Download.find(:all)
+    d.class.should == Array
+  end
+end

data/spec/item_spec.rb

@@ -0,0 +1,17 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "fetchapi-ruby")
+include FetchAPI
+
+describe Item do
+  before do
+    Base.basic_auth('http://pixallent.myhost.dev:3000/api', 'pixallent', 'pixallent')
+  end
+
+
+  it "should find by id" do
+    i = Item.find('CATALOG').sku.should == "CATALOG"
+  end
+
+  it "should find all" do
+    Item.find(:all).length.should > 0
+  end
+end

data/spec/order_spec.rb

@@ -0,0 +1,50 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "fetchapi-ruby")
+include FetchAPI
+
+describe Order do
+  before do
+    Base.basic_auth('http://pixallent.myhost.dev:3000/api', 'pixallent', 'pixallent')
+  end
+
+  it "should update title" do
+    order = Order.find('1001')
+    order.update(:first_name => "Daffy")
+    order = Order.find('1001')  
+    order.first_name.should == "Daffy"
+  end
+
+  it "should create an order" do
+	begin
+	 Order.find('1015').destroy
+	rescue
+	end
+    Order.create(:id => "1015", :title => "Test Order", :first_name => "Donald", :last_name => "Duck", :email => "donald@duck.com", :order_items => [{:sku => 'BIZCARD'}, {:sku => "CATALOG"}])
+    order = Order.find('1015')
+    order.id.to_s.should == "1015"
+  end
+
+  it "should delete an order" do
+	Order.create(:id => "1016", :title => "Test Order", :first_name => "Donald", :last_name => "Duck", :email => "donald@duck.com", :download_limit => "4")
+    order = Order.find('1016')
+    order.destroy
+    lambda {Order.find('1016')}.should raise_error("Not Found")
+  end
+
+  it "should find all" do
+    Order.find(:all).length.should > 0
+  end
+
+	it "should find current" do
+	  Order.find(:current).length.should > 0 
+	end
+
+	it "should find manual" do
+	  Order.find(:manual).length.should > 0 
+	end
+
+	it "should find expired" do
+	  Order.find(:expired).length.should > 0 
+	end
+
+
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: pixallent-fetchapi-ruby
+version: !ruby/object:Gem::Version 
+  version: 0.2.2
+platform: ruby
+authors: 
+- Thomas Reynolds, Michael Larkin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-01 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Integrate your site with http://fetchapp.com for seamless digital delivery.
+email: mikelarkin@pixallent.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/fetchapi/account.rb
+- lib/fetchapi/base.rb
+- lib/fetchapi/download.rb
+- lib/fetchapi/item.rb
+- lib/fetchapi/order.rb
+- lib/fetchapi-ruby.rb
+- LICENSE
+- README
+files: 
+- CHANGELOG
+- fetchapi-ruby.gemspec
+- init.rb
+- lib/fetchapi/account.rb
+- lib/fetchapi/base.rb
+- lib/fetchapi/download.rb
+- lib/fetchapi/item.rb
+- lib/fetchapi/order.rb
+- lib/fetchapi-ruby.rb
+- LICENSE
+- Manifest
+- Rakefile
+- README
+- spec/account_spec.rb
+- spec/base_spec.rb
+- spec/download_spec.rb
+- spec/item_spec.rb
+- spec/order_spec.rb
+has_rdoc: true
+homepage: http://github.com/pixallent/fetchapi-ruby
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Fetchapi-ruby
+- --main
+- README
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: fetchapi-ruby
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Integrate your site with http://fetchapp.com for seamless digital delivery.
+test_files: []
+