top4r 0.0.24

data/CHANGES

@@ -0,0 +1,5 @@
+=== 0.0.1 / 2009-06-22
+ 
+* 1 major enhancement
+ 
+  * Birthday!

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Nowa Zhu <nowazhu@gmail.com>, http://nowa.me.
+ 
+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

@@ -0,0 +1,20 @@
+= TOP4R
+ 
+* http://top4r.labs.nowa.me
+* Thanks Twitter4R <http://twitter4r.rubyforge.org>.
+ 
+== DESCRIPTION:
+ 
+TOP4R封装了淘宝开发平台的接口，帮助你快速构建基于TOP的应用程序。
+ 
+== FEATURES/PROBLEMS:
+ 
+* 待续...
+ 
+== REQUIREMENTS:
+ 
+* rubygems
+ 
+== INSTALL:
+ 
+sudo gem install nowa-top4r -s http://gems.github.com

data/lib/top4r/client/base.rb

@@ -0,0 +1,148 @@
+class Top4R::Client
+  alias :old_inspect :inspect
+  attr_accessor :total_results
+  attr_reader :login
+  
+  def inspect
+    s = old_inspect
+    s.gsub!(/@app_secret=".*?"/, '@app_secret="XXXX"')
+  end
+  
+  def init
+    total_results = 0
+    @@logger = Top4R::Logger.new(@@config.logger, @@config.trace)
+    if @parameters and @session
+      @parameters = Base64.decode64(@parameters).split('&').inject({}) do |hsh, i| kv = i.split('='); hsh[kv[0]] = kv[1]; hsh end
+      @login = user(@parameters['visitor_nick'].to_utf8)
+      # puts "login: #{@login.inspect}"
+    end
+  end
+  
+  protected
+    attr_accessor :app_key, :app_secret, :parameters, :session
+    
+    def login_required(model, method)
+      return if logged_in?
+      raise Top4R::LoginRequiredError.new({:model => model, :method => method})
+    end
+  
+    def http_connect(body=nil, &block)
+      require_block(block_given?)
+      connection = create_http_connection
+      connection.start do |connection|
+        request = yield connection if block_given?
+        # puts "conn: #{connection.inspect}"
+        # puts "request: #{request.inspect}"
+        timeout(15) do
+          response = connection.request(request, body)
+          @@logger.info "response: #{response.body}"
+        end
+        handle_rest_response(response)
+        response
+      end
+    end
+    
+    # "Blesses" model object with client information
+    def bless_model(model)
+    	model.bless(self) if model
+    end
+
+    def bless_models(list)
+      return bless_model(list) if list.respond_to?(:client=)
+    	list.collect { |model| bless_model(model) } if list.respond_to?(:collect)
+    end
+    
+  private
+    @@http_header = nil
+    
+    def valid_method(method, methods, model, force_login = false)
+      login_required(model, method) if (@@no_login_required_methods[model].is_a?(Hash) and !@@no_login_required_methods[model].keys.member?(method)) or force_login
+      raise ArgumentError, "Invalid #{model} method: #{method}" unless methods.keys.member?(method)
+    end
+    
+    def raise_rest_error(response, uri = nil)
+      map = JSON.parse(response.body)
+      raise Top4R::RESTError.new(:code => response.code,
+                                   :message => response.message,
+                                   :error => map["error_rsp"],
+                                   :uri => uri)
+    end
+  
+    def handle_rest_response(response, uri = nil)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise_rest_error(response, uri)
+      end
+      
+      map = JSON.parse(response.body)
+      if map["error_rsp"].is_a?(Hash) and map["error_rsp"]["code"].to_s == "630"
+        @@logger.info "Raising SuiteNotOrderedError..."
+        raise Top4R::SuiteNotOrderedError.new(:code => map["error_rsp"]["code"],
+                                      :message => map["error_rsp"]["msg"],
+                                      :error => map["error_rsp"],
+                                      :uri => uri)
+      elsif map["error_rsp"].is_a?(Hash)
+        @@logger.info "Raising RESTError..."
+        raise Top4R::RESTError.new(:code => map["error_rsp"]["code"],
+                                    :message => map["error_rsp"]["msg"],
+                                    :error => map["error_rsp"],
+                                    :uri => uri)
+      end
+    end
+  
+    def create_http_connection
+      protocol, host, port = (@@config.env == :production ? @@config.protocol : @@config.test_protocol), (@@config.env == :production ? @@config.host : @@config.test_host), (@@config.env == :production ? @@config.port : @@config.test_port)
+      @@logger.info "Host: #{host}\nPort: #{port}\n"
+      conn = Net::HTTP.new(host, port,
+                            @@config.proxy_host, @@config.proxy_port,
+                            @@config.proxy_user, @@config.proxy_pass)
+      if protocol == :ssl
+        conn.use_ssl = true
+        conn.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      end
+      conn
+    end
+    
+    def http_header
+      # can cache this in class variable since all "variables" used to
+      # create the contents of the HTTP header are determined by other
+      # class variables that are not designed to change after instantiation.
+      @@http_header ||= {
+       'User-Agent' => "Top4R v#{Top4R::Version.to_version} [#{@@config.user_agent}]",
+       'Accept' => 'text/x-json',
+       'X-TOP-Client' => @@config.application_name,
+       'X-TOP-Client-Version' => @@config.application_version,
+       'X-TOP-Client-URL' => @@config.application_url,
+      }
+      @@http_header
+    end
+    
+    def append_top_params(params)
+      params = params.merge({
+        :session => @session,
+        :timestamp => Time.now.strftime("%Y-%m-%d %H:%M:%S"),
+        :format => "#{@@config.format}",
+        :app_key => @app_key,
+        :v => "1.0"
+      })
+      params = params.merge({
+        :sign => Digest::MD5.hexdigest(params.sort {|a,b| "#{a[0]}"<=>"#{b[0]}"}.flatten.unshift(@app_secret).join).upcase
+      })
+    end
+
+    def create_http_get_request(method, params = {})
+      uri = @@config.env == :production ? @@config.rest_uri : @@config.test_rest_uri
+      params = append_top_params(params.merge({:method => method}))
+      path = (params.size > 0) ? "#{uri}?#{params.to_http_str}" : uri
+      @@logger.info "path: #{path}"
+      Net::HTTP::Get.new(path, http_header)
+    end
+
+    def create_http_post_request(uri)
+      Net::HTTP::Post.new(uri, http_header)
+    end
+
+    def create_http_delete_request(uri, params = {})
+      path = (params.size > 0) ? "#{uri}?#{params.to_http_str}" : uri
+      Net::HTTP::Delete.new(path, http_header)
+    end
+end

data/lib/top4r/client/shipping.rb

@@ -0,0 +1,45 @@
+class Top4R::Client
+  @@AREA_METHODS = {
+    :list => 'taobao.areas.get'
+  }
+  
+  @@LOGISTIC_COMPANY_METHODS = {
+    :list => 'taobao.logisticcompanies.get'
+  }
+  
+  @@DELIVERY_METHODS = {
+    :send => 'taobao.delivery.send'
+  }
+  
+  def areas(method = :list, options = {}, &block)
+    valid_method(method, @@AREA_METHODS, :area)
+    params = {:fields => Top4R::Area.fields}.merge(options)
+    response = http_connect {|conn| create_http_get_request(@@AREA_METHODS[method], params)}
+    areas = Top4R::Area.unmarshal(JSON.parse(response.body)["rsp"]["areas"])
+    areas.each {|area| bless_model(area); yield area if block_given?}
+    areas
+  end
+  
+  def logistic_companies(method = :list, options = {}, &block)
+    valid_method(method, @@LOGISTIC_COMPANY_METHODS, :logistic_company)
+    params = {:fields => Top4R::LogisticCompany.fields}.merge(options)
+    response = http_connect {|conn| create_http_get_request(@@LOGISTIC_COMPANY_METHODS[method], params)}
+    logistic_companies = Top4R::LogisticCompany.unmarshal(JSON.parse(response.body)["rsp"]["logistic_companies"])
+    logistic_companies.each {|logistic_company| bless_model(logistic_company); yield logistic_company if block_given?}
+    logistic_companies
+  end
+  
+  def deliver_trade(t, method = :send, options = {})
+    valid_method(method, @@DELIVERY_METHODS, :delivery)
+    params = {}
+    if t.is_a?(Top4R::Delivery)
+      params = t.to_hash
+    else
+      t = t.tid if t.is_a?(Top4R::Trade)
+      params = options.merge(:tid => t)
+    end
+    response = http_connect {|conn| create_http_get_request(@@DELIVERY_METHODS[method], params)}
+    json = JSON.parse(response.body)
+    json.is_a?(Hash) ? json["rsp"]["is_success"] : false
+  end
+end

data/lib/top4r/client/suite.rb

@@ -0,0 +1,17 @@
+class Top4R::Client
+  @@SUITE_METHODS = {
+    :list => 'taobao.suites.get',
+  }
+  
+  def suites(u, service_code, method = :list, options = {}, &block)
+    valid_method(method, @@SUITE_METHODS, :suite)
+    u = u.nick if u.is_a?(Top4R::User)
+    params = {:service_code => service_code}.merge(options).merge(:nick => u)
+    response = http_connect {|conn| create_http_get_request(@@SUITE_METHODS[method], params)}
+    suites = Top4R::Suite.unmarshal(JSON.parse(response.body)["rsp"]["suites"])
+    suites.each {|suite| bless_model(suite); yield suite if block_given?}
+    # puts "\nsuites: #{suites.inspect}"
+    @total_results = JSON.parse(response.body)["rsp"]["totalResults"].to_i
+    suites
+  end
+end

data/lib/top4r/client/trade.rb

@@ -0,0 +1,48 @@
+class Top4R::Client
+  @@TRADE_METHODS = {
+    :bought_list => 'taobao.trades.bought.get',
+    :sold_list => 'taobao.trades.sold.get',
+    :increments_list => 'taobao.trades.sold.increment.get',
+    :info => 'taobao.trade.get',
+    :fullinfo => 'taobao.trade.fullinfo.get',
+    :close => 'taobao.trade.close',
+    :add_memo => 'taobao.trade.memo.add',
+    :update_memo => 'taobao.trade.memo.update',
+    :confirmfee => 'taobao.trade.confirmfee.get'
+  }
+  
+  def trades_for(method = :bought_list, options = {}, &block)
+    valid_method(method, @@TRADE_METHODS, :trade)
+    params = {:fields => Top4R::Trade.fields}.merge(options)
+    if method == :increments_list
+      now = Time.now
+      params = {:start_modified => (now - 24.hours).strftime("%Y-%m-%d %H:%M:%S"), :end_modified => now.strftime("%Y-%m-%d %H:%M:%S")}.merge(params)
+    end
+    response = http_connect {|conn| create_http_get_request(@@TRADE_METHODS[method], params)}
+    trades = Top4R::Trade.unmarshal(JSON.parse(response.body)["rsp"]["trades"])
+    trades.each {|trade| bless_model(trade); yield trade if block_given?}
+    # puts "\ntrades: #{trades.inspect}"
+    @total_results = JSON.parse(response.body)["rsp"]["totalResults"].to_i
+    trades
+  end
+  
+  def trade(t, method = :info, options = {})
+    valid_method(method, @@TRADE_METHODS, :trade)
+    t = t.tid if t.is_a?(Top4R::Trade)
+    params = {:fields => Top4R::Trade.fields}.merge(options).merge(:tid => t)
+    response = http_connect {|conn| create_http_get_request(@@TRADE_METHODS[method], params)}
+    parsed_body = JSON.parse(response.body)
+    
+    if [:info, :fullinfo].member?(method)
+      trades = Top4R::Trade.unmarshal(parsed_body["rsp"]["trades"])
+      bless_model(trades.first)
+    elsif method == :confirmfee
+      confirmfees = Top4R::TradeConfirmFee.unmarshal(parsed_body["rsp"]["confirmFees"])
+      bless_models(confirmfees)
+    elsif [:close, :update_memo].member?(method)
+      parsed_body["rsp"]["modified"]
+    elsif method == :add_memo
+      parsed_body["rsp"]["created"]
+    end
+  end
+end

data/lib/top4r/client/user.rb

@@ -0,0 +1,31 @@
+class Top4R::Client
+  @@USER_METHODS = {
+    :info => 'taobao.user.get',
+    :multi_info => 'taobao.users.get'
+  }
+  
+  def logged_in?
+    @login.is_a?(Top4R::User) ? true : false
+  end
+  
+  def user(u, method = :info, options = {})
+    valid_method(method, @@USER_METHODS, :user)
+    u = u.nick if u.is_a?(Top4R::User)
+    users = user_request(u, method, options)
+    method == :info ? bless_model(users.first) : bless_models(users)
+  end
+  
+  def my(method, options = {})
+    valid_method(method, @@USER_METHODS, :user, true)
+    users = user_request(@login.nick, method, options)
+    method == :info ? bless_model(users.first) : bless_models(users)
+  end
+  
+  protected
+  
+    def user_request(u, method, options)
+      params = {:fields => Top4R::User.fields}.merge(options).merge(:nick => u)
+      response = http_connect {|conn| create_http_get_request(@@USER_METHODS[method], params)}
+      Top4R::User.unmarshal(JSON.parse(response.body)["rsp"]["users"])
+    end
+end

data/lib/top4r/client.rb

@@ -0,0 +1,23 @@
+class Top4R::Client
+  include Top4R::ClassUtilMixin
+  
+  @@no_login_required_methods = {
+    :user => {
+      :info => 'taobao.user.get',
+      :multi_info => 'taobao.users.get'
+    },
+    :trade => {},
+    :area => {
+      :list => 'taobao.areas.get'
+    },
+    :logistic_company => {
+      :list => 'taobao.logisticcompanies.get'
+    }
+  }
+end
+
+require 'top4r/client/base'
+require 'top4r/client/user'
+require 'top4r/client/shipping'
+require 'top4r/client/trade'
+require 'top4r/client/suite'

data/lib/top4r/config.rb

@@ -0,0 +1,87 @@
+module Top4R
+  # A rails like config object
+  class Config
+    include ClassUtilMixin
+    @@ATTRIBUTES = [
+        :env,
+        :host,
+        :rest_uri,
+        :port,
+        :protocol,
+        :test_host,
+        :test_rest_uri,
+        :test_port,
+        :test_protocol,
+        # :staging_host,
+        #         :staging_rest_uri,
+        #         :staging_port,
+        #         :staging_protocol,
+        :proxy_host,
+        :proxy_port,
+        :proxy_user,
+        :proxy_pass,
+        :format,
+        :application_name,
+        :application_key,
+        :application_secret,
+        :application_version,
+        :application_url,
+        :user_agent,
+        :source,
+        :logger,
+        :trace
+    ]
+    attr_accessor *@@ATTRIBUTES
+    
+    # Override of Object#eql? to ensure RSpec specifications run
+    # correctly. Also done to follow Ruby best practices.
+    def eql?(other)
+      return true if self == other
+      @@ATTRIBUTES.each do |att|
+        return false unless self.send(att).eql?(other.send(att))
+      end
+      true
+    end
+  end # Config class
+  
+  class Client
+    @@defaults = {
+      :env => :test,
+      :host => 'gw.api.taobao.com',
+      :rest_uri => '/router/rest',
+      :port => 80,
+      :protocol => :http,
+      :test_host => 'gw.sandbox.taobao.com',
+      :test_rest_uri => '/router/rest',
+      :test_port => 80,
+      :test_protocol => :http,
+      # :staging_host => '192.168.208.110',
+      #       :staging_rest_uri => '/top/private/services/rest',
+      #       :staging_port => '8080',
+      #       :staging_protocol => :http,
+      :proxy_host => nil,
+      :proxy_port => nil,
+      :format => :json,
+      :application_name => 'Top4R',
+      :application_key => '12000224',
+      :application_secret => '2f26cb1a99570aa72daee12a1db88e63',
+      :application_version => Top4R::Version.to_version,
+      :application_url => 'http://top4r.nowa.me',
+      :user_agent => 'default',
+      :source => 'top4r',
+      :logger => nil,
+      :trace => false
+    }
+    @@config = Top4R::Config.new(@@defaults)
+    @@logger = Top4R::Logger.new(@@config.logger)
+    
+    # Top4R::Client class methods
+    class << self
+      # Yields to given <tt>block</tt> to configure the Twitter4R API.
+      def configure(&block)
+        raise ArgumentError, "Block must be provided to configure" unless block_given?
+        yield @@config
+      end # configure
+    end # class << self
+  end # Client class
+end

data/lib/top4r/console.rb

@@ -0,0 +1,29 @@
+require 'optparse'
+
+module Top4R
+  class Client
+    class << self
+      # Helper method mostly for irb shell prototyping.
+      #
+      # Reads in app_key/app_secret from YAML file
+      # found at the location given by <tt>config_file</tt> that has
+      # the following format:
+      # envname:
+      # app_key: application key
+      # app_secret: application secret
+      # 
+      #
+      # Where <tt>envname</tt> is the name of the environment like 'test',
+      # 'dev' or 'prod'. The <tt>env</tt> argument defaults to 'test'.
+      #
+      # To use this in the shell you would do something like the following
+      # examples:
+      # top = Top4R::Client.from_config('config/top.yml', 'dev')
+      # top = Top4R::Client.from_config('config/top.yml')
+      def from_config(config_file, env = 'test')
+        yaml_hash = YAML.load(File.read(config_file))
+        self.new yaml_hash[env]
+      end
+    end # class << self
+  end
+end

data/lib/top4r/core.rb

@@ -0,0 +1,63 @@
+module Top4R
+  # Core
+  module ClassUtilMixin
+    module ClassMethods
+      
+    end
+    
+    module InstanceMethods
+      def initialize(params = {})
+        others = {}
+        params.each do |key,val|
+          if self.respond_to? key
+            self.send("#{key}=", val)
+          else
+            others[key] = val
+          end
+        end
+        self.send("#{:other_attrs}=", others) if self.respond_to? :other_attrs and others.size > 0
+        self.send(:init) if self.respond_to? :init
+      end
+      
+      protected
+        def require_block(block_given)
+          raise ArgumentError, "Must provide a block" unless block_given
+        end
+    end
+    
+    def self.included(receiver)
+      receiver.extend         ClassMethods
+      receiver.send :include, InstanceMethods
+    end
+  end # ClassUtilMixin module
+  
+  class RESTError < RuntimeError
+    include ClassUtilMixin
+    @@ATTRIBUTES = [:code, :message, :uri, :error]
+    attr_accessor *@@ATTRIBUTES
+
+    # Returns string in following format:
+    # "HTTP #{@code}: #{@message} at #{@uri}"
+    # For example,
+    # "HTTP 404: Resource Not Found at /i_am_crap.json"
+    def to_s
+      "HTTP #{@code}: #{@message} at #{@uri}"
+    end
+  end # RESTError
+  
+  class SuiteNotOrderedError < RESTError
+    def to_s
+      "错误代号#{@code}，您没有订购该服务！"
+    end
+  end
+  
+  class LoginRequiredError < RuntimeError
+    include ClassUtilMixin
+    @@ATTRIBUTES = [:model, :method]
+    attr_accessor *@@ATTRIBUTES
+    
+    def to_s
+      "#{@method} method at model #{@model} requires you to be logged in first"
+    end
+  end # LoginRequiredError
+end

data/lib/top4r/ext/stdlib.rb

@@ -0,0 +1,27 @@
+# Extension to Hash to create URL encoded string from key-values
+class Hash
+  # Returns string formatted for HTTP URL encoded name-value pairs.
+  # For example,
+  # {:id => 'thomas_hardy'}.to_http_str
+  # # => "id=thomas_hardy"
+  # {:id => 23423, :since => Time.now}.to_http_str
+  # # => "since=Thu,%2021%20Jun%202007%2012:10:05%20-0500&id=23423"
+  def to_http_str
+    result = ''
+    return result if self.empty?
+    self.each do |key, val|
+      result << "#{key}=#{CGI.escape(val.to_s)}&"
+    end
+    result.chop # remove the last '&' character, since it can be discarded
+  end
+end
+
+class String
+  def to_gbk
+    Iconv.iconv("GBK//IGNORE", "UTF-8//IGNORE", self).to_s
+  end
+  
+  def to_utf8
+    Iconv.iconv("UTF-8//IGNORE", "GBK//IGNORE", self).to_s
+  end
+end

data/lib/top4r/ext.rb

@@ -0,0 +1 @@
+require_local('top4r/ext/stdlib')

data/lib/top4r/logger.rb

@@ -0,0 +1,24 @@
+class Top4R::Logger
+  attr_accessor :trace
+  
+  class << self
+    def set_logger(logger)
+      self.new logger
+    end
+  end
+  
+  class Nogger
+    def info(log)
+      puts log
+    end
+  end
+  
+  def initialize(logger, is_trace = false)
+    @trace = is_trace
+    @logger = logger || Nogger.new
+  end
+  
+  def info(log)
+    @logger.info "top4r trace: #{log}" if @trace
+  end
+end

data/lib/top4r/meta.rb

@@ -0,0 +1,56 @@
+# meta.rb contains <tt>Top4R::Meta</tt> and related classes that
+# help define the metadata of the <tt>Top4R</tt> project.
+
+require('rubygems')
+require('erb')
+
+class Top4R::Meta #:nodoc:
+  attr_accessor :root_dir
+  attr_reader :gem_spec, :project_files, :spec_files
+
+  # Initializer for Top4R::Meta class.  Takes <tt>root_dir</tt> as parameter.
+  def initialize(root_dir)
+    @root_dir = root_dir
+  end
+
+  # Returns package information defined in <tt>root_dir</tt>/pkg-info.yml
+  def pkg_info
+    yaml_file = File.join(@root_dir, 'pkg-info.yml')
+    ryaml = ERB.new(File.read(yaml_file), 0)
+    s = ryaml.result(binding)
+    YAML.load(s)
+  end
+  
+  # Returns RubyGems spec information
+  def spec_info
+    self.pkg_info['spec'] if self.pkg_info
+  end
+  
+  # Returns list of project files
+  def project_files
+    @project_files ||= Dir.glob(File.join(@root_dir, 'lib/**/*.rb'))
+    @project_files
+  end
+  
+  # Returns list of specification files
+  def spec_files
+    @spec_files ||= Dir.glob(File.join(@root_dir, 'spec/**/*_spec.rb'))
+    @spec_files
+  end
+  
+  # Returns RubyGem specification for Top4R project
+  def gem_spec
+    @gem_spec ||= Gem::Specification.new do |spec|
+      self.spec_info.each do |key, val|
+        if val.is_a?(Hash)
+          val.each do |k, v|
+            spec.send(key, k, v)
+          end
+        else
+          spec.send("#{key}=", val)
+        end
+      end
+    end
+    @gem_spec
+  end
+end

data/lib/top4r/model/shipping.rb

@@ -0,0 +1,76 @@
+module Top4R
+  # Area model
+  class Area
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :area_id, :area_type, :area_name, :parent_id, :zip]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+      
+      def default_public_fields
+        ["area_id", "area_type", "area_name", "parent_id", "zip"]
+      end
+    end
+    
+    def unmarshal_other_attrs
+      @id = @area_id
+      self
+    end
+  end
+  
+  # LogisticCompany model
+  class LogisticCompany
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :company_id, :company_code, :company_name]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+      
+      def default_public_fields
+        ["company_id", "company_code", "company_name"]
+      end
+    end
+    
+    def unmarshal_other_attrs
+      @id = @company_id
+      self
+    end
+  end
+  
+  # Delivery model
+  class Delivery
+    include ModelMixin
+    @@ATTRIBUTES = [:tid, :order_type, :company_code, :out_sid, :seller_name, :seller_area_id, 
+      :seller_address, :seller_zip, :seller_phone, :seller_mobile, :memo]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+    end
+  end # Delivery model
+  
+  # Shipping model
+  class Shipping
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :tid, :seller_nick, :buyer_nick, :delivery_start, :delivery_end, 
+      :out_sid, :item_title, :receiver_name, :receiver_phone, :receiver_mobile, :receiver_location, 
+      :status, :type, :freight_payer, :seller_confirm, :company_name]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+    end
+    
+    def unmarshal_other_attrs
+      @id = @out_sid
+      if @receiver_location && @receiver_location.size > 0
+        @receiver_location = Location.new(@receiver_location)
+      else
+        @receiver_location = nil
+      end
+      self
+    end
+  end
+end

data/lib/top4r/model/suite.rb

@@ -0,0 +1,17 @@
+module Top4R
+  # Suite model
+  class Suite
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :nick, :suite_name, :start_date, :end_date]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+    end
+    
+    def unmarshal_other_attrs
+      @id = 0
+      self
+    end
+  end
+end

data/lib/top4r/model/trade.rb

@@ -0,0 +1,109 @@
+module Top4R
+  # Order model
+  class Order
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :iid, :sku_id, :sku_properties_name, :item_meal_name, :num, :title, 
+      :price, :pic_path, :seller_nick, :buyer_nick, :type, :created, :refund_status, :tid, 
+      :outer_iid, :outer_sku_id, :total_fee, :payment, :discount_fee, :adjust_fee, :status, 
+      :snapshot_url, :timeout_action_time]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+      
+      def default_public_fields
+        ["orders.title", "orders.price", "orders.num", "orders.iid", "orders.status", "orders.tid", 
+          "orders.total_fee", "orders.payment", "orders.pic_path"]
+      end
+    end
+    
+    def confirm_fees
+      @client.trade(@tid, :confirmfee, {:is_detail => "IS_CHILD"})
+    end
+    
+    def unmarshal_other_attrs
+      @id = 0
+      self
+    end
+  end
+  
+  # TradeConfirmFee model
+  class TradeConfirmFee
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :confirm_fee, :confirm_post_fee, :is_last_detail_order]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+    end
+    
+    def unmarshal_other_attrs
+      @id = 0
+      self
+    end
+  end
+  
+  # Trade model
+  class Trade
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :seller_nick, :buyer_nick, :title, :type, :created, :iid, :price, 
+      :pic_path, :num, :tid, :buyer_message, :sid, :shipping_type, :alipay_no, :payment, 
+      :discount_fee, :adjust_fee, :snapshot_url, :status, :seller_rate, :buyer_rate, 
+      :buyer_memo, :seller_memo, :pay_time, :end_time, :modified, :buyer_obtain_point_fee, 
+      :point_fee, :real_point_fee, :total_fee, :post_fee, :buyer_alipay_no, :receiver_name,
+      :receiver_state, :receiver_city, :receiver_district, :receiver_address, :receiver_zip, 
+      :receiver_mobile, :receiver_phone, :consign_time, :buyer_email, :commission_fee, 
+      :seller_alipay_no, :seller_mobile, :seller_phone, :seller_name, :seller_email, 
+      :available_confirm_fee, :has_postFee, :received_payment, :cod_fee, :timeout_action_time, :orders]
+    attr_accessor *@@ATTRIBUTES
+    
+    class << self
+      def attributes; @@ATTRIBUTES; end
+      
+      def default_public_fields
+        ["buyer_nick", "seller_nick", "tid", "modified", "title", "type", "status", "created", "price", 
+          "sid", "pic_path", "iid", "payment", "alipay_no", "shipping_type", "pay_time", "end_time", 
+          "orders"] + Top4R::Order.default_public_fields
+      end
+    end
+    
+    def close(reason = "现关闭本交易！")
+      @client.trade(@tid, :close, {:close_reason => reason})
+    end
+    
+    def add_memo(memo)
+      valid_memo(memo)
+      @client.trade(@tid, :add_memo, {:memo => memo})
+    end
+    
+    def update_memo(memo)
+      valid_memo(memo)
+      @client.trade(@tid, :update_memo, {:memo => memo})
+    end
+    
+    def confirm_fees
+      @client.trade(@tid, :confirmfee, {:is_detail => "IS_FATHER"})
+    end
+    
+    def deliver(options = {}, &block)
+      delivery = Delivery.new(options)
+      yield delivery if block_given?
+      delivery.tid = @tid
+      @client.deliver_trade(delivery)
+    end
+    
+    def unmarshal_other_attrs
+      @id = @tid
+      if @orders.is_a?(Array)
+        @orders = @orders.map{|order| Order.new(order)}
+      end
+      self
+    end
+    
+    private
+      def valid_memo(memo)
+        raise ArgumentError, "Invalid param: memo" if memo
+        raise ArgumentError, "Invalid param length: Memo must be less than 1000 characters" if memo.size > 1000
+      end
+  end
+end

data/lib/top4r/model/user.rb

@@ -0,0 +1,93 @@
+module Top4R
+  module LoggedInUserMixin
+    module InstanceMethods
+      def trades(method = :bought_list, options = {})
+        @client.trades_for(method, options)
+      end
+      
+      def suites(service_code, options = {})
+        @client.suites(self.nick, service_code, :list, options)
+      end
+    end
+
+    def self.included(receiver)
+      receiver.send :include, InstanceMethods
+    end
+  end # LoggedInUserMixin module
+
+  # Location Model
+  class Location
+    include ModelMixin
+    @@ATTRIBUTES = [:zip, :address, :city, :state, :country, :district]
+    attr_accessor *@@ATTRIBUTES
+
+    class << self
+      def attributes
+        @@ATTRIBUTES
+      end
+    end
+  end # Location model
+
+  # UserCredit Model
+  class UserCredit
+    include ModelMixin
+    @@ATTRIBUTES = [:level, :score, :total_num, :good_num]
+    attr_accessor *@@ATTRIBUTES
+
+    class << self
+      def attributes; @@ATTRIBUTES; end
+    end
+  end # UserCredit model
+
+  # User Model
+  class User
+    include ModelMixin
+    @@ATTRIBUTES = [:id, :user_id, :nick, :sex, :buyer_credit, :seller_credit, :location, 
+      :created, :last_visit, :birthday, :type, :has_more_pic, :item_img_num, :item_img_size, 
+      :prop_img_num, :prop_img_size, :auto_repost, :promoted_type, :status, :alipay_bind, 
+      :consumer_protection, :other_attrs]
+    attr_accessor *@@ATTRIBUTES
+
+    class << self
+      def attributes; @@ATTRIBUTES; end
+
+      def default_public_fields
+        ["user_id", "nick", "sex", "buyer_credit", "seller_credit", 
+          "location.city", "location.state", "location.country", "created", "last_visit", "type"]
+      end
+
+      def default_private_fields
+        ["location.zip", "birthday"]
+      end
+
+      def find(u, client)
+        client.user(u)
+      end
+    end
+
+    def bless(client)
+      basic_bless(client)
+      self.instance_eval(%{
+        self.class.send(:include, Top4R::LoggedInUserMixin)
+      }) if self.is_me? and not self.respond_to?(:trades)
+      self
+    end
+
+    def is_me?
+      @nick == @client.instance_eval("@parameters['visitor_nick']").to_utf8
+    end
+
+    def unmarshal_other_attrs
+      @id = @user_id
+      if @location && @location.size > 0
+        @location = Location.new(@location)
+      else
+        @location = nil
+      end
+      @buyer_credit = UserCredit.new(@buyer_credit) if @buyer_credit && @buyer_credit.size > 0
+      @seller_credit = UserCredit.new(@seller_credit) if @seller_credit && @seller_credit.size > 0
+      # @nick = @nick.to_utf8
+      self
+    end
+  end # User model
+end

data/lib/top4r/model.rb

@@ -0,0 +1,111 @@
+module Top4R
+  module ModelMixin
+    module ClassMethods
+      def default_public_fields; []; end
+      
+      def default_private_fields; []; end
+      
+      # Unmarshal object singular or plural array of model objects
+      # from JSON serialization. Currently JSON is only supported.
+      def unmarshal(raw)
+        # input = JSON.parse(raw)
+        input = raw
+        # puts "\ninput: #{input.inspect}"
+        def unmarshal_model(hash)
+          mine = self.new(hash)
+          # puts "\n mine: #{mine.inspect}"
+          mine.unmarshal_other_attrs if mine.respond_to? :unmarshal_other_attrs
+          mine
+        end
+        return unmarshal_model(input) if input.is_a?(Hash) # singular case
+        result = []
+        input.each do |hash|
+          model = unmarshal_model(hash) if hash.is_a?(Hash)
+          result << model
+        end if input.is_a?(Array)
+        result # plural case
+      end
+      
+      def fields
+        (self.default_public_fields + self.default_private_fields).uniq.join(',')
+      end
+    end
+    
+    module InstanceMethods
+      attr_accessor :client
+      
+      # Equality method override of Object#eql? default.
+      #
+      # Relies on the class using this mixin to provide a <tt>attributes</tt>
+      # class method that will return an Array of attributes to check are
+      # equivalent in this #eql? override.
+      #
+      # It is by design that the #eql? method will raise a NoMethodError
+      # if no <tt>attributes</tt> class method exists, to alert you that
+      # you must provide it for a meaningful result from this #eql? override.
+      # Otherwise this will return a meaningless result.
+      def eql?(other)
+        attrs = self.class.attributes
+        attrs.each do |att|
+          return false unless self.send(att).eql?(other.send(att))
+        end
+        true
+      end
+      
+      # Returns integer representation of model object instance.
+      #
+      # For example,
+      # product = Top4R::Product.new(:id => 234343)
+      # product.to_i #=> 234343
+      def to_i
+        @id
+      end
+      
+      # Returns hash representation of model object instance.
+      #
+      # For example,
+      # u = Top4R::User.new(:id => 2342342, :screen_name => 'tony_blair_is_the_devil')
+      # u.to_hash #=> {:id => 2342342, :screen_name => 'tony_blair_is_the_devil'}
+      #
+      # This method also requires that the class method <tt>attributes</tt> be
+      # defined to return an Array of attributes for the class.
+      def to_hash
+        attrs = self.class.attributes
+        result = {}
+        attrs.each do |att|
+          value = self.send(att)
+          value = value.to_hash if value.respond_to?(:to_hash)
+          result[att] = value if value
+        end
+        result
+      end
+      
+      # "Blesses" model object.
+      #
+      # Should be overridden by model class if special behavior is expected
+      #
+      # Expected to return blessed object (usually <tt>self</tt>)
+      def bless(client)
+        self.basic_bless(client)
+      end
+      
+      protected
+        # Basic "blessing" of model object
+        def basic_bless(client)
+          self.client = client
+          self
+        end
+    end
+    
+    def self.included(receiver)
+      receiver.extend         ClassMethods
+      receiver.send :include, Top4R::ClassUtilMixin
+      receiver.send :include, InstanceMethods
+    end
+  end # ModelMixin module
+end
+
+require 'top4r/model/user'
+require 'top4r/model/shipping'
+require 'top4r/model/trade'
+require 'top4r/model/suite'

data/lib/top4r/version.rb

@@ -0,0 +1,17 @@
+module Top4R::Version
+  MAJOR = 0
+  MINOR = 0
+  REVISION = 24
+  
+  class << self
+    # Returns X.Y.Z formatted version string
+    def to_version
+      "#{MAJOR}.#{MINOR}.#{REVISION}"
+    end
+
+    # Returns X-Y-Z formatted version name
+    def to_name
+      "#{MAJOR}_#{MINOR}_#{REVISION}"
+    end
+  end
+end

data/lib/top4r.rb

@@ -0,0 +1,28 @@
+$:.unshift(File.dirname(__FILE__))
+
+module Top4R; end
+
+def require_local(suffix)
+  require(File.expand_path(File.join(File.dirname(__FILE__), suffix)))
+end
+
+require 'digest/md5'
+require 'net/http'
+require 'net/https'
+require 'uri'
+require 'cgi'
+require 'json'
+require 'yaml'
+require 'iconv'
+require 'activesupport'
+require 'timeout'
+
+require_local('top4r/ext')
+require_local('top4r/version')
+require_local('top4r/logger')
+require_local('top4r/meta')
+require_local('top4r/core')
+require_local('top4r/model')
+require_local('top4r/config')
+require_local('top4r/client')
+require_local('top4r/console')

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: top4r
+version: !ruby/object:Gem::Version 
+  version: 0.0.24
+platform: ruby
+authors: 
+- Nowa Zhu
+autorequire: top4r
+bindir: bin
+cert_chain: []
+
+date: 2009-10-15 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.1
+    version: 
+description: 
+email: nowazhu@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- CHANGES
+- TODO
+- MIT-LICENSE
+files: 
+- lib/top4r/client/base.rb
+- lib/top4r/client/shipping.rb
+- lib/top4r/client/suite.rb
+- lib/top4r/client/trade.rb
+- lib/top4r/client/user.rb
+- lib/top4r/client.rb
+- lib/top4r/config.rb
+- lib/top4r/console.rb
+- lib/top4r/core.rb
+- lib/top4r/ext/stdlib.rb
+- lib/top4r/ext.rb
+- lib/top4r/logger.rb
+- lib/top4r/meta.rb
+- lib/top4r/model/shipping.rb
+- lib/top4r/model/suite.rb
+- lib/top4r/model/trade.rb
+- lib/top4r/model/user.rb
+- lib/top4r/model.rb
+- lib/top4r/version.rb
+- lib/top4r.rb
+- README
+- CHANGES
+- TODO
+- MIT-LICENSE
+has_rdoc: true
+homepage: http://top4r.labs.nowa.me
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.2
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: 
+- Ruby 1.8.4+
+rubyforge_project: top4r
+rubygems_version: 1.3.3
+signing_key: 
+specification_version: 3
+summary: TOP4R is a library that can help you build plugin for TaoBao.com quickly in pure Ruby.
+test_files: []
+