taobao_fu_reload 1.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [name of plugin creator]
+
+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.markdown

@@ -0,0 +1,73 @@
+### About TaobaoFu
+
+**TaobaoFu** is a Rails plugin (supports Rails 3.0.0 or above) as an unofficial Ruby SDK for the Taobao Open Platform(http://open.taobao.com/).
+
+
+### Compatibility
+
+TaobaoFu is developed against Ruby 1.8.6, 1.8.7, 1.9.1, 1.9.2
+
+
+### Installation
+
+For Rails applications add the gem dependencies to your Gemfile:
+
+    gem "taobao_fu_reload"     # Required
+
+Setup of access the TOP API is handled by using automatic configuration with a config/taobao.yml. You can generate a taobao.yml via the following command:
+
+    > rails generate taobao_fu:install
+
+An example configuration is as follows, with the default values showing:
+config/taobao.yml:
+
+    defaults: &defaults
+      app_key:          # YOUR_APP_KEY
+      secret_key:       # YOUR_APP_SECRET_TOKEN
+      session:          # TOP-Session
+      taobaoke_pid:     # YOUR_TAOBAOKE_PID
+      taobaoke_nick:    # YOUR_TAOBAOKE_NICKNAME
+
+    development:
+      <<: *defaults
+      is_sandbox: false # If true, it will work under the sandbox environment(tbsandbox.com, not taobao.com).
+      use_curl: false   # If true, it will use gem "patron" as the REST client.
+
+    test:
+      <<: *defaults
+      is_sandbox: ture
+      use_curl: false
+
+    production:
+      <<: *defaults
+      is_sandbox: false
+      use_curl: true
+
+
+### Example
+
+Here is an example shows you how to get some information of a commodity from taobao.com by using the TaobaoFu.get method.
+
+    > cd your_rails_app
+    > rails console
+    > TaobaoFu.get(:method => 'taobao.item.get',
+                   :nick   => 'simul官方旗舰店',
+                   :iid    => '3b54462a34e2ed84c330dc3e5fb4a94f',
+                   :fields => 'title, price')
+
+There are four methods mapping HTTP verbs(GET/POST/PUT/DELETE).
+
+    TaobaoFu.get    #(Available)
+    TaobaoFu.post
+    TaobaoFu.update
+    TaobaoFu.delete
+
+There is also an additional method is using for switching between sandbox and production environment of TOP. For instance:
+
+    TaobaoFu.switch_to(TaobaoFu::SANDBOX) # switching to sandbox(tbsandbox.com)
+    TaobaoFu.switch_to(TaobaoFu::PRODBOX) # back to production environment(taobao.com)
+
+
+### Copyright
+
+Copyright (c) 2010 why404(why404#gmail), reloaded 2012 NIOTEAM, released under the MIT license.

data/Rakefile

@@ -0,0 +1,28 @@
+require 'rake'
+require 'rake/gempackagetask'
+
+PKG_FILES = FileList[
+  '[a-zA-Z-]*', 
+  'generators/**/*', 
+  'lib/**/*'
+]
+
+spec = Gem::Specification.new do |s|
+  s.name = "taobao_fu" 
+  s.version = "1.0.0.beta5" 
+  s.author = "why404" 
+  s.email = "why404@gmail.com" 
+  s.homepage = "http://rubygems.org/gems/taobao_fu" 
+  s.platform = Gem::Platform::RUBY 
+  s.summary = "Ruby SDK for the Taobao Open Platform" 
+  s.description = "TaobaoFu is a Ruby gem (also can be a Rails plugin, supports Rails 3.0.0 or above) as an unofficial Ruby SDK for the Taobao Open Platform(http://open.taobao.com/)."
+  s.files = PKG_FILES.to_a 
+  s.require_path = "lib" 
+  s.has_rdoc = false 
+  s.extra_rdoc_files = ["README.markdown"] 
+  s.add_dependency("crack", ">= 0.1.7")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end

data/lib/generators/taobao_fu/USAGE

@@ -0,0 +1,3 @@
+To copy a TaobaoFu initializer to your Rails App, with some configuration values, just do:
+
+    rails generate taobao_fu:install

data/lib/generators/taobao_fu/install_generator.rb

@@ -0,0 +1,13 @@
+module TaobaoFu
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Copy TaobaoFu default files"
+      source_root File.expand_path('../templates', __FILE__)
+      class_option :template_engine
+
+      def copy_config
+        directory 'config'
+      end
+    end
+  end
+end

data/lib/generators/taobao_fu/templates/config/initializers/taobao_fu.rb

@@ -0,0 +1,7 @@
+require 'taobao_fu'
+
+require 'yaml'
+YAML::ENGINE.yamler = 'syck'
+
+config_file = File.join(Rails.root, "config", "taobao.yml")
+TaobaoFu.load(config_file) if FileTest::exists?(config_file)

data/lib/generators/taobao_fu/templates/config/taobao.yml

@@ -0,0 +1,21 @@
+defaults: &defaults
+  app_key:          # YOUR_APP_KEY
+  secret_key:       # YOUR_APP_SECRET_TOKEN
+  session:          # TOP-Session
+  taobaoke_pid:     # YOUR_TAOBAOKE_PID
+  taobaoke_nick:    # YOUR_TAOBAOKE_NICKNAME
+
+development:
+  <<: *defaults
+  is_sandbox: false # If true, it will work under the sandbox environment(tbsandbox.com, not taobao.com).
+  use_curl: false   # If true, it will use gem "patron" as the REST client.
+
+test:
+  <<: *defaults
+  is_sandbox: ture
+  use_curl: false
+
+production:
+  <<: *defaults
+  is_sandbox: false
+  use_curl: true

data/lib/rest.rb

@@ -0,0 +1,95 @@
+require "uri"
+require "net/http"
+
+module TaobaoFu
+  module Rest
+    class << self
+      def get(url, hashed_vars)
+        res = request(url, 'GET', hashed_vars)
+        process_result(res, url)
+      end
+
+      def post(url, hashed_vars)
+        res = request(url, 'POST', hashed_vars)
+        process_result(res, url)
+      end
+
+      def put(url, hashed_vars)
+        res = request(url, 'PUT', hashed_vars)
+        process_result(res, url)
+      end
+
+      def delete(url, hashed_vars)
+        res = request(url, 'DELETE', hashed_vars)
+        process_result(res, url)
+      end
+
+      protected
+
+        def request(url, method=nil, params = {})
+          if !url || url.length < 1
+            raise ArgumentError, 'Invalid url parameter'
+          end
+          if method && !['GET', 'POST', 'DELETE', 'PUT'].include?(method)
+            raise NotImplementedError, 'HTTP %s not implemented' % method
+          end
+
+          if method && method == 'GET'
+            url = build_get_uri(url, params)
+          end
+          uri = URI.parse(url)
+
+          http = Net::HTTP.new(uri.host, uri.port)
+
+          if method && method == 'GET'
+            req = Net::HTTP::Get.new(uri.request_uri)
+          elsif method && method == 'DELETE'
+            req = Net::HTTP::Delete.new(uri.request_uri)
+          elsif method && method == 'PUT'
+            req = Net::HTTP::Put.new(uri.request_uri)
+            req.set_form_data(params)
+          else
+            req = Net::HTTP::Post.new(uri.request_uri)
+            req.set_form_data(params)
+          end
+
+          http.request(req)
+        end
+
+        def build_get_uri(uri, params)
+          if params && params.length > 0
+            uri += '?' unless uri.include?('?')
+            uri += urlencode(params)
+          end
+          URI.escape(uri)
+        end
+
+        def urlencode(params)
+          params.to_a.collect! { |k, v| "#{k.to_s}=#{v.to_s}" }.join("&")
+        end
+
+        def process_result(res, raw_url)
+          if res.code =~ /\A2\d{2}\z/
+            res.body
+          elsif %w(301 302 303).include? res.code
+            url = res.header['Location']
+            if url !~ /^http/
+              uri = URI.parse(raw_url)
+              uri.path = "/#{url}".squeeze('/')
+              url = uri.to_s
+            end
+            raise RuntimeError, "Redirect #{url}"
+          elsif res.code == "304"
+            raise RuntimeError, "NotModified #{res}"
+          elsif res.code == "401"
+            raise RuntimeError, "Unauthorized #{res}"
+          elsif res.code == "404"
+            raise RuntimeError, "Resource not found #{res}"
+          else
+            raise RuntimeError, "Maybe request timed out #{res}. HTTP status code #{res.code}"
+          end
+        end
+
+    end
+  end
+end

data/lib/taobao_fu.rb

@@ -0,0 +1,104 @@
+begin
+  require "crack"
+rescue LoadError
+  puts "The Crack gem is not available.\nIf you ran this command from a git checkout " \
+       "of Rails, please make sure crack is installed. \n "
+  exit
+end
+# require "patron"
+require "digest/md5"
+require "yaml"
+require "uri"
+require "rest"
+
+module TaobaoFu
+
+  SANDBOX = 'http://gw.api.tbsandbox.com/router/rest?'
+  PRODBOX = 'http://gw.api.taobao.com/router/rest?'
+  USER_AGENT = 'why404-taobao_fu/1.0.0.beta5'
+  REQUEST_TIMEOUT = 10
+  API_VERSION = 2.0
+  SIGN_ALGORITHM = 'md5'
+  OUTPUT_FORMAT = 'json'
+
+  class << self
+    def load(config_file)
+      @settings = YAML.load_file(config_file)
+      @settings = @settings[Rails.env] if defined? Rails.env
+      apply_settings
+    end
+
+    def apply_settings
+      ENV['TAOBAO_API_KEY']    = @settings['app_key'].to_s
+      ENV['TAOBAO_SECRET_KEY'] = @settings['secret_key']
+      ENV['TAOBAOKE_PID']      = @settings['taobaoke_pid']
+      @base_url                = @settings['is_sandbox'] ? SANDBOX : PRODBOX
+
+      initialize_session if @settings['use_curl']
+    end
+
+    def initialize_session
+      @sess = Patron::Session.new
+      @sess.base_url = @base_url
+      @sess.headers['User-Agent'] = USER_AGENT
+      @sess.timeout = REQUEST_TIMEOUT
+    end
+
+    def switch_to(sandbox_or_prodbox)
+      @base_url = sandbox_or_prodbox
+      @sess.base_url = @base_url if @sess
+    end
+
+    def get(options = {})
+      if @sess
+        @response = @sess.get(generate_query_string(sorted_params(options))).body
+      else
+        @response = TaobaoFu::Rest.get(@base_url, generate_query_vars(sorted_params(options)))
+      end
+      parse_result @response
+    end
+
+    # http://toland.github.com/patron/
+    def post(options = {})
+    end
+
+    def update(options = {})
+    end
+
+    def delete(options = {})
+    end
+
+    def sorted_params(options)
+      {
+        :app_key     => @settings['app_key'],
+        :session     => @settings['session'],
+        :format      => OUTPUT_FORMAT,
+        :v           => API_VERSION,
+        :sign_method => SIGN_ALGORITHM,
+        :timestamp   => Time.now.strftime("%Y-%m-%d %H:%M:%S")
+      }.merge!(options)
+    end
+
+    def generate_query_vars(params)
+      params[:sign] = generate_sign(params.sort_by { |k,v| k.to_s }.flatten.join)
+      params
+    end
+
+    def generate_query_string(params)
+      params_array = params.sort_by { |k,v| k.to_s }
+      sign_token = generate_sign(params_array.flatten.join)
+      total_param = params_array.map { |key, value| key.to_s+"="+value.to_s } + ["sign=#{sign_token}"]
+      URI.escape(total_param.join("&"))
+    end
+
+    def generate_sign(param_string)
+      Digest::MD5.hexdigest(@settings['secret_key'] + param_string + @settings['secret_key']).upcase
+    end
+
+    def parse_result(data)
+      Crack::JSON.parse(data)
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: taobao_fu_reload
+version: !ruby/object:Gem::Version
+  version: '1.1'
+  prerelease: 
+platform: ruby
+authors:
+- nioteam
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: crack
+  requirement: &70361236937180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+  type: :runtime
+  prerelease: false
+  version_requirements: *70361236937180
+description: long live the taobao_fu!
+email: info@networking.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.markdown
+- Rakefile
+- lib/generators/taobao_fu/install_generator.rb
+- lib/generators/taobao_fu/templates/config/initializers/taobao_fu.rb
+- lib/generators/taobao_fu/templates/config/taobao.yml
+- lib/generators/taobao_fu/USAGE
+- lib/rest.rb
+- lib/taobao_fu.rb
+homepage: http://www.networking.io
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: taobao_fu reloaded!
+test_files: []