grn_mini 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in grn_mini.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 ongaeshi
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,368 @@
+# GrnMini
+
+Groonga(Rroonga) wrapper for using easily. It is the KVS so easy to use.
+
+## Installation
+
+    $ gem install grn_mini
+
+## Basic Usage
+
+### Create a database with the name "test.db".
+
+```ruby
+require 'grn_mini'
+array = GrnMini::Array.new("test.db")
+```
+
+### Add the record with the number column and text column.
+
+Determine the column type when you first call "GrnMini::Array#add". (Add inverted index if data type is "string".)
+
+```ruby
+array.add(text: "aaa", number: 1)
+```
+
+### It is also possible to use the '<<'
+
+```ruby
+array << {text: "bbb", number: 2}
+array << {text: "ccc", number: 3}
+array.size  #=> 3
+```
+
+### Create a temporary database. (Useful for testing)
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text: "aaa", number: 1}
+  array << {text: "bbb", number: 2}
+  array << {text: "ccc", number: 3}
+end
+# Delete temporary database
+```
+
+## Data Type
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {filename: "a.txt", int: 1, float: 1.5, time: Time.at(1999)}
+  array << {filename: "b.doc", int: 2, float: 2.5, time: Time.at(2000)}
+
+  # ShortText
+  array[1].filename #=> "a.txt"
+  array[2].filename #=> "b.doc"
+
+  # Int32
+  array[1].int      #=> 1
+  array[2].int      #=> 2
+
+  # Float
+  array[1].float    #=> 1.5
+  array[2].float    #=> 2.5
+
+  # Time
+  array[1].time    #=> 1999-01-01
+  array[2].time    #=> 2000-01-01
+end
+```
+
+See also [8.4. Data type — Groonga documentation](http://groonga.org/docs/reference/types.html).
+
+## Access Record
+
+### Add
+
+```ruby
+require 'grn_mini'
+
+array = GrnMini::Array.new("test2.db")
+array << {name:"Tanaka",  age: 11, height: 162.5}
+array << {name:"Suzuki",  age: 31, height: 170.0}
+```
+
+### Read
+
+```ruby
+record = array[1] # Read from id (> 0)
+record.id         #=> 1
+```
+
+Access function with the same name as the column name
+
+```ruby
+record.name     #=> "Tanaka
+record.age      #=> 11
+record.height   #=> 162.5
+```
+
+Groonga::Record#attributes is useful for debug
+
+```ruby
+record.attributes #=> {"_id"=>1, "age"=>11, "height"=>162.5, "name"=>"Tanaka"}
+```
+
+### Update
+
+```ruby
+array[2].name = "Hayashi"
+array[2].attributes #=> {"_id"=>2, "age"=>31, "height"=>170.0, "name"=>"Hayashi"}
+```
+
+### Delete
+
+Delete by passing id.
+
+```ruby
+array.delete(1)
+
+# It returns 'nil' value when you access a deleted record
+array[1].attributes     #=> {"_id"=>1, "age"=>0, "height"=>0.0, "name"=>nil}
+
+# Can't see deleted records if access from Enumerable
+array.first.id          #=> 2
+array.first.attributes  #=> {"_id"=>2, "age"=>31, "height"=>170.0, "name"=>"Hayashi"}
+```
+
+It is also possible to pass the block.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {name:"Tanaka",  age: 11, height: 162.5}
+  array << {name:"Suzuki",  age: 31, height: 170.0}
+  array << {name:"Hayashi", age: 20, height: 165.0}
+
+  array.delete do |record|
+    record.age <= 20
+  end
+
+  array.size             #=> 1
+  array.first.attributes #=> {"_id"=>2, "age"=>31, "height"=>170.0, "name"=>"Suzuki"}
+end
+```
+
+## Search
+
+Use GrnMini::Array#select method.
+`:text` column is set to the `:default_column` implicitly.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text:"aaa", number:1}
+  array << {text:"bbb", number:20}
+  array << {text:"bbb ccc", number:2}
+  array << {text:"bbb", number:15}
+  array << {text:"ccc", number:3}
+
+  results = array.select("aaa")
+  results.map {|record| record.attributes} #=> [{"_id"=>1, "_key"=>{"_id"=>1, "number"=>1, "text"=>"aaa"}, "_score"=>1}]
+
+  # AND
+  results = array.select("bbb ccc")
+  results.map {|record| record.attributes} #=> [{"_id"=>2, "_key"=>{"_id"=>3, "number"=>2, "text"=>"bbb ccc"}, "_score"=>2}]
+
+  # Specify column
+  results = array.select("bbb number:<10")
+  results.map {|record| record.attributes} #=> [{"_id"=>2, "_key"=>{"_id"=>3, "number"=>2, "text"=>"bbb ccc"}, "_score"=>2}]
+
+  # AND, OR, Grouping
+  results = array.select("bbb (number:<= 10 OR number:>=20)")
+  results.map {|record| record.attributes} #=> [{"_id"=>2, "_key"=>{"_id"=>3, "number"=>2, "text"=>"bbb ccc"}, "_score"=>2}, {"_id"=>4, "_key"=>{"_id"=>2, "number"=>20, "text"=>"bbb"}, "_score"=>2}]
+
+  # NOT
+  results = array.select("bbb - ccc")
+  results.map {|record| record.attributes}  #=> [{"_id"=>1, "_key"=>{"_id"=>2, "number"=>20, "text"=>"bbb"}, "_score"=>1}, {"_id"=>3, "_key"=>{"_id"=>4, "number"=>15, "text"=>"bbb"}, "_score"=>1}]
+end 
+```
+
+Change `:default_column` to `:filename` column.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text: "txt", filename:"a.txt"}
+  array << {text: "txt", filename:"a.doc"}
+  array << {text: "txt", filename:"a.rb"}
+
+  # Specify column
+  results = array.select("filename:@txt")
+  results.first.attributes  #=> {"_id"=>1, "_key"=>{"_id"=>1, "filename"=>"a.txt", "text"=>"txt"}, "_score"=>1}
+
+  # Change default_column
+  results = array.select("txt", default_column: "filename")
+  results.first.attributes  #=> {"_id"=>1, "_key"=>{"_id"=>1, "filename"=>"a.txt", "text"=>"txt"}, "_score"=>1}
+end
+```
+
+See also [8.10.1. Query syntax](http://groonga.org/docs/reference/grn_expr/query_syntax.html), [Groonga::Table#select](http://ranguba.org/rroonga/en/Groonga/Table.html#select-instance_method)
+
+## Sort
+
+Specify column name to sort.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {name:"Tanaka",  age: 11, height: 162.5}
+  array << {name:"Suzuki",  age: 31, height: 170.0}
+  array << {name:"Hayashi", age: 21, height: 175.4}
+  array << {name:"Suzuki",  age:  5, height: 110.0}
+
+  sorted = array.sort(["age"])
+
+  sorted.map {|r| {name: r.name, age: r.age}}
+    #=> [{:name=>"Suzuki",  :age=> 5},
+    #    {:name=>"Tanaka",  :age=>11},
+    #    {:name=>"Hayashi", :age=>21},
+    #    {:name=>"Suzuki",  :age=>31}]
+end
+```
+
+Combination sort.
+
+```ruby
+sorted = array.sort([{key: "name", order: :ascending},
+                     {key: "age" , order: :descending}])
+
+sorted.map {|r| {name: r.name, age: r.age}}
+    #=> [{:name=>"Hayashi", :age=>21},
+    #    {:name=>"Suzuki",  :age=>31},
+    #    {:name=>"Suzuki",  :age=> 5},
+    #    {:name=>"Tanaka",  :age=>11}]
+```
+
+## Grouping
+
+Drill down aka.
+
+```ruby
+GrnMini::Array.tmpdb do |array| 
+  array << {text:"aaaa.txt", suffix:"txt", type:1}
+  array << {text:"aaaa.doc", suffix:"doc", type:2}
+  array << {text:"aabb.txt", suffix:"txt", type:2}
+
+  groups = GrnMini::Util::group_with_sort(array, "suffix")
+
+  groups.size                               #=> 2
+  [groups[0].key, groups[0].n_sub_records]  #=> ["txt", 2]
+  [groups[1].key, groups[1].n_sub_records]  #=> ["doc", 1]
+end
+```
+
+Grouping from selection results.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text:"aaaa", suffix:"txt"}
+  array << {text:"aaaa", suffix:"doc"}
+  array << {text:"aaaa", suffix:"txt"}
+  array << {text:"cccc", suffix:"txt"}
+
+  results = array.select("aa")
+  groups = GrnMini::Util::group_with_sort(results, "suffix")
+
+  groups.size                               #=> 2
+  [groups[0].key, groups[0].n_sub_records]  #=> ["txt", 2]
+  [groups[1].key, groups[1].n_sub_records]  #=> ["doc", 1]
+end
+```
+
+## Snippet
+
+Display of keyword surrounding text. It is often used in search engine.
+Use `GrnMini::Util::text_snippet_from_selection_results`.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text: <<EOF, filename: "aaa.txt"}
+[1] This is a pen pep pea pek pet.
+------------------------------
+------------------------------
+------------------------------
+------------------------------
+[2] This is a pen pep pea pek pet.
+------------------------------
+------------------------------
+------------------------------
+------------------------------
+EOF
+
+  results = array.select("This pen")
+  snippet = GrnMini::Util::text_snippet_from_selection_results(results)
+
+  record = results.first
+  segments = snippet.execute(record.text)
+  segments.size #=> 2
+  segments[0]   #=> "[1] <<This>> is a <<pen>> pep pea pek pet.\n------------------------------\n------------------------------\n---"
+  segments[1]   #=> "--------\n------------------------------\n[2] <<This>> is a <<pen>> pep pea pek pet.\n-------------------------"
+end
+```
+
+`GrnMini::Util::html_snippet_from_selection_results` is HTML escaped.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text: <<EOF, filename: "aaa.txt"}
+<html>
+  <div>This is a pen pep pea pek pet.</div>
+</html>
+EOF
+
+  results = array.select("This pen")
+  snippet = GrnMini::Util::html_snippet_from_selection_results(results, '<span class="strong">', '</span>') # Default value is '<strong>', '</strong>'
+
+  record = results.first
+  segments = snippet.execute(record.text)
+  segments.size   #=> 1
+  segments.first  #=> "&lt;html&gt;\n  &lt;div&gt;<span class=\"strong\">This</span> is a <span class=\"strong\">pen</span> pep pea pek pet.&lt;/div&gt;\n&lt;/html&gt;\n"
+end
+```
+
+See also [Groonga::Expression#snippet](http://ranguba.org/rroonga/en/Groonga/Expression.html#snippet-instance_method)
+
+## Pagination
+
+ #paginate is more convenient than #sort if you want a pagination.
+
+```ruby
+GrnMini::Array.tmpdb do |array|
+  array << {text: "aaaa", filename: "1.txt"}
+  array << {text: "aaaa aaaa", filename: "2a.txt"}
+  array << {text: "aaaa aaaa aaaa", filename: "3.txt"}
+  array << {text: "aaaa aaaa", filename: "2b.txt"}
+  array << {text: "aaaa aaaa", filename: "2c.txt"}
+  array << {text: "aaaa aaaa", filename: "2d.txt"}
+  array << {text: "aaaa aaaa", filename: "2e.txt"}
+  array << {text: "aaaa aaaa", filename: "2f.txt"}
+
+  results = array.select("aaaa")
+
+  # -- page1 --
+  page_entries = results.paginate([["_score", :desc]], :page => 1, :size => 5)
+
+  # Total number of record
+  page_entries.n_records    #=> 8
+
+  # Page offset
+  page_entries.start_offset #=> 1
+  page_entries.end_offset   #=> 5
+
+  # Page entries
+  page_entries.size         #=> 5
+
+  # -- page2 --
+  page_entries = results.paginate([["_score", :desc]], :page => 2, :size => 5)
+
+  # Sample page content display
+  puts "#{page_entries.n_records} hit. (#{page_entries.start_offset} - #{page_entries.end_offset})"
+  page_entries.each do |record|
+    puts "#{record.filename}: #{record.text}"
+  end
+
+  #=> 8 hit. (6 - 8)
+  #   2b.txt: aaaa aaaa
+  #   2f.txt: aaaa aaaa
+  #   1.txt: aaaa
+end
+```
+
+See also [Groonga::Table#pagenate](http://ranguba.org/rroonga/en/Groonga/Table.html#paginate-instance_method)
+

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+end
+
+task :default => :test

data/grn_mini.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'grn_mini/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "grn_mini"
+  spec.version       = GrnMini::VERSION
+  spec.authors       = ["ongaeshi"]
+  spec.email         = ["ongaeshi0621@gmail.com"]
+  spec.description   = %q{Groonga(Rroonga) wrapper for using easily.}
+  spec.summary       = %q{It is the KVS it's so easy to use.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+
+  spec.add_dependency "rroonga"
+end

data/lib/grn_mini.rb

@@ -0,0 +1,7 @@
+require "grn_mini/version"
+require "grn_mini/array"
+require "grn_mini/util"
+
+module GrnMini
+  # Your code goes here...
+end

data/lib/grn_mini/array.rb

@@ -0,0 +1,101 @@
+require 'grn_mini/util'
+require 'groonga'
+require 'tmpdir'
+
+module GrnMini
+  class Array
+    attr_accessor :grn
+    include Enumerable
+
+    def self.tmpdb
+      Dir.mktmpdir do |dir|
+        # p dir
+        yield self.new(File.join(dir, "tmp.db"))
+      end
+    end
+
+    def initialize(path)
+      unless File.exist?(path)
+        Groonga::Database.create(path: path)
+      else
+        Groonga::Database.open(path)
+      end
+
+      unless Groonga["Array"]
+        @grn = Groonga::Array.create(name: "Array", persistent: true) 
+        @terms = Groonga::PatriciaTrie.create(name: "Terms", key_normalize: true, default_tokenizer: "TokenBigramSplitSymbolAlphaDigit")
+      else
+        @grn = Groonga["Array"]
+        @terms = Groonga["Terms"]
+      end
+    end
+
+    def add(hash)
+      if @grn.empty?
+        hash.each do |key, value|
+          column = key.to_s
+
+          # @todo Need define_index_column ?
+          if value.is_a?(Time)
+            @grn.define_column(column, "Time")
+          elsif value.is_a?(Float)
+            @grn.define_column(column, "Float")
+          elsif value.is_a?(Numeric)
+            @grn.define_column(column, "Int32")
+          else
+            @grn.define_column(column, "ShortText")
+            @terms.define_index_column("array_#{column}", @grn, source: "Array.#{column}", with_position: true)
+          end
+        end
+      end
+      
+      @grn.add(hash)
+    end
+
+    alias << add
+
+    def select(query, options = {default_column: "text"})
+      @grn.select(query, options)
+    end
+
+    def size
+      @grn.size
+    end
+
+    alias length size
+
+    def empty?
+      size == 0
+    end
+
+    def each
+      @grn.each do |record|
+        yield record
+      end
+    end
+
+    class IdIsGreaterThanZero < RuntimeError; end
+
+    def [](id)
+      raise IdIsGreaterThanZero if id == 0
+      @grn[id]
+    end
+    
+    def delete(id = nil, &block)
+      if block_given?
+        @grn.delete(&block)
+      else
+        raise IdIsGreaterThanZero if id == 0
+        @grn.delete(id)
+      end
+    end
+
+    def sort(keys, options = {})
+      @grn.sort(keys, options)
+    end
+
+    def group(key, options = {})
+      @grn.group(key, options)
+    end
+  end
+end

data/lib/grn_mini/util.rb

@@ -0,0 +1,19 @@
+require 'groonga'
+
+module GrnMini
+  module Util
+    module_function
+
+    def group_with_sort(table, column)
+      table.group(column).sort_by {|record| record.n_sub_records }.reverse
+    end
+
+    def text_snippet_from_selection_results(table, open_tag = '<<', close_tag = ">>")
+      table.expression.snippet([[open_tag, close_tag]])
+    end
+
+    def html_snippet_from_selection_results(table, open_tag = '<strong>', close_tag = "</strong>")
+      table.expression.snippet([[open_tag, close_tag]], {html_escape: true})
+    end
+  end
+end

data/lib/grn_mini/version.rb

@@ -0,0 +1,3 @@
+module GrnMini
+  VERSION = "0.1.0"
+end

data/test/minitest_helper.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'grn_mini'
+
+require 'minitest/autorun'

data/test/test_grn_mini.rb

@@ -0,0 +1,7 @@
+require 'minitest_helper'
+
+class TestGrnMini < MiniTest::Unit::TestCase
+  def test_that_it_has_a_version_number
+    refute_nil ::GrnMini::VERSION
+  end
+end

data/test/test_grn_mini_array.rb

@@ -0,0 +1,377 @@
+require 'minitest_helper'
+
+class TestGrnMiniArray < MiniTest::Unit::TestCase
+  def test_initialize
+    Dir.mktmpdir do |dir|
+      array = GrnMini::Array.new(File.join(dir, "test.db"))
+    end
+  end
+
+  def test_add
+    GrnMini::Array.tmpdb do |array|
+      array.add(text:"aaa", number:1)
+      assert_equal 1, array.size
+
+      # alias << add
+      array << {text:"bbb", number:2}
+      assert_equal 2, array.size
+    end 
+  end
+
+  def test_select
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      array << {text:"ccc", number:3}
+
+      results = array.select("bb")
+
+      assert_equal 1, results.size
+      assert_equal "bbb", results.first.text
+    end 
+  end
+
+  def test_select2
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      array << {text:"bbb", number:20}
+      array << {text:"ccc", number:3}
+
+      results = array.select("bb number:<10")
+
+      assert_equal 1, results.size
+      assert_equal "bbb", results.first.text
+      assert_equal 2, results.first.number
+    end 
+  end
+
+  def test_size
+    GrnMini::Array.tmpdb do |array|
+      assert_equal 0, array.size
+      assert_equal 0, array.length
+      
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      assert_equal 2, array.size
+      assert_equal 2, array.length
+    end
+  end
+
+  def test_empty?
+    GrnMini::Array.tmpdb do |array|
+      assert_equal true, array.empty?
+
+      array << {text:"aaa", number:1}
+      assert_equal false, array.empty?
+    end
+  end
+
+  def test_each
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      array << {text:"ccc", number:3}
+
+      array.each_with_index do |v, index|
+        case index
+        when 0
+          assert_equal "aaa", v.text
+          assert_equal 1, v.number
+        when 1
+          assert_equal "bbb", v.text
+          assert_equal 2, v.number
+        when 2
+          assert_equal "ccc", v.text
+          assert_equal 3, v.number
+        end
+      end
+    end
+  end
+
+  def test_read_by_id
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      array << {text:"ccc", number:3}
+
+      # id > 0
+      assert_raises(GrnMini::Array::IdIsGreaterThanZero) { array[0] }
+
+      record = array[1]
+      assert_equal 1, record.id
+
+      assert_equal "aaa", array[1].text
+      assert_equal "bbb", array[2].text
+      assert_equal "ccc", array[3].text
+
+      assert_equal nil, array[4].text
+    end
+  end
+
+  def test_write_by_id
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      array << {text:"ccc", number:3}
+
+      assert_equal "bbb", array[2].text
+      assert_equal 2, array[2].number
+
+      array[2].text   = "BBB"
+      array[2].number = 22
+
+      assert_equal "BBB", array[2].text
+      assert_equal 22, array[2].number
+    end
+  end
+
+  def test_delete_by_id
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaa", number:1}
+      array << {text:"bbb", number:2}
+      array << {text:"ccc", number:3}
+
+      assert_equal 3, array.size
+
+      array.delete(2)
+
+      assert_equal 2, array.size
+
+      # Deleted elements are not stuffed between
+      assert_equal nil, array[2].text
+      assert_equal 0, array[2].number
+
+      # Can be accessed properly if use GrnMini::Array#each
+      array.each_with_index do |v, index|
+        case index
+        when 0
+          assert_equal "aaa", v.text
+          assert_equal 1, v.number
+        when 1
+          assert_equal "ccc", v.text
+          assert_equal 3, v.number
+        end
+        # p v.attributes
+      end
+
+      # New member id is '4'
+      array << {text:"ddd", number:1}
+      assert_equal "ddd", array[4].text
+    end
+  end
+
+  def test_delete_by_block
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"bbb", number:2}
+      array << {text:"ccc", number:3}
+      array << {text:"aaa", number:1}
+
+      array.delete do |record|
+        record.number >= 2
+      end
+
+      assert_equal 1, array.size
+      assert_equal "aaa", array.first.text
+      assert_equal 1, array.first.number
+    end
+  end
+
+  def test_float_column
+    GrnMini::Array.tmpdb do |array| 
+      array << {text:"aaaa", float: 1.5}
+      array << {text:"bbbb", float: 2.5}
+      array << {text:"cccc", float: 3.5}
+
+      assert_equal 2.5, array[2].float
+
+      results = array.select("float:>2.6")
+      assert_equal 3.5, results.first.float
+    end
+  end
+
+  def test_time_column
+    GrnMini::Array.tmpdb do |array| 
+      array << {text:"aaaa", timestamp: Time.new(2013)} # 2013-01-01
+      array << {text:"bbbb", timestamp: Time.new(2014)} # 2014-01-01
+      array << {text:"cccc", timestamp: Time.new(2015)} # 2015-01-01
+
+      assert_equal Time.new(2014), array[2].timestamp
+
+      results = array.select("timestamp:<=#{Time.new(2013,12).to_i}")
+      assert_equal 1, results.size
+      assert_equal Time.new(2013), results.first.timestamp
+    end    
+  end
+
+  def test_record_attributes
+    GrnMini::Array.tmpdb do |array| 
+      array << {text:"aaaa", int: 1}
+      array << {text:"bbbb", int: 2}
+      array << {text:"cccc", int: 3}
+
+      assert_equal({"_id"=>1, "int"=>1, "text"=>"aaaa"}, array[1].attributes)
+      assert_equal({"_id"=>2, "int"=>2, "text"=>"bbbb"}, array[2].attributes)
+      assert_equal({"_id"=>3, "int"=>3, "text"=>"cccc"}, array[3].attributes)
+    end
+  end
+
+  def test_assign_long_text_to_short_text
+    GrnMini::Array.tmpdb do |array| 
+      array << {filename:"a.txt"}
+      array << {filename:"a"*4095 + ".txt" } # Over 4095 byte (ShortText limit)
+
+      results = array.select("txt", default_column: "filename")
+      assert_equal 2, results.size 
+    end
+  end
+
+  def test_grn_object
+    GrnMini::Array.tmpdb do |array| 
+      array << {text: "aaaa", filename:"a.txt", int: 1, float: 1.5, time: Time.at(2001)}
+
+      raw = array.grn
+
+      assert_equal true, raw.have_column?("filename")
+      assert_equal true, raw.have_column?("int")
+      assert_equal true, raw.have_column?("float")
+      assert_equal true, raw.have_column?("time")
+      assert_equal false, raw.have_column?("timeee")
+
+      assert_equal "ShortText", raw.column("text").range.name
+      assert_equal "ShortText", raw.column("filename").range.name
+      assert_equal "Int32"    , raw.column("int").range.name
+      assert_equal "Float"    , raw.column("float").range.name
+      assert_equal "Time"     , raw.column("time").range.name
+
+      assert_equal false, raw.support_key?
+      assert_equal false, raw.support_sub_records?
+    end
+  end
+
+  def test_sort
+    GrnMini::Array.tmpdb do |array| 
+      array << {name:"Tanaka",  age: 11, height: 162.5}
+      array << {name:"Suzuki",  age: 31, height: 170.0}
+      array << {name:"Hayashi", age: 21, height: 175.4}
+      array << {name:"Suzuki",  age:  5, height: 110.0}
+
+      sorted_by_age = array.sort(["age"])
+      sorted_array = sorted_by_age.map {|r| {name: r.name, age: r.age}}
+      assert_equal [{:name=>"Suzuki", :age=>5},
+                    {:name=>"Tanaka", :age=>11},
+                    {:name=>"Hayashi", :age=>21},
+                    {:name=>"Suzuki", :age=>31}], sorted_array
+
+      sorted_by_combination = array.sort([{key: "name", order: :ascending},
+                                          {key: "age" , order: :descending}])
+      sorted_array = sorted_by_combination.map {|r| {name: r.name, age: r.age}}
+      assert_equal [{:name=>"Hayashi", :age=>21},
+                    {:name=>"Suzuki", :age=>31},
+                    {:name=>"Suzuki", :age=>5},
+                    {:name=>"Tanaka", :age=>11}], sorted_array
+    end
+  end
+
+  def test_group_from_array
+    GrnMini::Array.tmpdb do |array| 
+      array << {text:"aaaa.txt", suffix:"txt", type:1}
+      array << {text:"aaaa.doc", suffix:"doc", type:2}
+      array << {text:"aabb.txt", suffix:"txt", type:2}
+
+      groups = GrnMini::Util::group_with_sort(array, "suffix")
+
+      assert_equal 2, groups.size
+      assert_equal ["txt", 2], [groups[0].key, groups[0].n_sub_records]
+      assert_equal ["doc", 1], [groups[1].key, groups[1].n_sub_records]
+    end
+  end
+
+  def test_group_from_selection_results
+    GrnMini::Array.tmpdb do |array|
+      array << {text:"aaaa", suffix:"txt"}
+      array << {text:"aaaa", suffix:"doc"}
+      array << {text:"aaaa", suffix:"txt"}
+      array << {text:"cccc", suffix:"txt"}
+
+      results = array.select("aa")
+      groups = GrnMini::Util::group_with_sort(results, "suffix")
+
+      assert_equal 2, groups.size
+      assert_equal ["txt", 2], [groups[0].key, groups[0].n_sub_records]
+      assert_equal ["doc", 1], [groups[1].key, groups[1].n_sub_records]
+    end
+  end
+
+  def test_text_snippet_from_selection_results
+    GrnMini::Array.tmpdb do |array|
+      array << {text: <<EOF, filename: "aaa.txt"}
+[1] This is a pen pep pea pek pet.
+------------------------------
+------------------------------
+------------------------------
+------------------------------
+[2] This is a pen pep pea pek pet.
+------------------------------
+------------------------------
+------------------------------
+------------------------------
+------------------------------
+EOF
+
+      results = array.select("This pen")
+      snippet = GrnMini::Util::text_snippet_from_selection_results(results)
+
+      record = results.first
+      segments = snippet.execute(record.text)
+      assert_equal 2, segments.size 
+      assert_match /\[1\] <<This>> is a <<pen>> pep pea pek pet./, segments[0]
+      assert_match /\[2\] <<This>> is a <<pen>> pep pea pek pet./, segments[1]
+    end
+  end
+
+  def test_html_snippet_from_selection_results
+    GrnMini::Array.tmpdb do |array|
+      array << {text: <<EOF, filename: "aaa.txt"}
+<html>
+  <div>This is a pen pep pea pek pet.</div>
+</html>
+EOF
+
+      results = array.select("This pen")
+      snippet = GrnMini::Util::html_snippet_from_selection_results(results)
+
+      record = results.first
+      segments = snippet.execute(record.text)
+      assert_equal 1, segments.size
+      assert_equal "&lt;html&gt;\n  &lt;div&gt;<strong>This</strong> is a <strong>pen</strong> pep pea pek pet.&lt;/div&gt;\n&lt;/html&gt;\n", segments.first
+    end
+  end
+
+  def test_paginate
+    GrnMini::Array.tmpdb do |array|
+      array << {text: "aaaa", filename: "1.txt"}
+      array << {text: "aaaa aaaa", filename: "2a.txt"}
+      array << {text: "aaaa aaaa aaaa", filename: "3.txt"}
+      array << {text: "aaaa aaaa", filename: "2b.txt"}
+      array << {text: "aaaa aaaa", filename: "2c.txt"}
+      array << {text: "aaaa aaaa", filename: "2d.txt"}
+
+      results = array.select("aaaa")
+
+      # page1
+      page_entries = results.paginate([["_score", :desc]], :page => 1, :size => 5)
+      assert_equal 6, page_entries.n_records
+      assert_equal 1, page_entries.start_offset
+      assert_equal 5, page_entries.end_offset
+      assert_equal "3.txt", page_entries.first.filename
+
+      # page2
+      page_entries = results.paginate([["_score", :desc]], :page => 2, :size => 5)
+      assert_equal 6, page_entries.n_records
+      assert_equal 6, page_entries.start_offset
+      assert_equal 6, page_entries.end_offset
+      assert_equal "1.txt", page_entries.first.filename
+    end
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: grn_mini
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- ongaeshi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-05 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2156695780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: *2156695780
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2156695360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2156695360
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &2156694900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2156694900
+- !ruby/object:Gem::Dependency
+  name: rroonga
+  requirement: &2156694480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156694480
+description: Groonga(Rroonga) wrapper for using easily.
+email:
+- ongaeshi0621@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- grn_mini.gemspec
+- lib/grn_mini.rb
+- lib/grn_mini/array.rb
+- lib/grn_mini/util.rb
+- lib/grn_mini/version.rb
+- test/minitest_helper.rb
+- test/test_grn_mini.rb
+- test/test_grn_mini_array.rb
+homepage: ''
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: It is the KVS it's so easy to use.
+test_files:
+- test/minitest_helper.rb
+- test/test_grn_mini.rb
+- test/test_grn_mini_array.rb