rroonga 6.0.4 → 6.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 63fc245a4ac5578801876a163c130181f438c5c4
-  data.tar.gz: 79adf7a48032d18952be5fcb0ae97b710cdf5e00
+  metadata.gz: 21579f26130016f0232888646e9b65d405c0f943
+  data.tar.gz: f6a1817d3951f0b8f2553ca67235a50aef56677c
 SHA512:
-  metadata.gz: 4783b0f4fcaf4cfff8decea7df6dccef726f4d46f074e11a68e81777699c8d42a77d9efc1911ec1a03c33bd2ab92499ece866d35b5970fe2f63e91c5938ee160
-  data.tar.gz: a3e0d9eebbd09b672650b2261bcc16ee1ebed5e05f92e501244963b27782cfdbae096c6aa5a9b945e9a73552aac1ec5d41ee7f0855d05bf1b93f9245cd9b834b
+  metadata.gz: 170e20bca5a5568bd99b646a3083b944f9b4ae5fc54f1e1322c3c5e8fc8b9423fd8d9e274341b189e192083ea4671b7c2eef40b774e24f6624cf58095de41590
+  data.tar.gz: 7854edb1da626c4120602f8c61b188d11944e1bb0f6d1f4ee4e25fd0b9f810f555e18c570fa927f765f70c452715e444486c0dff562e886a9caccd553d6f95d5

data/doc/text/news.md

@@ -1,5 +1,44 @@
 # NEWS
 
+## 6.0.5: 2016-07-15 {#version-6-0-5}
+
+### Improvements
+
+  * Supported Groonga 6.0.5. Groonga 6.0.4 or older aren't supported.
+
+  * {Groonga::ID}: Added a module that provided object ID related
+    features.
+
+  * {Groonga::ID.builtin?}: Added a new predicate method that checks
+    whether the given ID is ID for builtin object or not.
+
+  * {Groonga::ID::NIL}: Added a new constant that represents invalid ID.
+
+  * {Groonga::ID::MAX}: Added a new constant that represents the maximum ID.
+
+  * {Groonga::Name}: Added a new module that provides object name
+    related features.
+
+  * {Groonga::Name.column?}: Added a new predicate method that checks
+    whether the given name is column object name or not.
+
+  * {Groonga::Object#column?}: Added a new predicate for column.
+
+  * {Groonga::Object#reference_column?}: Added a new predicate for
+    column that uses table as value type.
+
+  * {Groonga::Object#index_column?}: Added a new predicate for
+    index column.
+
+  * {Groonga::Object#touch}: Added a new method that updates the last
+    modified time of the object.
+
+  * {Groonga::Object#last_modified}: Added a new method that returns
+    the last modified time of the object.
+
+  * {Groonga::Object#dirty?}: Added a new method that checks whether
+    the object is changed after the last flush.
+
 ## 6.0.4: 2016-06-14 {#version-6-0-4}
 
 ### Improvements

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

@@ -0,0 +1,56 @@
+/* -*- mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+  Copyright (C) 2016  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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include "rb-grn.h"
+
+/*
+ * Document-class: Groonga::ID
+ *
+ * This module provides Groonga ID related features.
+ */
+
+/*
+ * @overload builtin?(id)
+ *   @param [Integer] id The ID to be confirmed.
+ *   @return [Boolean] `true` if the `id` is builtin, `false` otherwise.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_id_s_builtin_p (VALUE self, VALUE rb_id)
+{
+    grn_ctx *ctx = NULL;
+    grn_id id;
+
+    id = NUM2INT(rb_id);
+
+    return CBOOL2RVAL(grn_id_is_builtin(ctx, id));
+}
+
+void
+rb_grn_init_id (VALUE mGrn)
+{
+    VALUE mGrnID;
+
+    mGrnID = rb_define_module_under(mGrn, "ID");
+
+    rb_define_const(mGrnID, "NIL", INT2NUM(GRN_ID_NIL));
+    rb_define_const(mGrnID, "MAX", INT2NUM(GRN_ID_MAX));
+
+    rb_define_singleton_method(mGrnID, "builtin?", rb_grn_id_s_builtin_p, 1);
+}

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

@@ -0,0 +1,55 @@
+/* -*- mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+  Copyright (C) 2016  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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include "rb-grn.h"
+
+/*
+ * Document-class: Groonga::Name
+ *
+ * This module provides object name related features.
+ */
+
+/*
+ * @overload column?(name)
+ *   @param [String] name The name to be confirmed.
+ *   @return [Boolean] `true` if the `name` is column, `false` otherwise.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_name_s_column_p (VALUE self, VALUE rb_name)
+{
+    grn_ctx *ctx = NULL;
+    const char *name;
+    size_t name_size;
+
+    name = StringValueCStr(rb_name);
+    name_size = RSTRING_LEN(rb_name);
+
+    return CBOOL2RVAL(grn_obj_name_is_column(ctx, name, name_size));
+}
+
+void
+rb_grn_init_name (VALUE mGrn)
+{
+    VALUE mGrnName;
+
+    mGrnName = rb_define_module_under(mGrn, "Name");
+
+    rb_define_singleton_method(mGrnName, "column?", rb_grn_name_s_column_p, 1);
+}

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

@@ -1549,6 +1549,83 @@ rb_grn_object_table_p (VALUE self)
     return CBOOL2RVAL(table_p);
 }
 
+/*
+ * Checks whether the object is column or not.
+ *
+ * @overload column?
+ *   @return [Boolean] `true` if the object is column, `false` otherwise.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_object_column_p (VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    grn_bool column_p = GRN_FALSE;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+                              NULL, NULL, NULL, NULL);
+
+    if (context && object) {
+        column_p = grn_obj_is_column(context, object);
+    }
+
+    return CBOOL2RVAL(column_p);
+}
+
+/*
+ * Checks whether the object is reference column or not.
+ *
+ * @overload reference_column?
+ *   @return [Boolean] `true` if the object is reference column,
+ *     `false` otherwise.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_object_reference_column_p (VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    grn_bool reference_column_p = GRN_FALSE;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+                              NULL, NULL, NULL, NULL);
+
+    if (context && object) {
+        reference_column_p = grn_obj_is_reference_column(context, object);
+    }
+
+    return CBOOL2RVAL(reference_column_p);
+}
+
+/*
+ * Checks whether the object is index column or not.
+ *
+ * @overload index_column?
+ *   @return [Boolean] `true` if the object is index column,
+ *     `false` otherwise.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_object_index_column_p (VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    grn_bool index_column_p = GRN_FALSE;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+                              NULL, NULL, NULL, NULL);
+
+    if (context && object) {
+        index_column_p = grn_obj_is_index_column(context, object);
+    }
+
+    return CBOOL2RVAL(index_column_p);
+}
+
 /*
  * Checks whether the object is procedure or not.
  *
@@ -1767,6 +1844,84 @@ rb_grn_object_key_accessor_p (VALUE self)
     return CBOOL2RVAL(key_accessor_p);
 }
 
+/*
+ * Update the last modified time of the `object`. It's meaningful only
+ * for persistent database, table and column.
+ *
+ * @overload touch(time=nil)
+ *   @param [Time, nil] time (nil) The last modified time.
+ *     If `time` is `nil`, the current time is used.
+ *   @return [void]
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_object_touch (int argc, VALUE *argv, VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    VALUE rb_time;
+    grn_timeval time_buffer;
+    grn_timeval *time = NULL;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+                              NULL, NULL, NULL, NULL);
+    if (!context || !object) {
+        return Qnil;
+    }
+
+    rb_scan_args(argc, argv, "01", &rb_time);
+    if (!NIL_P(rb_time)) {
+        time_buffer.tv_sec = NUM2LONG(rb_funcall(rb_time, rb_intern("sec"), 0));
+        time_buffer.tv_nsec = NUM2INT(rb_funcall(rb_time, rb_intern("nsec"), 0));
+        time = &time_buffer;
+    }
+
+    grn_obj_touch(context, object, time);
+    rb_grn_context_check(context, self);
+
+    return Qnil;
+}
+
+/*
+ * @overload last_modified
+ *   @return [Time] The last modified time of the object.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_object_get_last_modified (VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    uint32_t last_modified;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+                              NULL, NULL, NULL, NULL);
+    last_modified = grn_obj_get_last_modified(context, object);
+    return rb_funcall(rb_cTime, rb_intern("at"), 1, UINT2NUM(last_modified));
+}
+
+
+/*
+ * @overload dirty?
+ *   @return [Boolean] `true` if the object isn't flushed after the last change.
+ *
+ * @since 6.0.5
+ */
+static VALUE
+rb_grn_object_dirty_p (VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *object;
+    grn_bool is_dirty;
+
+    rb_grn_object_deconstruct(SELF(self), &object, &context,
+                              NULL, NULL, NULL, NULL);
+    is_dirty = grn_obj_is_dirty(context, object);
+    return CBOOL2RVAL(is_dirty);
+}
+
 void
 rb_grn_init_object (VALUE mGrn)
 {
@@ -1803,6 +1958,11 @@ rb_grn_init_object (VALUE mGrn)
 
     rb_define_method(rb_cGrnObject, "builtin?", rb_grn_object_builtin_p, 0);
     rb_define_method(rb_cGrnObject, "table?", rb_grn_object_table_p, 0);
+    rb_define_method(rb_cGrnObject, "column?", rb_grn_object_column_p, 0);
+    rb_define_method(rb_cGrnObject, "reference_column?",
+                     rb_grn_object_reference_column_p, 0);
+    rb_define_method(rb_cGrnObject, "index_column?",
+                     rb_grn_object_index_column_p, 0);
     rb_define_method(rb_cGrnObject, "procedure?", rb_grn_object_procedure_p, 0);
     rb_define_method(rb_cGrnObject, "function_procedure?",
                      rb_grn_object_function_procedure_p, 0);
@@ -1818,4 +1978,10 @@ rb_grn_init_object (VALUE mGrn)
                      rb_grn_object_accessor_p, 0);
     rb_define_method(rb_cGrnObject, "key_accessor?",
                      rb_grn_object_key_accessor_p, 0);
+
+    rb_define_method(rb_cGrnObject, "touch", rb_grn_object_touch, -1);
+    rb_define_method(rb_cGrnObject, "last_modified",
+                     rb_grn_object_get_last_modified, 0);
+    rb_define_method(rb_cGrnObject, "dirty?",
+                     rb_grn_object_dirty_p, 0);
 }

data/ext/groonga/rb-grn.h

@@ -99,7 +99,7 @@ RB_GRN_BEGIN_DECLS
 
 #define RB_GRN_MAJOR_VERSION 6
 #define RB_GRN_MINOR_VERSION 0
-#define RB_GRN_MICRO_VERSION 4
+#define RB_GRN_MICRO_VERSION 5
 
 #define RB_GRN_OBJECT(object) ((RbGrnObject *)(object))
 #define RB_GRN_NAMED_OBJECT(object) ((RbGrnNamedObject *)(object))
@@ -365,6 +365,8 @@ void           rb_grn_init_index                    (VALUE mGrn);
 void           rb_grn_init_request_canceler         (VALUE mGrn);
 void           rb_grn_init_request_timer            (VALUE mGrn);
 void           rb_grn_init_request_timer_id         (VALUE mGrn);
+void           rb_grn_init_id                       (VALUE mGrn);
+void           rb_grn_init_name                     (VALUE mGrn);
 
 VALUE          rb_grn_rc_to_exception               (grn_rc rc);
 const char    *rb_grn_rc_to_message                 (grn_rc rc);

data/ext/groonga/rb-groonga.c

@@ -252,4 +252,6 @@ Init_groonga (void)
     rb_grn_init_request_canceler(mGrn);
     rb_grn_init_request_timer(mGrn);
     rb_grn_init_request_timer_id(mGrn);
+    rb_grn_init_id(mGrn);
+    rb_grn_init_name(mGrn);
 }

data/rroonga-build.rb

@@ -18,15 +18,15 @@ module RroongaBuild
   module RequiredGroongaVersion
     MAJOR = 6
     MINOR = 0
-    MICRO = 4
+    MICRO = 5
     VERSION = [MAJOR, MINOR, MICRO]
-    RELEASED_DATE = Time.utc(2016, 6, 6)
+    RELEASED_DATE = Time.utc(2016, 6, 29)
   end
 
   module LatestGroongaVersion
     MAJOR = 6
     MINOR = 0
-    MICRO = 4
+    MICRO = 5
     VERSION = [MAJOR, MINOR, MICRO]
   end
 

data/test/test-column.rb

@@ -349,6 +349,40 @@ class ColumnTest < Test::Unit::TestCase
     end
   end
 
+  def test_column?
+    assert do
+      @users_name_column.column?
+    end
+  end
+
+  sub_test_case "#reference_column" do
+    test "true" do
+      assert do
+        @bookmarks_user.reference_column?
+      end
+    end
+
+    test "false" do
+      assert do
+        not @users_name_column.reference_column?
+      end
+    end
+  end
+
+  sub_test_case "#index_column?" do
+    test "true" do
+      assert do
+        @bookmarks_index_content.index_column?
+      end
+    end
+
+    test "false" do
+      assert do
+        not @users_name_column.index_column?
+      end
+    end
+  end
+
   private
   def assert_content_search(expected_records, term)
     records = @bookmarks_index_content.search(term).records

data/test/test-database.rb

@@ -366,4 +366,25 @@ class DatabaseTest < Test::Unit::TestCase
                    @database.disk_usage)
     end
   end
+
+  class LastModifiedTest < self
+    setup :setup_database
+
+    def test_touch
+      assert_equal(Time.at(0), @database.last_modified)
+      @database.touch
+      assert_equal(Time.now.sec, @database.last_modified.sec)
+    end
+
+    def test_dirty?
+      omit("TODO: Enable this after Groonga 6.0.6 is released.")
+      assert do
+        not @database.dirty?
+      end
+      @database.touch
+      assert do
+        @database.dirty?
+      end
+    end
+  end
 end

data/test/test-id.rb

@@ -0,0 +1,47 @@
+# Copyright (C) 2016  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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+class IDTest < Test::Unit::TestCase
+  include GroongaTestUtils
+
+  setup :setup_database
+
+  test "NIL" do
+    assert_equal(0, Groonga::ID::NIL)
+  end
+
+  test "MAX" do
+    assert_equal(2 ** 30 - 1, Groonga::ID::MAX)
+  end
+
+  sub_test_case(".builtin?") do
+    test "true" do
+      assert do
+        Groonga::ID.builtin?(Groonga::Type::INT32)
+      end
+    end
+
+    test "false" do
+      Groonga::Schema.define do |schema|
+        schema.create_table("Users", :type => :hash)
+      end
+      users_id = Groonga["Users"].id
+
+      assert do
+        not Groonga::ID.builtin?(users_id)
+      end
+    end
+  end
+end

data/test/test-name.rb

@@ -0,0 +1,34 @@
+# Copyright (C) 2016  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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+class NameTest < Test::Unit::TestCase
+  include GroongaTestUtils
+
+  setup :setup_database
+
+  sub_test_case(".column?") do
+    test "true" do
+      assert do
+        Groonga::Name.column?("Users.age")
+      end
+    end
+
+    test "false" do
+      assert do
+        not Groonga::Name.column?("Users")
+      end
+    end
+  end
+end

data/test/test-table.rb

@@ -561,7 +561,7 @@ class TableTest < Test::Unit::TestCase
     ruby_bookmarks = bookmarks.select {|record| (record["title"] == "Ruby") &
                                                 (record["title"] == "Ruby") }
     all_bookmarks = bookmarks.select
-    assert_equal([["groonga", 1], ["Ruby", 2]],
+    assert_equal([["groonga", 1.0], ["Ruby", 3.0]],
                  all_bookmarks.merge!(ruby_bookmarks).collect do |record|
                    [record[".title"], record.score]
                  end)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rroonga
 version: !ruby/object:Gem::Version
-  version: 6.0.4
+  version: 6.0.5
 platform: ruby
 authors:
 - Kouhei Sutou
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-14 00:00:00.000000000 Z
+date: 2016-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pkg-config
@@ -254,6 +254,7 @@ files:
 - ext/groonga/rb-grn-greater-operator.c
 - ext/groonga/rb-grn-hash-cursor.c
 - ext/groonga/rb-grn-hash.c
+- ext/groonga/rb-grn-id.c
 - ext/groonga/rb-grn-index-column.c
 - ext/groonga/rb-grn-index-cursor.c
 - ext/groonga/rb-grn-index.c
@@ -261,6 +262,7 @@ files:
 - ext/groonga/rb-grn-less-operator.c
 - ext/groonga/rb-grn-logger.c
 - ext/groonga/rb-grn-match-operator.c
+- ext/groonga/rb-grn-name.c
 - ext/groonga/rb-grn-normalizer.c
 - ext/groonga/rb-grn-not-equal-operator.c
 - ext/groonga/rb-grn-object.c
@@ -344,11 +346,13 @@ files:
 - test/test-geo-point.rb
 - test/test-gqtp.rb
 - test/test-hash.rb
+- test/test-id.rb
 - test/test-index-column.rb
 - test/test-index-cursor.rb
 - test/test-lock-timeout.rb
 - test/test-logger.rb
 - test/test-memory-pool.rb
+- test/test-name.rb
 - test/test-normalizer.rb
 - test/test-operator.rb
 - test/test-package-label.rb
@@ -450,6 +454,7 @@ test_files:
 - test/test-index-cursor.rb
 - test/test-schema-type.rb
 - test/test-database.rb
+- test/test-id.rb
 - test/test-request-canceler.rb
 - test/test-logger.rb
 - test/test-table.rb
@@ -463,6 +468,7 @@ test_files:
 - test/test-request-timer.rb
 - test/test-sub-records.rb
 - test/test-schema-create-table.rb
+- test/test-name.rb
 - test/test-schema.rb
 - test/test-command-select.rb
 - test/test-expression-builder.rb