rroonga 1.2.0 → 1.2.1

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

@@ -1,6 +1,6 @@
 /* -*- c-file-style: "ruby" -*- */
 /*
-  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
@@ -392,7 +392,7 @@ rb_grn_logger_s_set_path (VALUE klass, VALUE rb_path,
 
 /*
  * call-seq:
- *   Groonga::Logger.log_path # => log_path
+ *   Groonga::Logger.log_path # => path
  *
  * groongaのデフォルトロガーがログを出力するファイルの
  * パスを返す。
@@ -414,7 +414,7 @@ rb_grn_logger_s_get_log_path (VALUE klass)
 
 /*
  * call-seq:
- *   Groonga::Logger.log_path = log_path
+ *   Groonga::Logger.log_path= path
  *
  * groongaのデフォルトロガーがログを出力するファイルのパスを
  * 指定する。
@@ -435,7 +435,7 @@ rb_grn_logger_s_set_log_path (VALUE klass, VALUE path)
 
 /*
  * call-seq:
- *   Groonga::Logger.query_log_path # => query_log_path
+ *   Groonga::Logger.query_log_path # => path
  *
  * groongaのデフォルトロガーがクエリログを出力するファイルの
  * パスを返す。
@@ -457,7 +457,7 @@ rb_grn_logger_s_get_query_log_path (VALUE klass)
 
 /*
  * call-seq:
- *   Groonga::Logger.query_log_path = query_log_path
+ *   Groonga::Logger.query_log_path= path
  *
  * groongaのデフォルトロガーがクエリログを出力するファイルの
  * パスを指定する。

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

@@ -123,6 +123,8 @@ rb_grn_object_finalizer (grn_ctx *context, int n_args, grn_obj **grn_objects,
 	rb_grn_table_finalizer(context, grn_object,
 			       RB_GRN_TABLE(rb_grn_object));
 	break;
+      case GRN_CURSOR_COLUMN_INDEX:
+	  break;
       case GRN_COLUMN_FIX_SIZE:
       case GRN_COLUMN_VAR_SIZE:
 	rb_grn_column_finalizer(context, grn_object,
@@ -351,6 +353,7 @@ rb_grn_object_assign (VALUE klass, VALUE self, VALUE rb_context,
 	klass == rb_cGrnPatriciaTrieCursor ||
 	klass == rb_cGrnArrayCursor ||
 	klass == rb_cGrnViewCursor ||
+	klass == rb_cGrnIndexCursor ||
 	klass == rb_cGrnProcedure ||
 	klass == rb_cGrnVariable) {
 	rb_grn_object = ALLOC(RbGrnObject);
@@ -499,10 +502,33 @@ rb_grn_object_close (VALUE self)
     grn_obj *object;
     grn_ctx *context;
 
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+			      NULL, NULL, NULL, NULL);
+    if (object && context)
+	grn_obj_close(context, object);
+
+    return Qnil;
+}
+
+/*
+ * Document-method: unlink
+ *
+ * call-seq:
+ *   object.unlink
+ *
+ * _object_のリファレンスカウンタを1減少する。
+ */
+VALUE
+rb_grn_object_unlink (VALUE self)
+{
+    grn_obj *object;
+    grn_ctx *context;
+
     rb_grn_object_deconstruct(SELF(self), &object, &context,
 			      NULL, NULL, NULL, NULL);
     if (object && context)
 	grn_obj_unlink(context, object);
+
     return Qnil;
 }
 
@@ -1343,6 +1369,23 @@ rb_grn_object_remove (VALUE self)
     return Qnil;
 }
 
+static VALUE
+rb_grn_object_builtin_p (VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    grn_bool builtin = GRN_FALSE;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+			      NULL, NULL, NULL, NULL);
+
+    if (context && object) {
+	builtin = grn_obj_is_builtin(context, object);
+    }
+
+    return CBOOL2RVAL(builtin);
+}
+
 void
 rb_grn_init_object (VALUE mGrn)
 {
@@ -1368,10 +1411,15 @@ rb_grn_init_object (VALUE mGrn)
     rb_define_method(rb_cGrnObject, "close", rb_grn_object_close, 0);
     rb_define_method(rb_cGrnObject, "closed?", rb_grn_object_closed_p, 0);
 
+    rb_define_method(rb_cGrnObject, "unlink", rb_grn_object_unlink, 0);
+
     rb_define_method(rb_cGrnObject, "[]", rb_grn_object_array_reference, 1);
     rb_define_method(rb_cGrnObject, "[]=", rb_grn_object_array_set, 2);
     rb_define_method(rb_cGrnObject, "append", rb_grn_object_append_value, 2);
     rb_define_method(rb_cGrnObject, "prepend", rb_grn_object_prepend_value, 2);
 
     rb_define_method(rb_cGrnObject, "remove", rb_grn_object_remove, 0);
+
+    rb_define_method(rb_cGrnObject, "builtin?", rb_grn_object_builtin_p, 0);
+
 }

data/ext/groonga/rb-grn-patricia-trie.c

@@ -346,7 +346,7 @@ rb_grn_patricia_trie_search (int argc, VALUE *argv, VALUE self)
  *   _string_内での_word_の出現位置。（バイト単位）
  *
  * [_length_]
- *   _word_の長さ。（バイト探知）
+ *   _word_の長さ。（バイト単位）
  *
  * ブロックを指定しない場合は、マッチした部分文字列の情報を
  * まとめて配列として返す。

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

@@ -123,6 +123,34 @@ rb_grn_plugin_s_register (int argc, VALUE *argv, VALUE klass)
     return Qnil;
 }
 
+/**
+ * call-seq:
+ *   Groonga::Plugin.system_plugins_dir
+ *
+ * Returns the system plugins directory.
+ *
+ * @return The system plugins directory.
+ */
+static VALUE
+rb_grn_plugin_s_system_plugins_dir (VALUE klass)
+{
+    return rb_str_new2(grn_plugin_get_system_plugins_dir());
+}
+
+/**
+ * call-seq:
+ *   Groonga::Plugin.suffix
+ *
+ * Returns the plugin file suffix. (e.g. ".so", ".dll" and so on.)
+ *
+ * @return The plugin file suffix.
+ */
+static VALUE
+rb_grn_plugin_s_suffix (VALUE klass)
+{
+    return rb_str_new2(grn_plugin_get_suffix());
+}
+
 void
 rb_grn_init_plugin (VALUE mGrn)
 {
@@ -131,4 +159,8 @@ rb_grn_init_plugin (VALUE mGrn)
 
     rb_define_singleton_method(cGrnPlugin, "register",
 			       rb_grn_plugin_s_register, -1);
+    rb_define_singleton_method(cGrnPlugin, "system_plugins_dir",
+			       rb_grn_plugin_s_system_plugins_dir, 0);
+    rb_define_singleton_method(cGrnPlugin, "suffix",
+			       rb_grn_plugin_s_suffix, 0);
 }

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

@@ -0,0 +1,51 @@
+/* -*- c-file-style: "ruby" -*- */
+/*
+  Copyright (C) 2011  Haruka Yoshihara <yoshihara@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
+*/
+
+#include "rb-grn.h"
+
+VALUE rb_cGrnPosting;
+
+VALUE
+rb_grn_posting_new (grn_posting *posting, grn_id term_id)
+{
+    VALUE parameters;
+
+    parameters = rb_hash_new();
+
+#define SET_PARAMETER(key, value) \
+    rb_hash_aset(parameters, ID2SYM(rb_intern((key))), INT2NUM((value)))
+
+    SET_PARAMETER("record_id", posting->rid);
+    SET_PARAMETER("section_id", posting->sid);
+    SET_PARAMETER("term_id", term_id);
+    SET_PARAMETER("position", posting->pos);
+    SET_PARAMETER("term_frequency", posting->tf);
+    SET_PARAMETER("weight", posting->weight);
+    SET_PARAMETER("n_rest_postings", posting->rest);
+
+#undef SET_PARAMETER
+
+    return rb_funcall(rb_cGrnPosting, rb_intern("new"), 1,
+		      parameters);
+}
+
+void
+rb_grn_init_posting (VALUE mGrn)
+{
+    rb_cGrnPosting = rb_const_get(mGrn, rb_intern("Posting"));
+}

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

@@ -32,11 +32,16 @@ VALUE rb_cGrnTableCursor;
 grn_table_cursor *
 rb_grn_table_cursor_from_ruby_object (VALUE object, grn_ctx **context)
 {
+    grn_table_cursor *table_cursor;
+
     if (!RVAL2CBOOL(rb_obj_is_kind_of(object, rb_cGrnTableCursor))) {
 	rb_raise(rb_eTypeError, "not a groonga table cursor");
     }
 
-    return RVAL2GRNOBJECT(object, context);
+    rb_grn_table_cursor_deconstruct(SELF(object), &table_cursor, NULL,
+				    NULL, NULL,
+				    NULL, NULL);
+    return table_cursor;
 }
 
 VALUE

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

@@ -34,7 +34,7 @@ static ID id_array_set;
 /*
  * Document-class: Groonga::Table < Groonga::Object
  *
- * Ruby/groongaが提供するテーブルのベースとなるクラス。このクラス
+ * rroongaが提供するテーブルのベースとなるクラス。このクラス
  * からGroonga::Array, Groonga::Hash, Groonga::PatriciaTrie
  * が継承されている。
  */
@@ -982,13 +982,32 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
  * テーブルに登録されているレコードを_keys_で指定されたルー
  * ルに従ってソートしたレコードの配列を返す。
  *
- *   [
- *    {:key => "カラム名", :order => :asc, :ascending,
- *                                   :desc, :descendingのいずれか},
- *    {:key => "カラム名", :order => :asc, :ascending,
- *                                   :desc, :descendingのいずれか},
- *    ...,
- *   ]
+ * _order_には+:asc+, +:ascending+, +:desc+, +:descending+の
+ * いずれを指定する。
+ *
+ * [ハッシュの配列で指定する方法]
+ *   オーソドックスな指定方法。
+ *
+ *     [
+ *      {:key => "第1ソートキー", :order => order},
+ *      {:key => "第2ソートキー", :order => order},
+ *      ...,
+ *     ]
+ *
+ * [配列の配列で指定する方法]
+ *   少し簡単化した指定方法。
+ *
+ *     [
+ *      ["第1ソートキー", order],
+ *      ["第2ソートキー", order],
+ *      ...,
+ *     ]
+ *
+ * [ソートキーの配列で指定する方法]
+ *   _order_は常に昇順（+:ascending+）になるが、最も簡単
+ *   に指定できる。
+ *
+ *     ["第1ソートキー", "第2ソートキー", ...]
  *
  * _options_に指定可能な値は以下の通り。
  *
@@ -1065,14 +1084,13 @@ rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
 		     "no such column: <%s>: <%s>",
 		     rb_grn_inspect(rb_key), rb_grn_inspect(self));
 	}
-	if (NIL_P(rb_order)) {
-	    keys[i].flags = 0;
+	if (NIL_P(rb_order) ||
+	    rb_grn_equal_option(rb_order, "asc") ||
+	    rb_grn_equal_option(rb_order, "ascending")) {
+	    keys[i].flags = GRN_TABLE_SORT_ASC;
 	} else if (rb_grn_equal_option(rb_order, "desc") ||
 		   rb_grn_equal_option(rb_order, "descending")) {
 	    keys[i].flags = GRN_TABLE_SORT_DESC;
-	} else if (rb_grn_equal_option(rb_order, "asc") ||
-		   rb_grn_equal_option(rb_order, "ascending")) {
-	    keys[i].flags = GRN_TABLE_SORT_ASC;
 	} else {
 	    rb_raise(rb_eArgError,
 		     "order should be one of "

data/ext/groonga/rb-grn.h

@@ -69,7 +69,7 @@ RB_GRN_BEGIN_DECLS
 
 #define RB_GRN_MAJOR_VERSION 1
 #define RB_GRN_MINOR_VERSION 2
-#define RB_GRN_MICRO_VERSION 0
+#define RB_GRN_MICRO_VERSION 1
 
 #define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
 
@@ -149,6 +149,12 @@ struct _RbGrnIndexColumn
     grn_obj *string_query;
 };
 
+typedef struct _RbGrnIndexCursor RbGrnIndexCursor;
+struct _RbGrnIndexCursor
+{
+    RbGrnObject parent;
+};
+
 typedef struct _RbGrnAccessor RbGrnAccessor;
 struct _RbGrnAccessor
 {
@@ -210,6 +216,7 @@ RB_GRN_VAR VALUE rb_cGrnColumn;
 RB_GRN_VAR VALUE rb_cGrnFixSizeColumn;
 RB_GRN_VAR VALUE rb_cGrnVariableSizeColumn;
 RB_GRN_VAR VALUE rb_cGrnIndexColumn;
+RB_GRN_VAR VALUE rb_cGrnIndexCursor;
 RB_GRN_VAR VALUE rb_cGrnAccessor;
 RB_GRN_VAR VALUE rb_cGrnViewAccessor;
 RB_GRN_VAR VALUE rb_cGrnRecord;
@@ -249,6 +256,8 @@ void           rb_grn_init_column                   (VALUE mGrn);
 void           rb_grn_init_fix_size_column          (VALUE mGrn);
 void           rb_grn_init_variable_size_column     (VALUE mGrn);
 void           rb_grn_init_index_column             (VALUE mGrn);
+void           rb_grn_init_index_cursor             (VALUE mGrn);
+void           rb_grn_init_posting                  (VALUE mGrn);
 void           rb_grn_init_accessor                 (VALUE mGrn);
 void           rb_grn_init_view_accessor            (VALUE mGrn);
 void           rb_grn_init_record                   (VALUE mGrn);
@@ -282,7 +291,7 @@ grn_obj       *rb_grn_context_get_backward_compatibility
 const char    *rb_grn_inspect                       (VALUE object);
 void           rb_grn_scan_options                  (VALUE options, ...)
                                                      RB_GRN_GNUC_NULL_TERMINATED;
-grn_bool rb_grn_equal_option                  (VALUE option,
+grn_bool       rb_grn_equal_option                  (VALUE option,
 						     const char *key);
 
 VALUE          rb_grn_object_alloc                  (VALUE klass);
@@ -458,6 +467,9 @@ void           rb_grn_expression_finalizer          (grn_ctx *context,
 						     grn_obj *grn_object,
 						     RbGrnExpression *rb_grn_expression);
 
+VALUE          rb_grn_posting_new                   (grn_posting *posting,
+						     grn_id term_id);
+
 VALUE          rb_grn_record_new                    (VALUE table,
 						     grn_id id,
 						     VALUE values);
@@ -513,7 +525,7 @@ VALUE          rb_grn_column_expression_builder_build
 #define GRNTABLE2RVAL(context, table, owner) \
     (rb_grn_table_to_ruby_object(context, table, owner))
 
-#define RVAL2GRNTABLECURSOR(object)   (rb_grn_table_cursor_from_ruby_object(object))
+#define RVAL2GRNTABLECURSOR(object, context)   (rb_grn_table_cursor_from_ruby_object(object, context))
 #define GRNTABLECURSOR2RVAL(klass, context, cursor) \
     (rb_grn_table_cursor_to_ruby_object(klass, context, cursor, GRN_TRUE))
 #define GRNTABLECURSOR2RCLASS(object) (rb_grn_table_cursor_to_ruby_class(object))
@@ -523,6 +535,9 @@ VALUE          rb_grn_column_expression_builder_build
 #define GRNCOLUMN2RVAL(klass, context, column, owner) \
     (rb_grn_column_to_ruby_object(klass, context, column, owner))
 
+#define GRNINDEXCURSOR2RVAL(context, cursor) \
+    (rb_grn_index_cursor_to_ruby_object(context, cursor, GRN_TRUE))
+
 #define RVAL2GRNACCESSOR(object) \
     (rb_grn_accessor_from_ruby_object(object))
 #define GRNACCESSOR2RVAL(context, accessor, owner) \
@@ -634,6 +649,9 @@ VALUE          rb_grn_column_to_ruby_object         (VALUE klass,
 						     grn_ctx *context,
 						     grn_obj *column,
 						     grn_bool owner);
+VALUE          rb_grn_index_cursor_to_ruby_object   (grn_ctx *context,
+						     grn_obj *cursor,
+						     grn_bool owner);
 
 grn_query     *rb_grn_query_from_ruby_object        (VALUE object);
 VALUE          rb_grn_query_to_ruby_object          (grn_ctx *context,

data/ext/groonga/rb-groonga.c

@@ -101,7 +101,7 @@ rb_grn_init_version (VALUE mGrn)
 				   INT2NUM(RB_GRN_MICRO_VERSION));
     rb_obj_freeze(bindings_version);
     /*
-     * Ruby/groongaのバージョン。<tt>[メジャーバージョン, マ
+     * rroongaのバージョン。<tt>[メジャーバージョン, マ
      * イナーバージョン, マイクロバージョン]</tt>の配列。
      */
     rb_define_const(mGrn, "BINDINGS_VERSION", bindings_version);
@@ -129,6 +129,8 @@ Init_groonga (void)
     rb_grn_init_database(mGrn);
     rb_grn_init_table(mGrn);
     rb_grn_init_table_cursor(mGrn);
+    rb_grn_init_index_cursor(mGrn);
+    rb_grn_init_posting(mGrn);
     rb_grn_init_type(mGrn);
     rb_grn_init_procedure(mGrn);
     rb_grn_init_column(mGrn);

data/lib/groonga.rb

@@ -37,6 +37,7 @@ end
 require 'groonga/view-record'
 require 'groonga/record'
 require 'groonga/expression-builder'
+require 'groonga/posting'
 begin
   major, minor, micro, = RUBY_VERSION.split(/\./)
   require "#{major}.#{minor}/groonga.so"

data/lib/groonga/dumper.rb

@@ -32,9 +32,11 @@ module Groonga
         options[:context] ||= Groonga::Context.default
         options[:database] = options[:context].database
       end
+      options[:dump_plugins] = true if options[:dump_plugins].nil?
       options[:dump_schema] = true if options[:dump_schema].nil?
       options[:dump_tables] = true if options[:dump_tables].nil?
 
+      dump_plugins(options) if options[:dump_plugins]
       dump_schema(options) if options[:dump_schema]
       dump_tables(options) if options[:dump_tables]
 
@@ -46,6 +48,21 @@ module Groonga
     end
 
     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)
+        next if object.builtin?
+        path = object.path
+        next if path.nil?
+        next if plugin_paths.has_key?(path)
+        plugin_paths[path] = true
+        dump_plugin(object, options)
+      end
+      options[:output].write("\n") unless plugin_paths.empty?
+    end
+
     def dump_schema(options)
       SchemaDumper.new(options.merge(:syntax => :command)).dump
     end
@@ -55,7 +72,6 @@ module Groonga
       options[:database].each(:order_by => :key) do |object|
         next unless object.is_a?(Groonga::Table)
         next if object.size.zero?
-        next if lexicon_table?(object)
         next unless target_table?(options[:tables], object)
         options[:output].write("\n") if !first_table or options[:dump_schema]
         first_table = false
@@ -67,10 +83,14 @@ module Groonga
       TableDumper.new(table, options).dump
     end
 
-    def lexicon_table?(table)
-      table.support_key? and
-        table.default_tokenizer and
-        table.columns.any? {|column| column.index?}
+    def dump_plugin(plugin, options)
+      output = options[:output]
+      plugins_dir_re = Regexp.escape(Groonga::Plugin.system_plugins_dir)
+      suffix_re = Regexp.escape(Groonga::Plugin.suffix)
+      plugin_name = plugin.path.gsub!(/(?:\A#{plugins_dir_re}\/|
+                                          #{suffix_re}\z)/x,
+                                      '')
+      output.write("register #{plugin_name}\n")
     end
 
     def target_table?(target_tables, table)