rroonga 0.9.4-x86-mingw32 → 0.9.5-x86-mingw32

data/lib/groonga/pagination.rb

@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2010  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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+module Groonga
+  class TooSmallPage < Error
+    attr_reader :page, :available_pages
+    def initialize(page, available_pages)
+      @page = page
+      @available_pages = available_pages
+      super("too small page: #{@page}: " +
+            "available pages: #{@available_pages.inspect}")
+    end
+  end
+
+  class TooLargePage < Error
+    attr_reader :page, :available_pages
+    def initialize(page, available_pages)
+      @page = page
+      @available_pages = available_pages
+      super("too large page: #{@page}: " +
+            "available pages: #{@available_pages.inspect}")
+    end
+  end
+
+  class TooSmallPageSize < Error
+    attr_reader :page_size, :available_page_sizes
+    def initialize(page_size, available_page_sizes)
+      @page_size = page_size
+      @available_page_sizes = available_page_sizes
+      super("too small page size: #{@page_size}: " +
+            "available page sizes: #{@available_page_sizes.inspect}")
+    end
+  end
+
+  class Table
+    def paginate(sort_keys, options={})
+      _size = size
+      page_size = options[:size] || 10
+      minimum_size = [1, _size].min
+      if page_size < 1
+        raise TooSmallPageSize.new(page_size, minimum_size.._size)
+      end
+
+      max_page = [(_size / page_size.to_f).ceil, 1].max
+      page = options[:page] || 1
+      if page < 1
+        raise TooSmallPage.new(page, 1..max_page)
+      elsif max_page < page
+        raise TooLargePage.new(page, 1..max_page)
+      end
+
+      offset = (page - 1) * page_size
+      limit = page_size
+      records = sort(sort_keys, :offset => offset, :limit => limit)
+      records.extend(Pagination)
+      records.send(:set_pagination_info, page, page_size, _size)
+      records
+    end
+  end
+
+  # ページネーション機能を追加するモジュール。
+  #
+  # ページ番号など、0ベースではなく1ベースです。
+  module Pagination
+    attr_reader :current_page, :page_size, :n_pages, :n_records
+
+    def have_pages?
+      @n_pages > 1
+    end
+
+    def first_page
+      1
+    end
+
+    def first_page?
+      @current_page == first_page
+    end
+
+    def last_page
+      @n_pages
+    end
+
+    def last_page?
+      @current_page == last_page
+    end
+
+    def have_next_page?
+      @current_page < @n_pages
+    end
+
+    def next_page
+      have_next_page? ? @current_page + 1 : nil
+    end
+
+    def have_previous_page?
+      @current_page > 1
+    end
+
+    def previous_page
+      have_previous_page? ? @current_page - 1 : nil
+    end
+
+    def n_records_in_page
+      size
+    end
+
+    def start_offset
+      return nil if @n_records.zero?
+      1 + (@current_page - 1) * @page_size
+    end
+
+    def end_offset
+      return nil if @n_records.zero?
+      [start_offset + @page_size - 1, @n_records].min
+    end
+
+    def pages
+      first_page..last_page
+    end
+
+    private
+    def set_pagination_info(current_page, page_size, n_records)
+      @current_page = current_page
+      @page_size = page_size
+      @n_records = n_records
+      @n_pages = [(@n_records / @page_size.to_f).ceil, 1].max
+    end
+  end
+end

data/lib/groonga/record.rb

@@ -15,6 +15,8 @@
 # License along with this library; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
+require 'English'
+
 module Groonga
   class Record
     # レコードが所属するテーブル

data/lib/groonga/schema.rb

@@ -43,6 +43,77 @@ module Groonga
   #     end
   #   end
   class Schema
+    # スキーマ操作で発生する例外のスーパークラス。
+    class Error < Groonga::Error
+    end
+
+    # テーブルが存在しないときに発生する。
+    class TableNotExists < Error
+      attr_reader :name
+      def initialize(name)
+        @name = name
+        super("table doesn't exist: <#{@name}>")
+      end
+    end
+
+    # すでに存在するテーブルと違うオプションでテーブルを作ろ
+    # うとしたときに発生する。
+    class TableCreationWithDifferentOptions < Error
+      attr_reader :table, :options
+      def initialize(table, options)
+        @table = table
+        @options = options
+        super("creating table with differnt options: " +
+              "#{@table.inspect}: #{@options.inspect}")
+      end
+    end
+
+    # すでに存在するカラムと違うオプションでテーブルを作ろ
+    # うとしたときに発生する。
+    class ColumnCreationWithDifferentOptions < Error
+      attr_reader :column, :options
+      def initialize(column, options)
+        @column = column
+        @options = options
+        super("creating column with differnt option: " +
+              "#{@column.inspect}: #{@options.inspect}")
+      end
+    end
+
+    # 未知のインデックス対象を指定したときに発生する。
+    class UnknownIndexTarget < Error
+      attr_reader :target_name
+      def initialize(target_name)
+        @target_name = target_name
+        super("unknown index target: <#{@target_name}>")
+      end
+    end
+
+    # 未知のオプションを指定したときに発生する。
+    class UnknownOptions < Error
+      attr_reader :options, :unknown_keys, :available_keys
+      def initialize(options, unknown_keys, available_keys)
+        @options = options
+        @unknown_keys = unknown_keys
+        @available_keys = available_keys
+        message = "unknown keys are specified: #{u@nknown_keys.inspect}"
+        message << ": available keys: #{@available_keys.inspect}"
+        message << ": options: #{@options.inspect}"
+        super(message)
+      end
+    end
+
+    # 未知のテーブルの種類を指定したときに発生する。
+    class UnknownTableType < Error
+      attr_reader :type, :available_types
+      def initialize(type, available_types)
+        @type = type
+        @available_types = available_types
+        super("unknown table type: #{@type.inspect}: " +
+              "available types: #{@available_types.inspect}")
+      end
+    end
+
     class << self
 
       # call-seq:
@@ -144,11 +215,14 @@ module Groonga
       #   ルにGroonga::IndexColumnを定義する場合は
       #   <tt>"TokenBigram"</tt>などを指定する必要がある。
       #
-      # 以下は+:type+に+:patricia_trie+を指定した時に指定可能。
+      # 以下は+:type+に+:hash+または+:patricia_trie+を指定し
+      # た時に指定可能。
       #
       # [+:key_normalize+]
       #   +true+を指定するとキーを正規化する。
       #
+      # 以下は+:type+に+:patricia_trie+を指定した時に指定可能。
+      #
       # [+:key_with_sis+]
       #   +true+を指定するとキーの文字列の全suffixが自動的に
       #   登録される。
@@ -569,11 +643,18 @@ module Groonga
       def define # :nodoc:
         table = context[@name]
         if @options[:change]
-          raise ArgumentError, "table doesn't exist: #{@name}" if table.nil?
+          raise TableNotExists.new(@name) if table.nil?
         else
-          if table and @options[:force]
-            table.remove
-            table = nil
+          if table
+            unless same_table?(table, create_options)
+              if @options[:force]
+                table.remove
+                table = nil
+              else
+                options = create_options
+                raise TableCreationWithDifferentOptions.new(table, options)
+              end
+            end
           end
           table ||= @table_type.create(create_options)
         end
@@ -832,9 +913,7 @@ module Groonga
         return if options.nil?
         unknown_keys = options.keys - AVAILABLE_OPTION_KEYS
         unless unknown_keys.empty?
-          message = "unknown keys are specified: #{unknown_keys.inspect}"
-          message << ": available keys: #{AVAILABLE_OPTION_KEYS.inspect}"
-          raise ArgumentError, message
+          raise UnknownOptions.new(options, unknown_keys, AVAILABLE_OPTION_KEYS)
         end
       end
 
@@ -848,7 +927,7 @@ module Groonga
         when :patricia_trie
           Groonga::PatriciaTrie
         else
-          raise ArgumentError, "unknown table type: #{type.inspect}"
+          raise UnknownTableType.new(type, [nil, :array, :hash, :patricia_trie])
         end
       end
 
@@ -863,6 +942,7 @@ module Groonga
         }
         key_support_table_common = {
           :key_type => Schema.normalize_type(@options[:key_type]),
+          :key_normalize => @options[:key_normalize],
           :default_tokenizer => @options[:default_tokenizer],
         }
 
@@ -872,12 +952,9 @@ module Groonga
           common.merge(key_support_table_common)
         elsif @table_type == Groonga::PatriciaTrie
           options = {
-            :key_normalize => @options[:key_normalize],
             :key_with_sis => @options[:key_with_sis],
           }
           common.merge(key_support_table_common).merge(options)
-        else
-          raise ArgumentError, "unknown table type: #{@table_type.inspect}"
         end
       end
 
@@ -903,6 +980,44 @@ module Groonga
         definition.options.merge!(column_options.merge(options))
         self
       end
+
+      def same_table?(table, options)
+        return false unless table.class == @table_type
+        return false unless table.range == resolve_name(options[:value_type])
+        sub_records = options[:sub_records]
+        sub_records = false if sub_records.nil?
+        return false unless table.support_sub_records? == sub_records
+
+        case table
+        when Groonga::Array
+          true
+        when Groonga::Hash, Groonga::PatriciaTrie
+          return false unless table.domain == resolve_name(options[:key_type])
+          default_tokenizer = resolve_name(options[:default_tokenizer])
+          return false unless table.default_tokenizer == default_tokenizer
+          key_normalize = options[:key_normalize]
+          key_normalize = false if key_normalize.nil?
+          return false unless table.normalize_key? == key_normalize
+          if table.is_a?(Groonga::PatriciaTrie)
+            key_with_sis = options[:key_with_sis]
+            key_with_sis = false if key_with_sis.nil?
+            return false unless table.register_key_with_sis? == key_with_sis
+          end
+          true
+        else
+          false
+        end
+      end
+
+      def resolve_name(type)
+        if type.nil?
+          nil
+        elsif type.is_a?(String)
+          context[type]
+        else
+          type
+        end
+      end
     end
 
     class TableRemoveDefinition # :nodoc:
@@ -935,7 +1050,7 @@ module Groonga
       def define # :nodoc:
         view = context[@name]
         if @options[:change]
-          raise ArgumentError, "view doesn't exist: #{@name}" if view.nil?
+          raise TableNotExists.new(@name) if view.nil?
         else
           if view and @options[:force]
             view.remove
@@ -945,9 +1060,11 @@ module Groonga
         end
         _context = context
         @tables.each do |table|
-          _table = table
-          table = context[table] unless table.is_a?(Groonga::Table)
-          raise ArgumentError, "table doesn't exist: #{_table}" if table.nil?
+          unless table.is_a?(Groonga::Table)
+            table_name = table
+            table = context[table_name]
+            raise TableNotExists.new(table_name) if table.nil?
+          end
           view.add_table(table)
         end
         view
@@ -971,9 +1088,7 @@ module Groonga
         return if options.nil?
         unknown_keys = options.keys - AVAILABLE_OPTION_KEYS
         unless unknown_keys.empty?
-          message = "unknown keys are specified: #{unknown_keys.inspect}"
-          message << ": available keys: #{AVAILABLE_OPTION_KEYS.inspect}"
-          raise ArgumentError, message
+          raise UnknownOptions.new(options, unknown_keys, AVAILABLE_OPTION_KEYS)
         end
       end
 
@@ -1021,10 +1136,8 @@ module Groonga
           if @options.delete(:force)
             column.remove
           else
-            raise ArgumentError,
-                  "the same name column with different type is " +
-                  "already defined: #{@type.inspect}(#{@options.inspect}): " +
-                  "#{column.inspect}"
+            options = @options.merge(:type => @type)
+            raise ColumnCreationWithDifferentOptions.new(column, options)
           end
         end
         table.define_column(@name,
@@ -1073,7 +1186,7 @@ module Groonga
         if target_table.nil? or
             !(@target_column == "_key" or
               target_table.have_column?(@target_column))
-          raise ArgumentError, "Unknown index target: <#{target_name}>"
+          raise UnknownIndexTarget.new(target_name)
         end
         index = table.column(@name)
         if index
@@ -1081,11 +1194,9 @@ module Groonga
           if @options.delete(:force)
             index.remove
           else
-            raise ArgumentError,
-                  "the same name index column with " +
-                  "different target or options is " +
-                  "already defined: #{target_name.inspect}" +
-                  "(#{@options.inspect}): #{index.inspect}"
+            options = @options.merge(:type => :index,
+                                     :target_name => target_name)
+            raise ColumnCreationWithDifferentOptions.new(index, options)
           end
         end
         index = table.define_index_column(@name,

data/pkg/rroonga-0.9.5/NEWS.ja.rdoc

@@ -0,0 +1,156 @@
+= お知らせ
+
+== 0.9.5: 2010-07-29
+
+* groonga 0.7.4対応。
+* Groonga::Table#selectの改良:
+  * 重み付きマッチ対応:
+
+    sourceカラムとtitleカラムにマッチするが、
+    titleカラムの方がスコアが大きくなる例:
+      table.select do |record|
+        (record.title * 10 | record.source) =~ "query"
+      end
+  * 配列で複数条件のand表現に対応:
+
+    以下は同じ条件になる:
+      table.select do |record|
+        conditions = []
+        conditions << record.title =~ "query"
+        conditions << record.updated_at > Time.parse("2010-07-29T21:14:29+09:00")
+        conditions
+      end
+
+      table.select do |record|
+        (record.title =~ "query") &
+          (record.updated_at > Time.parse("2010-07-29T21:14:29+09:00"))
+      end
+* 利用しているgroongaのバージョン取得対応: Groonga::VERSION
+* Groonga::Table#support_sub_records?追加
+* ページネーション対応: Groonga::Table#paginate, Groonga::Pagination
+
+== 0.9.4: 2010-04-22
+
+* リリースミス修正。
+
+== 0.9.3: 2010-04-22
+
+* リリースミス修正。
+
+== 0.9.2: 2010-04-22
+
+* groonga 0.1.9対応。
+* たくさん。
+
+== 0.9.1: 2010-02-09
+
+* groonga 0.1.6対応
+
+== 0.9.0: 2010-02-09
+
+* groonga 0.1.5対応
+* APIの追加
+  * Groonga::Object#context
+  * Groonga::Record#n_sub_records
+  * Groonga::Context#send
+  * Groonga::Context#receive
+  * Groonga::PatriciaTrie#prefix_search [Tasuku SUENAGA]
+  * Groonga::Object#path [Ryo Onodera]
+  * Groonga::Object#lock [Tasuku SUENAGA]
+  * Groonga::Object#unlock [Tasuku SUENAGA]
+  * Groonga::Object#locked? [Tasuku SUENAGA]
+  * Groonga::Object#temporary?
+  * Groonga::Object#persistent?
+  * Groonga::ObjectClosed
+  * Groonga::Context.[]
+  * Groonga::Table#column_value
+  * Groonga::Table#set_column_value
+* APIの変更
+  * Groonga::Table#select, Groonga::Column#select
+    * Groonga::Expressionも受け付けるようになった
+    * grn式のシンタックスを指定する:syntaxオプションの追加
+  * Groonga::Table#open_cursor
+    * 開始位置を指定する:offsetオプションの追加
+    * 最大レコード数を指定する:limitオプションの追加
+  * Groonga::Expression.parseの引数を変更
+    * (nil (default) -> :column) -> (nil (default) -> :query)
+    * :column -> 廃止
+    * :table -> :query
+    * :table_query -> :query
+    * :expression -> :script
+    * :language -> :script
+  * Groonga::Table#define_column, Groonga::Table#define_index_column
+    * 永続テーブルをデフォルトにした
+  * Groonga::Table#[]をGroonga::Table#valueに変更
+  * Groonga::Table#[]=をGroonga::Table#set_valueに変更
+  * Groonga::Table#findをGroonga::Table#[]に変更
+  * Groonga::Table#findは非推奨
+  * Groonga::Table#[]=を削除
+  * Groonga::TableKeySupport#[]=はGroonga::TableKeySupport#addの別名
+  * Groonga::Recordで存在しないカラムにアクセスしたときの例外を
+    Groonga::InvalidArgumentからGroonga::NoSuchColumnに変更
+* バグ修正
+  * スキーマにコンテキストが伝搬されない問題の修正 [dara]
+  * Groonga::PatriciaTrie#tag_keysが最後のテキストを返さない問題の修正
+    [Ryo Onodera]
+* extconf.rbにデバッグモードでビルドする--with-debugオプションを追加
+* Ruby 1.9.1でextconf.rbが失敗する問題の修正
+
+=== 感謝
+
+* dara
+* Ryo Onodera
+* Tasuku SUENAGA
+
+== 0.0.7: 2009-10-02
+
+* groonga 0.1.4対応
+* APIの追加
+  * Groonga::PatriciaTrie#scan
+  * Groonga::PatriciaTrie#tag_keys
+  * Groonga::Expression#snippet
+  * Groonga::Object#append
+  * Groonga::Object#prepend
+
+== 0.0.6: 2009-07-31
+
+* groonga 0.1.1対応
+* ドキュメントの修正 [id:mat_aki]
+* Groonga::Table#selectでのg式対応
+* APIの追加
+  * Groonga::Table#union!
+  * Groonga::Table#intersect!
+  * Groonga::Table#differene!
+  * Groonga::Table#merge!
+* tar.gzも提供 [id:m_seki]
+* メモリリークの修正
+
+== 0.0.3: 2009-07-18
+
+* [#26145] Groonga::TableKeySupport#has_key?の追加 [Tasuku SUENAGA]
+* [#26146] カラム名が存在しない場合はGroonga::Record#[]が例外
+  をあげるように変更 [Tasuku SUENAGA]
+* 32ビット環境をサポート [niku]
+* N-gramインデックスサーチのテストを追加 [dara]
+* APIの追加
+  * Groonga::Record#incemrent!
+  * Groonga::Record#decemrent!
+  * Groonga::Record#lock
+  * Groonga::Table#lock
+  * Groonga::Schema: スキーマ定義用DSL
+  * Groonga::Expression
+
+== 0.0.2: 2009-06-04
+
+* groonga 0.0.8対応 [mori]
+* 性能向上: キー、値、ドメイン、レンジをキャッシュ
+* API改良
+* ドキュメントの追加
+* Ruby 1.9対応
+* バグ修正:
+  * インストール処理の修正 [Tasuku SUENAGA]
+  * メモリリーク修正
+
+== 0.0.1: 2009-04-30
+
+* 最初のリリース！