groonga-command 1.4.5 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e8e7e4033e77829c575d2ef6832f8ad5c8d8883c0279d5fa56b8f368f66d671
-  data.tar.gz: ba868ba8b7f5a04b17ace4c18fe438cd7ecd2e3581d072f8cda4431d09f2ca84
+  metadata.gz: e0a884cdd095a67a74caa831f67eb420840be13eecc552f2f2f78c90d550c575
+  data.tar.gz: a3c120f49e43c621730b7776db995fc2830b53a0442431633e5dc8f2e3b70a1e
 SHA512:
-  metadata.gz: fcde76968b9b36f013419f3a38ece4caf3e81550b272a3bcf906b4c9e011be6a4d008a91ef79f7578ac0fd9365233994c1cbbf08c0ac0c25c9babfab75887193
-  data.tar.gz: 6afc4ddf0367b6de2e38de283176f92f82bd95c03d18ed25113983f16b368b207b1728db10d7fb98699766ba1d63c4f8022eb2bbd86f1c95dfa309701cda6f40
+  metadata.gz: 3cf34717db9e581a457225b247aefb5842b0a082b80269b9a8f22a1d5f5cba5a4153df1e95a5d7d861b2cf41d2f8e9a3adcb16639b76c53c66c16f25864382bf
+  data.tar.gz: 15427c409804f289c14ed6656e6fdbda9676edc2ec069acb48e619fe4a9357fef7f8d67032eb91978603bd79336843b4224a3d0ebd423c8d57317f5c09867cb2

data/doc/text/news.md

@@ -1,5 +1,47 @@
 # News
 
+## 1.5.0: 2020-09-09
+
+### Improvements
+
+  * {Groonga::Command::TableCreate}: Added support for `path`.
+
+  * {Groonga::Command::ColumnCreate}: Added support for `path`.
+
+## 1.4.9: 2020-06-14
+
+### Improvements
+
+  * {Groonga::Command::ReferenceAcquire}: Added support for
+    `reference_acquire`.
+
+  * {Groonga::Command::ReferenceRelease}: Added support for
+    `reference_release`.
+
+  * {Groonga::Command::IOFlush#recursive}: Added.
+
+  * {Groonga::Command::IOFlush#recursive_dependent?}: Added.
+
+## 1.4.8: 2020-05-03
+
+### Improvements
+
+  * {Groonga::Command::Load#build_arrow_table}: Added support for
+    float32 weight vector.
+
+## 1.4.7: 2020-01-10
+
+### Improvements
+
+  * {Groonga::Command::Load#build_arrow_table}: Added support for raw
+    values case.
+
+## 1.4.6: 2020-01-10
+
+### Improvements
+
+  * {Groonga::Command::Load#build_arrow_table}: Added.
+
 ## 1.4.5: 2019-09-02
 
 ### Improvements

data/groonga-command.gemspec

@@ -1,6 +1,6 @@
-# -*- mode: ruby; coding: utf-8 -*-
+# -*- ruby -*-
 #
-# Copyright (C) 2012-2013  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -54,12 +54,13 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency("json")
 
-  spec.add_development_dependency("test-unit")
-  spec.add_development_dependency("test-unit-notify")
-  spec.add_development_dependency("rake")
   spec.add_development_dependency("bundler")
   spec.add_development_dependency("packnga")
-  spec.add_development_dependency("yard")
+  spec.add_development_dependency("rake")
+  spec.add_development_dependency("red-arrow")
   spec.add_development_dependency("redcarpet")
+  spec.add_development_dependency("test-unit")
+  spec.add_development_dependency("test-unit-notify")
+  spec.add_development_dependency("yard")
 end
 

data/lib/groonga/command.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2017  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  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
@@ -51,6 +51,8 @@ require "groonga/command/query-log-flags-get"
 require "groonga/command/query-log-flags-remove"
 require "groonga/command/query-log-flags-set"
 require "groonga/command/range-filter"
+require "groonga/command/reference-acquire"
+require "groonga/command/reference-release"
 require "groonga/command/register"
 require "groonga/command/reindex"
 require "groonga/command/request-cancel"

data/lib/groonga/command/column-create.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2016  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -31,6 +31,7 @@ module Groonga
             :flags,
             :type,
             :source,
+            :path,
           ]
         end
       end
@@ -110,6 +111,12 @@ module Groonga
       def sources
         @sources ||= array_value(:source)
       end
+
+      # @return [String, nil] Path or nil
+      # @since 1.5.0
+      def path
+        self[:path]
+      end
     end
   end
 end

data/lib/groonga/command/io-flush.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2015  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2015-2020  Sutou Kouhei <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
@@ -44,11 +44,25 @@ module Groonga
         self[:target_name]
       end
 
-      # @return [Boolean] `recursive` parameter value.
+      # @return [String] `recursive` parameter value.
+      #
+      # @since 1.4.9
+      def recursive
+        self[:recursive]
+      end
+
+      # @return [Boolean] Whether `recursive` parameter value isn't `no`.
       #
       # @since 1.1.3
       def recursive?
-        self[:recursive] != "no"
+        recursive != "no"
+      end
+
+      # @return [Boolean] `recursive` parameter value.
+      #
+      # @since 1.4.9
+      def recursive_dependent?
+        recursive == "dependent"
       end
     end
   end

data/lib/groonga/command/load.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2017  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -16,6 +16,11 @@
 
 require "json"
 
+begin
+  require "arrow"
+rescue LoadError
+end
+
 require "groonga/command/base"
 
 module Groonga
@@ -66,6 +71,35 @@ module Groonga
         @columns ||= parse_columns(self[:columns])
       end
 
+      # Builds `Arrow::Table` for data of this `load` command.
+      #
+      # This requires red-arrow gem. If red-arrow gem isn't available,
+      # `NotImplementedError` is raised.
+      #
+      # @return [Arrow::Table, nil] `Arrow::Table` if there is one or more
+      #    records, `nil` otherwise.
+      #
+      # @since 1.4.6
+      def build_arrow_table
+        unless defined?(::Arrow)
+          raise NotImplementedError, "red-arrow is required"
+        end
+        source_lines = (original_source || "").lines
+        if source_lines.size >= 2
+          if /\s--columns\s/ =~ source_lines.first
+            target_columns = columns
+          else
+            target_columns = nil
+          end
+          target_values = JSON.parse(source_lines[1..-1].join(""))
+        else
+          target_columns = columns
+          target_values = values
+        end
+        builder = ArrowTableBuilder.new(target_columns, target_values)
+        builder.build
+      end
+
       # @return [Boolean] `true` if `output_ids` value is `"yes"`.
       #
       # @since 1.3.0
@@ -85,6 +119,152 @@ module Groonga
         return columns if columns.nil?
         columns.split(/\s*,\s*/)
       end
+
+      class ArrowTableBuilder
+        def initialize(columns, values)
+          @columns = columns
+          @values = values
+        end
+
+        def build
+          raw_table = build_raw_table
+          return nil if raw_table.empty?
+          build_arrow_table(raw_table)
+        end
+
+        private
+        def build_raw_table
+          raw_table = {}
+          if @values.first.is_a?(Array)
+            columns = @columns
+            if columns
+              records = @values
+            else
+              columns = @values.first
+              records = @values[1..-1]
+            end
+            records.each_with_index do |record, i|
+              columns.zip(record).each do |name, value|
+                raw_table[name] ||= []
+                raw_table[name][i] = value
+              end
+            end
+          else
+            @values.each_with_index do |record, i|
+              record.each do |name, value|
+                raw_table[name] ||= []
+                raw_table[name][i] = value
+              end
+            end
+            raw_table.each_key do |key|
+              if @values.size > raw_table[key].size
+                raw_table[key][@values.size - 1] = nil
+              end
+            end
+          end
+          raw_table
+        end
+
+        def build_arrow_table(raw_table)
+          arrow_fields = []
+          arrow_arrays = []
+          raw_table.each do |name, raw_array|
+            sample = raw_array.find {|element| not element.nil?}
+            case sample
+            when Array
+              data_type = nil
+              raw_array.each do |sub_raw_array|
+                next if sub_raw_array.nil?
+                data_type = detect_arrow_data_type(sub_raw_array)
+                break if data_type
+              end
+              data_type ||= :string
+              arrow_array = build_arrow_array(data_type, raw_array)
+            when Hash
+              data_type = arrow_weight_vector_data_type(sample)
+              arrow_array = build_arrow_array(data_type, raw_array)
+            else
+              data_type = detect_arrow_data_type(raw_array) || :string
+              if data_type == :string
+                raw_array = raw_array.collect do |element|
+                  element&.to_s
+                end
+              end
+              data_type = Arrow::DataType.resolve(data_type)
+              arrow_array = data_type.build_array(raw_array)
+            end
+            arrow_fields << Arrow::Field.new(name,
+                                             arrow_array.value_data_type)
+            arrow_arrays << arrow_array
+          end
+          arrow_schema = Arrow::Schema.new(arrow_fields)
+          Arrow::Table.new(arrow_schema, arrow_arrays)
+        end
+
+        def prepare_raw_array(raw_array)
+          raw_array.collect do |element|
+            case element
+            when Array
+              prepare_raw_array(element)
+            when Hash
+              element.collect do |value, weight|
+                {
+                  "value" => value,
+                  "weight" => weight,
+                }
+              end
+            else
+              element
+            end
+          end
+        end
+
+        def build_arrow_array(data_type, raw_array)
+          arrow_list_field = Arrow::Field.new("item", data_type)
+          arrow_list_data_type = Arrow::ListDataType.new(arrow_list_field)
+          raw_array = prepare_raw_array(raw_array)
+          Arrow::ListArrayBuilder.build(arrow_list_data_type, raw_array)
+        end
+
+        def arrow_weight_vector_data_type(raw_value)
+          if raw_value.values.any? {|value| value.is_a?(Float)}
+            weight_type = :float
+          else
+            weight_type = :int32
+          end
+          Arrow::StructDataType.new("value" => :string,
+                                    "weight" => weight_type)
+        end
+
+        def detect_arrow_data_type(raw_array)
+          type = nil
+          raw_array.each do |element|
+            case element
+            when nil
+            when true, false
+              type ||= :boolean
+            when Integer
+              if element >= (2 ** 63)
+                type = nil if type == :int64
+                type ||= :uint64
+              else
+                type ||= :int64
+              end
+            when Float
+              type = nil if type == :int64
+              type ||= :double
+            when Hash
+              item_type = arrow_weight_vector_data_type(element)
+              arrow_list_field = Arrow::Field.new("item", item_type)
+              arrow_list_data_type = Arrow::ListDataType.new(arrow_list_field)
+              return arrow_list_data_type
+            else
+              return :string
+            end
+          end
+          type
+        end
+      end
     end
   end
 end

data/lib/groonga/command/reference-acquire.rb

@@ -0,0 +1,69 @@
+# Copyright (C) 2020  Sutou Kouhei <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 as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# 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
+
+require "groonga/command/base"
+
+module Groonga
+  module Command
+    # A command class that represents `reference_acquire` command.
+    #
+    # @since 1.4.9
+    class ReferenceAcquire < Base
+      class << self
+        def command_name
+          "reference_acquire"
+        end
+
+        def parameter_names
+          [
+            :target_name,
+            :recursive,
+          ]
+        end
+      end
+
+      Command.register(command_name, self)
+
+      # @return [String] `target_name` parameter value.
+      #
+      # @since 1.4.9
+      def target_name
+        self[:target_name]
+      end
+
+      # @return [String] `recursive` parameter value.
+      #
+      # @since 1.4.9
+      def recursive
+        self[:recursive]
+      end
+
+      # @return [Boolean] Whether `recursive` parameter value isn't `no`.
+      #
+      # @since 1.4.9
+      def recursive?
+        recursive != "no"
+      end
+
+      # @return [Boolean] `recursive` parameter value.
+      #
+      # @since 1.4.9
+      def recursive_dependent?
+        recursive == "dependent"
+      end
+    end
+  end
+end

data/lib/groonga/command/reference-release.rb

@@ -0,0 +1,69 @@
+# Copyright (C) 2020  Sutou Kouhei <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 as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# 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
+
+require "groonga/command/base"
+
+module Groonga
+  module Command
+    # A command class that represents `reference_release` command.
+    #
+    # @since 1.4.9
+    class ReferenceRelease < Base
+      class << self
+        def command_name
+          "reference_release"
+        end
+
+        def parameter_names
+          [
+            :target_name,
+            :recursive,
+          ]
+        end
+      end
+
+      Command.register(command_name, self)
+
+      # @return [String] `target_name` parameter value.
+      #
+      # @since 1.4.9
+      def target_name
+        self[:target_name]
+      end
+
+      # @return [String] `recursive` parameter value.
+      #
+      # @since 1.4.9
+      def recursive
+        self[:recursive]
+      end
+
+      # @return [Boolean] Whether `recursive` parameter value isn't `no`.
+      #
+      # @since 1.4.9
+      def recursive?
+        self[:recursive] != "no"
+      end
+
+      # @return [Boolean] `recursive` parameter value.
+      #
+      # @since 1.4.9
+      def recursive_dependent?
+        self[:recursive] == "dependent"
+      end
+    end
+  end
+end

data/lib/groonga/command/table-create.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2016  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -33,6 +33,7 @@ module Groonga
             :default_tokenizer,
             :normalizer,
             :token_filters,
+            :path,
           ]
         end
       end
@@ -117,6 +118,12 @@ module Groonga
       def token_filters
         @token_filters ||= array_value(:token_filters)
       end
+
+      # @return [String, nil] Path or nil
+      # @since 1.5.0
+      def path
+        self[:path]
+      end
     end
   end
 end

data/lib/groonga/command/version.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2019  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -16,6 +16,6 @@
 
 module Groonga
   module Command
-    VERSION = "1.4.5"
+    VERSION = "1.5.0"
   end
 end

data/test/command/test-column-create.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2016  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -28,14 +28,24 @@ class ColumnCreateCommandTest < Test::Unit::TestCase
       flags    = "COLUMN_INDEX"
       type     = "Posts"
       source   = "content"
-
-      command = column_create_command({}, [table, name, flags, type, source])
+      path     = "Lexicon.content_index"
+
+      command = column_create_command({},
+                                      [
+                                        table,
+                                        name,
+                                        flags,
+                                        type,
+                                        source,
+                                        path,
+                                      ])
       assert_equal({
                      :table    => table,
                      :name     => name,
                      :flags    => flags,
                      :type     => type,
                      :source   => source,
+                     :path     => path,
                    },
                    command.arguments)
     end
@@ -198,4 +208,16 @@ class ColumnCreateCommandTest < Test::Unit::TestCase
                    command.sources)
     end
   end
+
+  class PathTest < self
+    def test_specified
+      command = column_create_command({"path" => "Lexicon.content_index"})
+      assert_equal("Lexicon.content_index", command.path)
+    end
+
+    def test_omitted
+      command = column_create_command
+      assert_nil(command.path)
+    end
+  end
 end

data/test/command/test-io-flush.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2015  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2015-2020  Sutou Kouhei <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
@@ -53,6 +53,9 @@ class IOFlushCommandTest < Test::Unit::TestCase
         assert do
           command.recursive?
         end
+        assert do
+          not command.recursive_dependent?
+        end
       end
 
       def test_no
@@ -60,6 +63,19 @@ class IOFlushCommandTest < Test::Unit::TestCase
         assert do
           not command.recursive?
         end
+        assert do
+          not command.recursive_dependent?
+        end
+      end
+
+      def test_dependent
+        command = io_flush_command(:recursive => "dependent")
+        assert do
+          command.recursive?
+        end
+        assert do
+          command.recursive_dependent?
+        end
       end
     end
   end

data/test/command/test-load.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2017  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -116,4 +116,90 @@ class LoadCommandTest < Test::Unit::TestCase
       end
     end
   end
+
+  sub_test_case("#build_arrow_table") do
+    def setup
+      omit("red-arrow is needed") unless defined?(Arrow)
+    end
+
+    sub_test_case("Array") do
+      def test_without_columns_argument
+        command = load_command({"values" => [
+                                  ["column1", "column2"],
+                                  ["value1", "value2"],
+                                ].to_json})
+        assert_equal(Arrow::Table.new({
+                                        "column1" => ["value1"],
+                                        "column2" => ["value2"],
+                                      }),
+                     command.build_arrow_table)
+      end
+
+      def test_with_columns_argument
+        command = load_command({"columns" => ["column1", "column2"].join(", "),
+                                "values" => [
+                                  ["value1", "value2"],
+                                ].to_json})
+        assert_equal(Arrow::Table.new({
+                                        "column1" => ["value1"],
+                                        "column2" => ["value2"],
+                                      }),
+                     command.build_arrow_table)
+      end
+    end
+
+    sub_test_case("Hash") do
+      def test_integer
+        command = load_command({"values" => [
+                                  {
+                                    "column1" => 1,
+                                    "column2" => 2,
+                                  },
+                                  {
+                                    "column1" => 10,
+                                    "column2" => 20,
+                                  },
+                                ].to_json})
+        columns = {
+          "column1" => Arrow::Int64Array.new([1, 10]),
+          "column2" => Arrow::Int64Array.new([2, 20]),
+        }
+        assert_equal(Arrow::Table.new(columns),
+                     command.build_arrow_table)
+      end
+    end
+
+    sub_test_case("raw values") do
+      def test_without_columns_argument
+        columns = ["column1", "column2"]
+        command = load_command("columns" => columns.join(","))
+        command.original_source = "load\n" + [
+          columns,
+          ["value1", "value2"],
+          ["value10", "value20"],
+        ].to_json
+        columns = {
+          "column1" => ["value1", "value10"],
+          "column2" => ["value2", "value20"],
+        }
+        assert_equal(Arrow::Table.new(columns),
+                     command.build_arrow_table)
+      end
+
+      def test_with_columns_argument
+        columns = ["column1", "column2"]
+        command = load_command("columns" => columns.join(","))
+        command.original_source = "load --columns #{columns.join(",")}\n" + [
+          ["value1", "value2"],
+          ["value10", "value20"],
+        ].to_json
+        columns = {
+          "column1" => ["value1", "value10"],
+          "column2" => ["value2", "value20"],
+        }
+        assert_equal(Arrow::Table.new(columns),
+                     command.build_arrow_table)
+      end
+    end
+  end
 end

data/test/command/test-reference-acquire.rb

@@ -0,0 +1,82 @@
+# Copyright (C) 2020  Sutou Kouhei <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 as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# 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 ReferenceAcquireCommandTest < Test::Unit::TestCase
+  private
+  def reference_acquire_command(pair_arguments={}, ordered_arguments=[])
+    Groonga::Command::ReferenceAcquire.new(pair_arguments,
+                                           ordered_arguments)
+  end
+
+  class ConstructorTest < self
+    def test_ordered_arguments
+      target_name = "Users"
+      recursive = "no"
+
+      ordered_arguments = [
+        target_name,
+        recursive,
+      ]
+      command = reference_acquire_command({}, ordered_arguments)
+      assert_equal({
+                     :target_name => target_name,
+                     :recursive   => recursive,
+                   },
+                   command.arguments)
+    end
+  end
+
+  class TargetNameTest < self
+    def test_reader
+      command = reference_acquire_command(:target_name => "Users")
+      assert_equal("Users", command.target_name)
+    end
+  end
+
+  class RecursiveTest < self
+    class ReaderTest < self
+      def test_default
+        command = reference_acquire_command
+        assert do
+          command.recursive?
+        end
+        assert do
+          not command.recursive_dependent?
+        end
+      end
+
+      def test_no
+        command = reference_acquire_command(:recursive => "no")
+        assert do
+          not command.recursive?
+        end
+        assert do
+          not command.recursive_dependent?
+        end
+      end
+
+      def test_dependent
+        command = reference_acquire_command(:recursive => "dependent")
+        assert do
+          command.recursive?
+        end
+        assert do
+          command.recursive_dependent?
+        end
+      end
+    end
+  end
+end

data/test/command/test-reference-release.rb

@@ -0,0 +1,82 @@
+# Copyright (C) 2020  Sutou Kouhei <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 as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# 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 ReferenceReleaseCommandTest < Test::Unit::TestCase
+  private
+  def reference_release_command(pair_arguments={}, ordered_arguments=[])
+    Groonga::Command::ReferenceRelease.new(pair_arguments,
+                                           ordered_arguments)
+  end
+
+  class ConstructorTest < self
+    def test_ordered_arguments
+      target_name = "Users"
+      recursive = "no"
+
+      ordered_arguments = [
+        target_name,
+        recursive,
+      ]
+      command = reference_release_command({}, ordered_arguments)
+      assert_equal({
+                     :target_name => target_name,
+                     :recursive   => recursive,
+                   },
+                   command.arguments)
+    end
+  end
+
+  class TargetNameTest < self
+    def test_reader
+      command = reference_release_command(:target_name => "Users")
+      assert_equal("Users", command.target_name)
+    end
+  end
+
+  class RecursiveTest < self
+    class ReaderTest < self
+      def test_default
+        command = reference_release_command
+        assert do
+          command.recursive?
+        end
+        assert do
+          not command.recursive_dependent?
+        end
+      end
+
+      def test_no
+        command = reference_release_command(:recursive => "no")
+        assert do
+          not command.recursive?
+        end
+        assert do
+          not command.recursive_dependent?
+        end
+      end
+
+      def test_dependent
+        command = reference_release_command(:recursive => "dependent")
+        assert do
+          command.recursive?
+        end
+        assert do
+          command.recursive_dependent?
+        end
+      end
+    end
+  end
+end

data/test/command/test-table-create.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2012-2016  Kouhei Sutou <kou@clear-code.com>
+# Copyright (C) 2012-2020  Sutou Kouhei <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
@@ -30,6 +30,7 @@ class TableCreateCommandTest < Test::Unit::TestCase
       default_tokenizer = "TokenBigram"
       normalizer        = "NormalizerAuto"
       token_filters     = "TokenFilterStopWord|TokenFilterStem"
+      path              = "tables.users"
 
       ordered_arguments = [
         name,
@@ -39,6 +40,7 @@ class TableCreateCommandTest < Test::Unit::TestCase
         default_tokenizer,
         normalizer,
         token_filters,
+        path,
       ]
       command = table_create_command({}, ordered_arguments)
       assert_equal({
@@ -49,6 +51,7 @@ class TableCreateCommandTest < Test::Unit::TestCase
                      :default_tokenizer => default_tokenizer,
                      :normalizer        => normalizer,
                      :token_filters     => token_filters,
+                     :path              => path,
                    },
                    command.arguments)
     end
@@ -230,4 +233,16 @@ class TableCreateCommandTest < Test::Unit::TestCase
       assert_equal([], command.token_filters)
     end
   end
+
+  class PathTest < self
+    def test_specified
+      command = table_create_command({"path" => "tables.users"})
+      assert_equal("tables.users", command.path)
+    end
+
+    def test_omitted
+      command = table_create_command
+      assert_nil(command.path)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: groonga-command
 version: !ruby/object:Gem::Version
-  version: 1.4.5
+  version: 1.5.0
 platform: ruby
 authors:
 - Kouhei Sutou
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-02 00:00:00.000000000 Z
+date: 2020-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: test-unit
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -39,7 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: test-unit-notify
+  name: packnga
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: red-arrow
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: packnga
+  name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,7 +109,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: test-unit-notify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -176,6 +190,8 @@ files:
 - lib/groonga/command/query-log-flags-remove.rb
 - lib/groonga/command/query-log-flags-set.rb
 - lib/groonga/command/range-filter.rb
+- lib/groonga/command/reference-acquire.rb
+- lib/groonga/command/reference-release.rb
 - lib/groonga/command/register.rb
 - lib/groonga/command/reindex.rb
 - lib/groonga/command/request-cancel.rb
@@ -233,6 +249,8 @@ files:
 - test/command/test-query-log-flags-remove.rb
 - test/command/test-query-log-flags-set.rb
 - test/command/test-range-filter.rb
+- test/command/test-reference-acquire.rb
+- test/command/test-reference-release.rb
 - test/command/test-register.rb
 - test/command/test-reindex.rb
 - test/command/test-request-cancel.rb
@@ -273,66 +291,67 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.2.0.rc.1
 signing_key: 
 specification_version: 4
 summary: Groonga-command is a library that represents [Groonga](http://groonga.org/)'s
   command. You can write a program that handle Groonga's command by using groonga-command.
 test_files:
-- test/run-test.rb
-- test/command/test-range-filter.rb
+- test/command/format/test-command.rb
+- test/command/test-base.rb
+- test/command/test-column-copy.rb
+- test/command/test-column-create.rb
+- test/command/test-column-list.rb
+- test/command/test-column-remove.rb
 - test/command/test-column-rename.rb
-- test/command/test-object-exist.rb
+- test/command/test-config-delete.rb
 - test/command/test-config-get.rb
-- test/command/test-table-create.rb
-- test/command/test-plugin-register.rb
-- test/command/test-query-log-flags-remove.rb
-- test/command/format/test-command.rb
-- test/command/test-table-rename.rb
-- test/command/test-truncate.rb
+- test/command/test-config-set.rb
+- test/command/test-delete.rb
+- test/command/test-dump.rb
+- test/command/test-get.rb
+- test/command/test-index-column-diff.rb
+- test/command/test-io-flush.rb
+- test/command/test-load.rb
+- test/command/test-log-level.rb
 - test/command/test-log-put.rb
-- test/command/test-query-log-flags-get.rb
-- test/command/test-query-log-flags-set.rb
+- test/command/test-logical-count.rb
 - test/command/test-logical-range-filter.rb
-- test/command/test-column-list.rb
-- test/command/test-ruby-load.rb
-- test/command/test-query-log-flags-add.rb
-- test/command/test-table-copy.rb
-- test/command/test-config-delete.rb
 - test/command/test-logical-select.rb
-- test/command/test-tokenize.rb
-- test/command/test-table-tokenize.rb
-- test/command/test-request-cancel.rb
-- test/command/test-column-copy.rb
-- test/command/test-suggest.rb
-- test/command/test-column-remove.rb
-- test/command/test-object-remove.rb
 - test/command/test-logical-shard-list.rb
-- test/command/test-column-create.rb
-- test/command/test-get.rb
-- test/command/test-load.rb
-- test/command/test-reindex.rb
-- test/command/test-plugin-unregister.rb
-- test/command/test-io-flush.rb
 - test/command/test-logical-table-remove.rb
-- test/command/test-index-column-diff.rb
-- test/command/test-register.rb
+- test/command/test-normalize.rb
+- test/command/test-object-exist.rb
 - test/command/test-object-inspect.rb
-- test/command/test-delete.rb
+- test/command/test-object-remove.rb
+- test/command/test-plugin-register.rb
+- test/command/test-plugin-unregister.rb
 - test/command/test-query-expand.rb
-- test/command/test-table-list.rb
-- test/command/test-status.rb
-- test/command/test-thread-limit.rb
-- test/command/test-config-set.rb
-- test/command/test-log-level.rb
-- test/command/test-shutdown.rb
+- test/command/test-query-log-flags-add.rb
+- test/command/test-query-log-flags-get.rb
+- test/command/test-query-log-flags-remove.rb
+- test/command/test-query-log-flags-set.rb
+- test/command/test-range-filter.rb
+- test/command/test-reference-acquire.rb
+- test/command/test-reference-release.rb
+- test/command/test-register.rb
+- test/command/test-reindex.rb
+- test/command/test-request-cancel.rb
 - test/command/test-ruby-eval.rb
+- test/command/test-ruby-load.rb
 - test/command/test-schema.rb
-- test/command/test-normalize.rb
-- test/command/test-dump.rb
-- test/command/test-base.rb
-- test/command/test-logical-count.rb
-- test/command/test-table-remove.rb
 - test/command/test-select.rb
+- test/command/test-shutdown.rb
+- test/command/test-status.rb
+- test/command/test-suggest.rb
+- test/command/test-table-copy.rb
+- test/command/test-table-create.rb
+- test/command/test-table-list.rb
+- test/command/test-table-remove.rb
+- test/command/test-table-rename.rb
+- test/command/test-table-tokenize.rb
+- test/command/test-thread-limit.rb
+- test/command/test-tokenize.rb
+- test/command/test-truncate.rb
 - test/groonga-command-test-utils.rb
+- test/run-test.rb