rroonga 1.2.9 → 1.3.0

data/ext/groonga/rb-grn-type.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
 
@@ -52,24 +52,28 @@ rb_grn_type_to_ruby_object (grn_ctx *context, grn_obj *type,
  * call-seq:
  *   Groonga::Type.new(name, options={})
  *
- * 名前が_name_の型を作成する。_options_に指定可能な値は以下の通
+ * 名前が _name_ の型を作成する。 _options_ に指定可能な値は以下の通
  * り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value
+ * @option options :type (variable) The type
  *
- * [+:type+]
  *   :integer（符号付き整数）、:int（:integerの省略
  *   形）、:unsigned_integer（符号なし整
  *   数）、:uint（:unsigned_integerの省略形）、:float（浮動小
  *   数点数）、:variable（可変長文字列）のいずれかを指定する。
  *   省略した場合は:variableを指定したものと扱う。
  *
- *   :variableを指定した場合は必ず+:size+を指定しなければいけない。
+ *   :variableを指定した場合は必ず +:size+ を指定しなければいけない。
+ *
+ * @option options :context The context
  *
- * [+:context+]
  *   型の作成時に利用するGroonga::Contextを指定する。省略すると
  *   Groonga::Context.defaultを用いる。
  *
- * [+:size+]
- *   +:option+が:variableの場合は最大長、それ以外の場合は長さを
+ * @option options :size The size
+ *
+ *   +:option+ が:variableの場合は最大長、それ以外の場合は長さを
  *   指定する(単位:byte)。
  */
 static VALUE

data/ext/groonga/rb-grn-utils.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /* vim: set sts=4 sw=4 ts=8 noet: */
 /*
   Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
@@ -222,6 +222,7 @@ rb_grn_bulk_to_ruby_object_by_range_type (grn_ctx *context, grn_obj *bulk,
     switch (range->header.type) {
       case GRN_TABLE_HASH_KEY:
       case GRN_TABLE_PAT_KEY:
+      case GRN_TABLE_DAT_KEY:
       case GRN_TABLE_NO_KEY:
 	{
 	    grn_id id;
@@ -765,6 +766,7 @@ rb_grn_key_from_ruby_object (VALUE rb_key, grn_ctx *context,
 	break;
       case GRN_TABLE_HASH_KEY:
       case GRN_TABLE_PAT_KEY:
+      case GRN_TABLE_DAT_KEY:
       case GRN_TABLE_NO_KEY:
 	id = RVAL2GRNID(rb_key, context, domain, related_object);
 	break;
@@ -836,6 +838,7 @@ rb_grn_obj_to_ruby_object (VALUE klass, grn_ctx *context,
       /* case GRN_EXPR: */
       /* case GRN_TABLE_HASH_KEY: */
       /* case GRN_TABLE_PAT_KEY: */
+      /* case GRN_TABLE_DAT_KEY: */
       /* case GRN_TABLE_NO_KEY: */
       /* case GRN_DB: */
       /* case GRN_COLUMN_FIX_SIZE: */

data/ext/groonga/rb-grn-variable-size-column.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
 

data/ext/groonga/rb-grn-variable.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
 
@@ -81,7 +81,7 @@ rb_grn_variable_get_value (VALUE self)
  * call-seq:
  *   variable.value=(value)
  *
- * 変数の値を_value_に設定する。
+ * 変数の値を _value_ に設定する。
  */
 static VALUE
 rb_grn_variable_set_value (VALUE self, VALUE value)

data/ext/groonga/rb-grn-view-accessor.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2010  Kouhei Sutou <kou@clear-code.com>
 

data/ext/groonga/rb-grn-view-cursor.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2010  Kouhei Sutou <kou@clear-code.com>
 

data/ext/groonga/rb-grn-view-record.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2010  Kouhei Sutou <kou@clear-code.com>
 

data/ext/groonga/rb-grn-view.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2010-2011  Kouhei Sutou <kou@clear-code.com>
 
@@ -47,45 +47,51 @@ VALUE rb_cGrnView;
  * ビューにテーブルを追加するときはGroonga::View#add_tableを
  * 使う。
  *
- * _options_に指定可能な値は以下の通り。
+ * _options_ に指定可能な値は以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value
+ * @option options :context (Groonga::Context.default)
  *
- * [+:context+]
- *   ビューが利用するGroonga::Context。省略すると
- *   Groonga::Context.defaultを用いる。
+ *   ビューが利用するGroonga::Context。
+ *
+ * @option options :name The view name
  *
- * [+:name+]
  *   ビューの名前。名前をつけると、Groonga::Context#[]に名
  *   前を指定してビューを取得することができる。省略すると
  *   無名ビューになり、ビューIDでのみ取得できる。
  *
- * [+:path+]
+ * @option options :path The path
+ *
  *   ビューを保存するパス。パスを指定すると永続ビューとな
  *   り、プロセス終了後もレコードは保持される。次回起動時に
  *   Groonga::View.openで保存されたビューを利用することが
  *   できる。省略すると一時ビューになり、プロセスが終了する
  *   とビューは破棄される。
  *
- * [+:persistent+]
- *   +true+を指定すると永続ビューとなる。+path+を省略した
- *   場合は自動的にパスが付加される。+:context+で指定した
+ * @option options :persistent The persistent
+ *
+ *   +true+ を指定すると永続ビューとなる。 +path+ を省略した
+ *   場合は自動的にパスが付加される。 +:context+ で指定した
  *   Groonga::Contextに結びついているデータベースが一時デー
  *   タベースの場合は例外が発生する。
  *
- * 使用例:
- *
- * 無名一時ビューを生成する。
- *   Groonga::View.create
+ * @example
+ *   無名一時ビューを生成する。
+ *     Groonga::View.create
  *
- * 無名永続ブーを生成する。
- *   Groonga::View.create(:path => "/tmp/view.grn")
+ * @example
+ *   無名永続ビューを生成する。
+ *     Groonga::View.create(:path => "/tmp/view.grn")
  *
- * 名前付き永続ビューを生成する。ただし、ファイル名は気に
- * しない。
- *   Groonga::View.create(:name => "Entries",
- *                        :persistent => true)
+ * @example
+ *   名前付き永続ビューを生成する。ただし、ファイル名は気に
+ *   しない。
+ *     Groonga::View.create(:name => "Entries",
+ *                          :persistent => true)
  *
- * +Users+テーブルと+Dogs+テーブルを横断検索するための
- * るビューを生成する。
+ * @example
+ *   +Users+ テーブルと +Dogs+ テーブルを横断検索するための
+ *   るビューを生成する。
  *   entries = Groonga::View.create(:name => "Entries")
  *   entries.add_table("Users")
  *   entries.add_table("Dogs")
@@ -141,7 +147,7 @@ rb_grn_view_s_create (int argc, VALUE *argv, VALUE klass)
  * call-seq:
  *   view.add_table(table)
  *
- * _table_をビューからアクセスできるようにする。
+ * _table_ をビューからアクセスできるようにする。
  */
 static VALUE
 rb_grn_view_add_table (VALUE self, VALUE rb_table)
@@ -218,7 +224,7 @@ rb_grn_view_each (VALUE self)
  * call-seq:
  *   view.column_value(id, name) -> 値
  *
- * _view_の_id_に対応するカラム_name_の値を返す。
+ * _view_ の _id_ に対応するカラム _name_ の値を返す。
  */
 static VALUE
 rb_grn_view_get_column_value (VALUE self, VALUE rb_id, VALUE rb_name)
@@ -256,25 +262,28 @@ rb_grn_view_get_column_value (VALUE self, VALUE rb_id, VALUE rb_name)
  * call-seq:
  *   view.sort(keys, options={}) -> Groonga::ViewRecordの配列
  *
- * テーブルに登録されているレコードを_keys_で指定されたルー
+ * テーブルに登録されているレコードを _keys_ で指定されたルー
  * ルに従ってソートしたレコードの配列を返す。
- *
- *   [
+ * <pre>
+ *   ==[
  *    {:key => "カラム名", :order => :asc, :ascending,
  *                                   :desc, :descendingのいずれか},
  *    {:key => "カラム名", :order => :asc, :ascending,
  *                                   :desc, :descendingのいずれか},
  *    ...,
- *   ]
- *
- * _options_に指定可能な値は以下の通り。
+ *   ]==
+ * </pre>
+ * _options_ に指定可能な値は以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value
+ * @option options :offset The offset
  *
- * [+:offset+]
- *   ソートされたレコードのうち、(0ベースで)_:offset_番目
+ *   ソートされたレコードのうち、(0ベースで) _:offset_ 番目
  *   からレコードを取り出す。
  *
- * [+:limit+]
- *   ソートされたレコードのうち、_:limit_件のみを取り出す。
+ * @option options :limit The limit
+ *
+ *   ソートされたレコードのうち、 _:limit_ 件のみを取り出す。
  *   省略された場合または-1が指定された場合は、全件が指定され
  *   たものとみなす。
  */

data/ext/groonga/rb-grn.h

@@ -71,8 +71,8 @@ RB_GRN_BEGIN_DECLS
 #endif
 
 #define RB_GRN_MAJOR_VERSION 1
-#define RB_GRN_MINOR_VERSION 2
-#define RB_GRN_MICRO_VERSION 9
+#define RB_GRN_MINOR_VERSION 3
+#define RB_GRN_MICRO_VERSION 0
 
 #define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
 
@@ -206,12 +206,14 @@ RB_GRN_VAR VALUE rb_cGrnTable;
 RB_GRN_VAR VALUE rb_mGrnTableKeySupport;
 RB_GRN_VAR VALUE rb_cGrnHash;
 RB_GRN_VAR VALUE rb_cGrnPatriciaTrie;
+RB_GRN_VAR VALUE rb_cGrnDoubleArrayTrie;
 RB_GRN_VAR VALUE rb_cGrnArray;
 RB_GRN_VAR VALUE rb_cGrnView;
 RB_GRN_VAR VALUE rb_cGrnTableCursor;
 RB_GRN_VAR VALUE rb_mGrnTableCursorKeySupport;
 RB_GRN_VAR VALUE rb_cGrnHashCursor;
 RB_GRN_VAR VALUE rb_cGrnPatriciaTrieCursor;
+RB_GRN_VAR VALUE rb_cGrnDoubleArrayTrieCursor;
 RB_GRN_VAR VALUE rb_cGrnViewCursor;
 RB_GRN_VAR VALUE rb_cGrnArrayCursor;
 RB_GRN_VAR VALUE rb_cGrnType;
@@ -247,12 +249,14 @@ void           rb_grn_init_table_key_support        (VALUE mGrn);
 void           rb_grn_init_array                    (VALUE mGrn);
 void           rb_grn_init_hash                     (VALUE mGrn);
 void           rb_grn_init_patricia_trie            (VALUE mGrn);
+void           rb_grn_init_double_array_trie        (VALUE mGrn);
 void           rb_grn_init_view                     (VALUE mGrn);
 void           rb_grn_init_table_cursor             (VALUE mGrn);
 void           rb_grn_init_table_cursor_key_support (VALUE mGrn);
 void           rb_grn_init_array_cursor             (VALUE mGrn);
 void           rb_grn_init_hash_cursor              (VALUE mGrn);
 void           rb_grn_init_patricia_trie_cursor     (VALUE mGrn);
+void           rb_grn_init_double_array_trie_cursor (VALUE mGrn);
 void           rb_grn_init_view_cursor              (VALUE mGrn);
 void           rb_grn_init_type                     (VALUE mGrn);
 void           rb_grn_init_procedure                (VALUE mGrn);

data/ext/groonga/rb-groonga.c

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
 

data/lib/groonga.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2009-2010  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2009-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
@@ -39,7 +39,7 @@ require 'groonga/record'
 require 'groonga/expression-builder'
 require 'groonga/posting'
 begin
-  major, minor, micro, = RUBY_VERSION.split(/\./)
+  major, minor, _ = RUBY_VERSION.split(/\./)
   require "#{major}.#{minor}/groonga.so"
 rescue LoadError
   require 'groonga.so'
@@ -91,3 +91,5 @@ require 'groonga/patricia-trie'
 require 'groonga/dumper'
 require 'groonga/schema'
 require 'groonga/pagination'
+require 'groonga/query-log'
+require 'groonga/grntest-log'

data/lib/groonga/context.rb

@@ -17,10 +17,7 @@
 
 module Groonga
   class Context
-    # call-seq:
-    #   context.open_database(path) -> Groonga::Database
-    #
-    # _path_にある既存のデータベースを開く。ブロックを指定した場
+    # _path_ にある既存のデータベースを開く。ブロックを指定した場
     # 合はブロックに開いたデータベースを渡し、ブロックを抜けると
     # きに閉じる。
     def open_database(path, &block)
@@ -29,18 +26,14 @@ module Groonga
       Database.open(path, options, &block)
     end
 
-    # call-seq:
-    #   context.create_database(path=nil) -> Groonga::Database
-    #
-    # _path_に新しくデータベースを作成する。_path_を省略すると
+    # _path_ に新しくデータベースを作成する。 _path_ を省略すると
     # 一時データベースとなる。
     #
-    # 使用例は以下の通り。
-    #
-    # 一時データベースを作成:
+    # @example
+    #   #一時データベースを作成:
     #   context.create_database
     #
-    # 永続データベースを作成:
+    #   #永続データベースを作成:
     #   context.create_database("/tmp/db.groonga")
     def create_database(path=nil)
       options = {:context => self}
@@ -51,12 +44,8 @@ module Groonga
       Database.create(options)
     end
 
-    # call-seq:
-    #   context.register_plugin(name)
-    #   context.register_plugin({:path => path})
-    #
-    # groongaのプラグインディレクトリにあるプラグイン_name_
-    # を登録する。_path_を指定するとプラグインディレクトリ以
+    # groongaのプラグインディレクトリにあるプラグイン _name_
+    # を登録する。 _path_ を指定するとプラグインディレクトリ以
     # 外にあるプラグインを登録することができる。
     def register_plugin(name_or_options)
       options = {:context => self}
@@ -68,19 +57,17 @@ module Groonga
       end
     end
 
-    # call-seq:
-    #   context.select(table, options={}) -> SelectResult
-    #
-    # _table_から指定した条件にマッチするレコードの値を取得
-    # する。_table_はテーブル名かテーブルオブジェクトを指定
+    # _table_ から指定した条件にマッチするレコードの値を取得
+    # する。 _table_ はテーブル名かテーブルオブジェクトを指定
     # する。
     #
-    # _options_に指定できるキーは以下の通り。
+    # _options_ に指定できるキーは以下の通り。
+    # @param [::Hash] options The name and value
+    #   pairs. Omitted names are initialized as the default value.
+    # @option options [Array] output_columns The output_columns
     #
-    # [_output_columns_] 値を取得するカラムを指定する。
-    # [_XXX_] TODO
-    #
-    # 例:
+    #   値を取得するカラムを指定する。
+    # @option options [Array] XXX TODO
     #   TODO
     def select(table, options={})
       select = SelectCommand.new(self, table, options)
@@ -91,7 +78,7 @@ module Groonga
                                     :drill_down)
       class << self
         def parse(json, drill_down_keys)
-          select_result, *drill_down_results = parse_json(json)
+          select_result, *drill_down_results = JSON.parse(json)
           result = new
           n_hits, columns, values = extract_result(select_result)
           result.n_hits = n_hits
@@ -144,18 +131,6 @@ module Groonga
             value
           end
         end
-
-        begin
-          require 'json'
-          def parse_json(json)
-            JSON.parse(json)
-          end
-        rescue LoadError
-          require 'yaml'
-          def parse_json(json)
-            YAML.load(json)
-          end
-        end
       end
 
       def records

data/lib/groonga/dumper.rb

@@ -49,7 +49,6 @@ module Groonga
 
     private
     def dump_plugins(options)
-      first_table = true
       plugin_paths = {}
       options[:database].each(:order_by => :id) do |object|
         next unless object.is_a?(Groonga::Procedure)
@@ -138,7 +137,8 @@ module Groonga
       end
     end
 
-    class BaseSyntax # :nodoc:
+    # @private
+    class BaseSyntax
       def initialize(database, output)
         @database = database
         @output = output
@@ -223,7 +223,8 @@ module Groonga
       end
     end
 
-    class RubySyntax < BaseSyntax # :nodoc:
+    # @private
+    class RubySyntax < BaseSyntax
       private
       def create_table_header(table)
         parameters = []
@@ -347,7 +348,8 @@ module Groonga
       end
     end
 
-    class CommandSyntax < BaseSyntax # :nodoc:
+    # @private
+    class CommandSyntax < BaseSyntax
       private
       def create_table_header(table)
         parameters = []