kuroneko 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a26e2b922612c37ef906c4b1f116659695045bee
-  data.tar.gz: 48a9346469bef41bd70748893154c6c329e75ec1
+  metadata.gz: 77730733c3b79fe9c08030b78bdc4a6a821c4213
+  data.tar.gz: 3f44605098b4d5640f6061d4aff376db87ebafc5
 SHA512:
-  metadata.gz: 0932268fd5844e8d943c05f87b5d72b89eec9f9d4365712d27431175abbf1dd589483ad71b8466c21999cbfd20dd1eb7f72bb7f42736a4c6783b29f26302579c
-  data.tar.gz: f0512e95ee6d4c23337d915712ea182be43ad9a84c83b6f812a102dce586e08eee9f1e3d982ec427c9b2f75e9b31a4e70a7bfa9ff8e8054d8314b2ead7a37db2
+  metadata.gz: baee97d63a719bb3c804c237b7abca909e38239d6f9543c3df3771329ffcd53ae5d71d440aec24f25483897b7afeba2e32fa996034b80b3416e66f658caa981f
+  data.tar.gz: 9ee44da7e7b1629548e8a26c419b02522cc31012cad205ee5becbae83f0735447a7b583bf5963c1697a2030cb6dc6d6a925ca14c1d29a37a6f7c21af52816882

data/.gitignore

@@ -2,6 +2,8 @@
 *.rbc
 .bundle
 .config
+.rbenv-vars
+.ruby-version
 .yardoc
 Gemfile.lock
 InstalledFiles

data/README.md

@@ -54,10 +54,10 @@ status.to_h
 
 ``` ruby
 history = neko.history("1234-5678-9012")
-#=> #<Kuroneko::StatusHistory<Kuroneko::Status>>
+#=> #<Kuroneko::History<Kuroneko::Status>>
 ```
 
-- `StatusHistory` は `Array` を継承していて、以下を追加で実装しています。
+- `History` は `Array` を継承していて、以下を追加で実装しています。
     - 履歴のうち最新の状態を返す `#latest`
     - 伝票番号を返す `#number`
 - `Kuroneko#histories` で複数を一度に照会でき、結果は `Array` で返されます。
@@ -79,7 +79,7 @@ history = neko.history("1234-5678-9012")
 そのまま問い合わせに使用するため、クロネコヤマト側が受け付ける形式であれば
 どのようなものでも可能です。
 
-`Kuroneko::StatusHistory`, `Kuroneko::Status` から読み取る伝票番号は
+`Kuroneko::History`, `Kuroneko::Status` から読み取る伝票番号は
 照会結果から取得し、数字のみからなる __文字列__ で返ります。
 
 ## Contributing

data/kuroneko.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |spec|
   spec.name          = "kuroneko"
   spec.version       = Kuroneko::VERSION
   spec.authors       = ["wktk"]
-  spec.email         = ["mail@wktk.jp"]
+  spec.email         = ["wktk30@gmail.com"]
   spec.description   = %q{クロネコヤマトの荷物追跡を照会する}
   spec.summary       = spec.description
   spec.homepage      = "https://github.com/wktk/kuroneko"

data/lib/kuroneko.rb

@@ -1,8 +1,7 @@
 # -*- encoding: utf-8 -*-
 
 require 'mechanize'
-require 'kuroneko/status'
-require 'kuroneko/status_history'
+require 'kuroneko/parser'
 require 'kuroneko/version'
 
 # クロネコヤマトの荷物を追跡する
@@ -15,6 +14,9 @@ class Kuroneko
   # @return [Mechanize] 使用する Mechanize インスタンス
   attr_accessor :agent
 
+  # @return [#parse] ページを解析するパーサ
+  attr_accessor :parser
+
   # @return [String] 問い合わせフォームの URL
   attr_accessor :url
 
@@ -22,16 +24,18 @@ class Kuroneko
   #
   # @param [Hash] options
   # @option options [Mechanize] :agent 使用する Mechanize インスタンス
+  # @option options [#parse] :parser ページを解析するパーサ
   # @option options [String] :url 問い合わせフォームの URL
   def initialize(options={})
     @agent = options[:agent] || Mechanize.new
+    @parser = options[:parser] || Parser
     @url = options[:url] || URL.dup
   end
 
   # 1 つの荷物の状態履歴を照会する
   #
   # @param [String, #to_s] number 伝票番号
-  # @return [Kuroneko::StatusHistory<Kuroneko::Status>] 状態履歴
+  # @return [Kuroneko::History<Kuroneko::Status>] 状態履歴
   def history(number)
     histories(number).first
   end
@@ -39,12 +43,9 @@ class Kuroneko
   # 複数の荷物の状態履歴を照会する
   #
   # @param [Array<String, #to_s>] numbers 伝票番号
-  # @return [Array<Kuroneko::StatusHistory<Kuroneko::Status>>] 状態履歴
+  # @return [Array<Kuroneko::History<Kuroneko::Status>>] 状態履歴
   def histories(*numbers)
-    numbers.flatten!
-    results = []
-    results.concat(query(numbers.shift(10))) until numbers.empty?
-    results
+    numbers.flatten.each_slice(10).map { |n| query(n) }.flatten(1)
   end
 
   # 1 つの荷物の最新状態を照会する
@@ -65,22 +66,6 @@ class Kuroneko
 
 private
 
-  # ページをから情報を抽出する
-  #
-  # @param [Mechanize::Page] page 照会結果のページ
-  # @return [Array<Kuroneko::StatusHistory<Kuroneko::Status>>] 状態履歴
-  def parse(page)
-    page.parser.css('table.saisin').map do |summary|
-      rows = summary.css('tr')
-      number = rows[0].css('td')[2].text.gsub(/\D/, '')
-      status = rows[1].css('td')[2].text
-
-      history = summary.parent.css('table.meisai').first
-      history ||= [Status.new(number, [status], true)]  # 伝票番号誤りなど
-      StatusHistory.new(number, history)
-    end
-  end
-
   # フォームパラメータをセットする
   #
   # @param [Mechanize::Form] form
@@ -95,10 +80,10 @@ private
   # リクエストを送信して状態を抽出する
   #
   # @param [Array<String, #to_s>] numbers 伝票番号
-  # @return [Array<Kuroneko::StatusHistory<Kuroneko::Status>>] 状態履歴
+  # @return [Array<Kuroneko::History<Kuroneko::Status>>] 状態履歴
   def query(numbers)
     result_page = request(numbers)
-    parse(result_page)
+    parser.parse(result_page)
   end
 
   # 照会リクエストを送る
@@ -110,4 +95,5 @@ private
     prepare_form(form, numbers)
     form.submit
   end
+
 end

data/lib/kuroneko/history.rb

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+
+class Kuroneko
+  # 状態履歴
+  class History < Array
+    # @return [String] 伝票番号
+    # @note 数字以外 (ハイフン等) は含まない
+    attr_reader :number
+
+    # @param [String] number 伝票番号
+    # @param [Array<Kuroneko::Status>] history 状態履歴
+    def initialize(number, history)
+      @number = number
+      super(history)
+    end
+
+    # @return [Kuroneko::Status] 履歴のうち最新の状態
+    def latest
+      find(&:latest?) || last
+    end
+
+  end
+end

data/lib/kuroneko/parser.rb

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+require 'kuroneko/history'
+require 'kuroneko/status'
+
+class Kuroneko
+  # ページからデータを抽出する
+  module Parser
+    class << self
+      # ページをから情報を抽出する
+      #
+      # @param [Mechanize::Page] page 照会結果のページ
+      # @return [Array<Kuroneko::History<Kuroneko::Status>>] 状態履歴
+      def parse_page(page)
+        page.parser.css('table.saisin').map(&method(:parse_history))
+      end
+
+      alias parse parse_page
+
+      private
+
+      # 履歴情報を解析する
+      #
+      # @param [Nokogiri::XML::Element] summary <table class="saisin">
+      # @return [Kuroneko::History<Kuroneko::Status>] 状態履歴
+      def parse_history(summary)
+        number, status = parse_meta(summary)
+        statuses = summary.parent.css('table.meisai').first
+        statuses = statuses ? parse_statuses(statuses) : [[true, status]]
+        History.new(number, statuses.map { |s| Status.new(number, *s) })
+      end
+
+      # 伝票番号と最新状態名を抽出する
+      #
+      # @param [Nokogiri::XML::Element] summary <table class="saisin">
+      # @return [Array] 伝票番号, 最新状態名
+      def parse_meta(summary)
+        rows = summary.css('tr')
+        number = rows[0].css('td')[2].text.gsub(/\D/, '')
+        status = rows[1].css('td')[2].text
+        [number, status]
+      end
+
+      # 状態を解析する
+      #
+      # @param [Nokogiri::XML::Element] status 状態情報のテーブル行
+      # @return [Array] Kuroneko::Status への引数
+      def parse_status(status)
+        attrs = status.css('td').to_a
+        latest = attrs.shift.css('img').attribute('alt').value == '最新'
+        [latest] + attrs.map(&:text)
+      end
+
+      # 状態履歴テーブルを解析する
+      #
+      # @param [Nokogiri::XML::Element] table <table class="meisai">
+      # @return [Array<Array>] Kuroneko::Status への引数
+      def parse_statuses(table)
+        statuses = table.css('tr').to_a
+        statuses.shift
+        statuses.map(&method(:parse_status))
+      end
+
+    end
+  end
+end

data/lib/kuroneko/status.rb

@@ -2,7 +2,7 @@
 
 class Kuroneko
   # 状態情報
-  Status = Struct.new(:number, :status, :date, :time, :branch, :branch_code)
+  Status = Struct.new(:number, :latest, :status, :date, :time, :branch, :branch_code)
 
   class Status
     # @!attribute number
@@ -11,6 +11,9 @@ class Kuroneko
     #     "123456789012"
     #   @note 数字以外 (ハイフン等) は含まない
 
+    # @!attribute latest
+    #   @return [Boolean] 最新の状態であるか
+
     # @!attribute status
     #   @return [String] 状態名
     #   @example
@@ -36,30 +39,8 @@ class Kuroneko
     #   @example
     #     "030990"
 
-    # @param [String] number 伝票番号
-    # @param [Nokogiri::XML::Element] status 状態情報のテーブル行
-    # @param [Boolean] latest 最新の状態であるか
-    def initialize(number, status, latest=nil)
-      super(number, *parse(status))
-      @latest = latest unless latest.nil?
-    end
-
     # @return [Boolean] 最新の状態であるか
-    def latest?
-      @latest
-    end
-
-  private
+    alias latest? latest
 
-    # 状態を解析する
-    #
-    # @param [Nokogiri::XML::Element] status 状態情報のテーブル行
-    # @return [Array<String>] 状態
-    def parse(status)
-      return status unless status.is_a?(Nokogiri::XML::Element)
-      attrs = status.css('td').to_a
-      @latest = attrs.shift.css('img').attribute('alt').value == '最新'
-      attrs.map!(&:text)
-    end
   end
 end

data/lib/kuroneko/version.rb

@@ -1,4 +1,4 @@
 class Kuroneko
   # @return [String] バージョン
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kuroneko
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - wktk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-15 00:00:00.000000000 Z
+date: 2014-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mechanize
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
 description: "クロネコヤマトの荷物追跡を照会する"
 email:
-- mail@wktk.jp
+- wktk30@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -67,8 +67,9 @@ files:
 - kuroneko.gemspec
 - lib/kuroneko.rb
 - lib/kuroneko/en.rb
+- lib/kuroneko/history.rb
+- lib/kuroneko/parser.rb
 - lib/kuroneko/status.rb
-- lib/kuroneko/status_history.rb
 - lib/kuroneko/version.rb
 homepage: https://github.com/wktk/kuroneko
 licenses:

data/lib/kuroneko/status_history.rb

@@ -1,35 +0,0 @@
-# -*- encoding: utf-8 -*-
-
-class Kuroneko
-  # 状態履歴
-  class StatusHistory < Array
-    # @return [String] 伝票番号
-    # @note 数字以外 (ハイフン等) は含まない
-    attr_reader :number
-
-    # @param [String] number 伝票番号
-    # @param [Nokogiri::XML::Element] table 状態履歴テーブル
-    def initialize(number, table)
-      @number = number
-      super(parse(table))
-    end
-
-    # @return [Kuroneko::Status] 履歴のうち最新の状態
-    def latest
-      find(&:latest?) || last
-    end
-
-  private
-
-    # 状態履歴テーブルを解析する
-    #
-    # @param [Nokogiri::XML::Element] table 状態履歴テーブル
-    # @return [Array<Kuroneko::Status>] 状態
-    def parse(table)
-      return table unless table.is_a?(Nokogiri::XML::Element)
-      statuses = table.css('tr').to_a
-      statuses.shift
-      statuses.map! { |status| Status.new(number, status) }
-    end
-  end
-end