rroonga 1.2.9 → 1.3.0

data/lib/groonga/expression-builder.rb

@@ -16,7 +16,8 @@
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
 module Groonga
-  module ExpressionBuildable # :nodoc:
+  # @private
+  module ExpressionBuildable
     attr_reader :table
     attr_accessor :query
     attr_accessor :syntax
@@ -94,7 +95,8 @@ module Groonga
       expression
     end
 
-    class ExpressionBuilder # :nodoc:
+    # @private
+    class ExpressionBuilder
       def initialize
         super()
       end
@@ -108,7 +110,8 @@ module Groonga
       end
     end
 
-    class SetExpressionBuilder < ExpressionBuilder # :nodoc:
+    # @private
+    class SetExpressionBuilder < ExpressionBuilder
       def initialize(operation, *expression_builders)
         super()
         @operation = operation
@@ -124,19 +127,22 @@ module Groonga
       end
     end
 
-    class AndExpressionBuilder < SetExpressionBuilder # :nodoc:
+    # @private
+    class AndExpressionBuilder < SetExpressionBuilder
       def initialize(*expression_builders)
         super(Groonga::Operation::AND, *expression_builders)
       end
     end
 
-    class OrExpressionBuilder < SetExpressionBuilder # :nodoc:
+    # @private
+    class OrExpressionBuilder < SetExpressionBuilder
       def initialize(*expression_builders)
         super(Groonga::Operation::OR, *expression_builders)
       end
     end
 
-    class ColumnValueExpressionBuilder < ExpressionBuilder # :nodoc:
+    # @private
+    class ColumnValueExpressionBuilder < ExpressionBuilder
       def initialize(column, options={})
         super()
         @table = options[:table] || column.table
@@ -244,7 +250,8 @@ module Groonga
       end
     end
 
-    class MatchTargetColumnExpressionBuilder < ColumnValueExpressionBuilder # :nodoc:
+    # @private
+    class MatchTargetColumnExpressionBuilder < ColumnValueExpressionBuilder
       def build(expression, variable)
         if @column.is_a?(String)
           expression.append_constant(@column)
@@ -259,7 +266,8 @@ module Groonga
       end
     end
 
-    class MatchTargetExpressionBuilder < ExpressionBuilder # :nodoc:
+    # @private
+    class MatchTargetExpressionBuilder < ExpressionBuilder
       def initialize(target)
         super()
         @target = target
@@ -279,7 +287,8 @@ module Groonga
       end
     end
 
-    class BinaryExpressionBuilder < ExpressionBuilder # :nodoc:
+    # @private
+    class BinaryExpressionBuilder < ExpressionBuilder
       def initialize(operation, column_value_builder, value)
         super()
         @operation = operation
@@ -294,73 +303,85 @@ module Groonga
       end
     end
 
-    class EqualExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class EqualExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::EQUAL, column_value_builder, value)
       end
     end
 
-    class MatchExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class MatchExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::MATCH, column_value_builder, value)
       end
     end
 
-    class LessExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class LessExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::LESS, column_value_builder, value)
       end
     end
 
-    class LessEqualExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class LessEqualExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::LESS_EQUAL, column_value_builder, value)
       end
     end
 
-    class GreaterExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class GreaterExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::GREATER, column_value_builder, value)
       end
     end
 
-    class GreaterEqualExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class GreaterEqualExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::GREATER_EQUAL, column_value_builder, value)
       end
     end
 
-    class PlusExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class PlusExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::PLUS, column_value_builder, value)
       end
     end
 
-    class MinusExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class MinusExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::MINUS, column_value_builder, value)
       end
     end
 
-    class StarExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class StarExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::STAR, column_value_builder, value)
       end
     end
 
-    class SlashExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class SlashExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::SLASH, column_value_builder, value)
       end
     end
 
-    class ModExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class ModExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::MOD, column_value_builder, value)
       end
     end
 
-    class SubExpressionBuilder < ExpressionBuilder # :nodoc:
+    # @private
+    class SubExpressionBuilder < ExpressionBuilder
       def initialize(query, options)
         super()
         @query = query
@@ -372,20 +393,23 @@ module Groonga
       end
     end
 
-    class PrefixSearchExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class PrefixSearchExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::PREFIX, column_value_builder, value)
       end
     end
 
-    class SuffixSearchExpressionBuilder < BinaryExpressionBuilder # :nodoc:
+    # @private
+    class SuffixSearchExpressionBuilder < BinaryExpressionBuilder
       def initialize(column_value_builder, value)
         super(Groonga::Operation::SUFFIX, column_value_builder, value)
       end
     end
   end
 
-  class RecordExpressionBuilder # :nodoc:
+  # @private
+  class RecordExpressionBuilder
     include ExpressionBuildable
 
     def initialize(table, name)
@@ -475,7 +499,8 @@ module Groonga
     end
   end
 
-  class MatchTargetRecordExpressionBuilder < RecordExpressionBuilder # :nodoc:
+  # @private
+  class MatchTargetRecordExpressionBuilder < RecordExpressionBuilder
     private
     def column_expression_builder(column, name)
       MatchTargetColumnExpressionBuilder.new(column,
@@ -484,7 +509,8 @@ module Groonga
     end
   end
 
-  class ColumnExpressionBuilder # :nodoc:
+  # @private
+  class ColumnExpressionBuilder
     include ExpressionBuildable
 
     def initialize(column, name, query, options={})

data/lib/groonga/grntest-log.rb

@@ -0,0 +1,206 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2011  Kouhei Sutou <kou@clear-code.com>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License version 2.1 as published by the Free Software Foundation.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+require "English"
+require "time"
+
+require "json"
+
+module Groonga
+  module GrntestLog
+    class EnvironmentEvent
+      def initialize(environment)
+        @environment = environment
+      end
+
+      def script
+        @environment["script"]
+      end
+
+      def user
+        @environment["user"]
+      end
+
+      def date
+        Time.parse(@environment["date"])
+      end
+
+      def cpu
+        @environment["cpu"]
+      end
+
+      def bit
+        @environment["bit"]
+      end
+
+      def core
+        @environment["core"]
+      end
+
+      def ram
+        @environment["RAM"]
+      end
+
+      def unevictable
+        @environment["Unevictable"]
+      end
+
+      def mlocked
+        @environment["Mlocked"]
+      end
+
+      def total_memory
+        parse_size_with_unit(ram)
+      end
+
+      def unevictable_memory
+        parse_size_with_unit(unevictable)
+      end
+
+      def locked_memory
+        parse_size_with_unit(mlocked)
+      end
+
+      def hdd
+        @environment["HDD"]
+      end
+
+      def disk_size
+        parse_size_with_unit(hdd)
+      end
+
+      def os
+        @environment["OS"]
+      end
+
+      def host
+        @environment["HOST"]
+      end
+
+      def port
+        @environment["PORT"]
+      end
+
+      def version
+        @environment["VERSION"]
+      end
+
+      private
+      def parse_size_with_unit(size_with_unit)
+        case size_with_unit
+        when /\A(\d+)\z/
+          $1.to_i
+        when /\A(\d+)([KM])Bytes\z/
+          size = $1.to_i
+          unit = $2
+          case unit
+          when "K"
+            size * 1024
+          when "M"
+            size * (1024 ** 2)
+          else
+            raise ArgumentError,
+                  "unknown size unit: <#{unit}>: <#{size_with_unit}>"
+          end
+        else
+          raise ArgumentError, "unknown size: <#{size_with_unit}>"
+        end
+      end
+    end
+
+    class JobsStartEvent
+      attr_reader :jobs
+      def initialize(jobs)
+        @jobs = jobs
+      end
+    end
+
+    class TaskEvent < Struct.new(:id, :command,
+                                 :relative_start_time, :relative_end_time,
+                                 :result)
+      def elapsed_time
+        relative_end_time - relative_start_time
+      end
+    end
+
+    class JobSummaryEvent
+      attr_reader :job, :latency, :elapsed, :qps, :min, :max, :n_queries
+      def initialize(summary)
+        @job = summary["job"]
+        @total_elapsed_time = summary["total_elapsed_time"] || summary["latency"]
+        @job_elapsed_time = summary["job_elapsed_time"] || summary["self"]
+        @qps = summary["qps"]
+        @min = summary["min"]
+        @max = summary["max"]
+        @n_queries = summary["n_queries"] || summary["queries"]
+      end
+    end
+
+    class JobsEndEvent
+      attr_reader :summaries
+      def initialize(summaries)
+        @summaries = summaries
+      end
+    end
+
+    class Parser
+      def initialize
+      end
+
+      def parse(input, &block)
+        in_environment = false
+        buffer = ""
+        input.each_line do |line|
+          if in_environment
+            case line
+            when "},\n"
+              buffer << "}"
+              yield(EnvironmentEvent.new(parse_json(buffer)))
+              buffer.clear
+              in_environment = false
+            else
+              buffer << line
+            end
+          else
+            case line
+            when /\A\[\{"script":/
+              buffer << line[1..-1]
+              in_environment = true
+            when /\A\{"jobs":/
+              yield(JobsStartEvent.new(parse_json(line.sub(/,$/, "}"))))
+            when /\A"detail": \[$/
+              # ignore
+            when /\A\[\d+,/
+              yield(TaskEvent.new(*parse_json(line.sub(/\]+,$/, "]"))))
+            when /\A"summary": /
+              summaries = parse_json(line.gsub(/(?:\A"summary": |\},$)/, ''))
+              summaries = summaries.collect do |summary|
+                JobSummaryEvent.new(summary)
+              end
+              yield(JobsEndEvent.new(summaries))
+            end
+          end
+        end
+      end
+
+      private
+      def parse_json(string)
+        JSON.parse(string)
+      end
+    end
+  end
+end

data/lib/groonga/pagination.rb

@@ -69,8 +69,8 @@ module Groonga
     # ページネーション用便利メソッド。ページネーションをした
     # い場合は #sort よりも #paginate の方が便利。
     #
-    # 説明文（descriptionカラム）を「Ruby」で全文検索し、検
-    # 索結果をスコアの高い順にソートして、10項目ずつ表示する
+    # 説明文（descriptionカラム）を「Ruby」で全文検索し、
+    # 検索結果をスコアの高い順にソートして、10項目ずつ表示する
     # 場合は以下のようになる。
     #
     #   query = "Ruby"
@@ -95,14 +95,16 @@ module Groonga
     # _sort_keys_ には ソートに用いる情報を指定する。
     # 指定の仕方は #sort と同様なので、詳細は #sort を参照。
     #
-    # _options_に指定可能な値は以下の通り。
+    # _options_ に指定可能な値は以下の通り。
     #
-    # [+:size+]
-    #   1ページあたりに表示する最大項目数。デフォルトは10。
+    # @param [::Hash] options The name and value
+    #   pairs. Omitted names are initialized as the default value.
+    # @option options [Integer] :size (10) The size
     #
-    # [+:page+]
-    #   ページ番号。ページ番号は0ベースではなく1ベースである
-    #   ことに注意。デフォルトは1ページ目。
+    #   1ページあたりに表示する最大項目数。
+    # @option options [Integer] :page (1) The page
+    #
+    #   ページ番号。ページ番号は0ベースではなく1ベースであることに注意。
     def paginate(sort_keys, options={})
       _size = size
       page_size = options[:size] || 10
@@ -142,7 +144,7 @@ module Groonga
     # 全レコード数。
     attr_reader :n_records
 
-    # 2ページ以上ある場合は+true+を返す。
+    # 2ページ以上ある場合は +true+ を返す。
     def have_pages?
       @n_pages > 1
     end
@@ -152,7 +154,7 @@ module Groonga
       1
     end
 
-    # 現在のページが最初のページなら+true+を返す。
+    # 現在のページが最初のページなら +true+ を返す。
     def first_page?
       @current_page == first_page
     end
@@ -162,29 +164,29 @@ module Groonga
       @n_pages
     end
 
-    # 現在のページが最後のページなら+true+を返す。
+    # 現在のページが最後のページなら +true+ を返す。
     def last_page?
       @current_page == last_page
     end
 
-    # 次のページがあるなら+true+を返す。
+    # 次のページがあるなら +true+ を返す。
     def have_next_page?
       @current_page < @n_pages
     end
 
-    # 次のページ番号を返す。次のページがない場合は+nil+を返
-    # す。
+    # 次のページ番号を返す。次のページがない場合は +nil+
+    # を返す。
     def next_page
       have_next_page? ? @current_page + 1 : nil
     end
 
-    # 前のページがあるなら+true+を返す。
+    # 前のページがあるなら +true+ を返す。
     def have_previous_page?
       @current_page > 1
     end
 
-    # 前のページ番号を返す。前のページがない場合は+nil+を返
-    # す。
+    # 前のページ番号を返す。前のページがない場合は +nil+
+    # を返す。
     def previous_page
       have_previous_page? ? @current_page - 1 : nil
     end
@@ -199,7 +201,7 @@ module Groonga
     # あることに注意。つまり、最初のレコードは0番目のレコー
     # ドではなく、1番目のレコードになる。
     #
-    # レコードが1つもない場合は+nil+を返す。
+    # レコードが1つもない場合は +nil+ を返す。
     def start_offset
       return nil if @n_records.zero?
       1 + (@current_page - 1) * @page_size
@@ -210,7 +212,7 @@ module Groonga
     # あることに注意。つまり、最初のレコードは0番目のレコー
     # ドではなく、1番目のレコードになる。
     #
-    # レコードが1つもない場合は+nil+を返す。
+    # レコードが1つもない場合は +nil+ を返す。
     def end_offset
       return nil if @n_records.zero?
       [start_offset + @page_size - 1, @n_records].min