groonga 0.9.1 → 1.0.0

data/README.ja.rdoc

@@ -1,63 +0,0 @@
-= はじめに
-
-== 名前
-
-Ruby/groonga
-
-== 説明
-
-全文検索機能とカラムストア機能を提供するgroongaのRubyバイン
-ディングです。
-
-groongaのいわゆるDB-API層をRubyから使うための拡張ライブラリで
-す。groongaのAPIをそのままRubyレベルに提供するのではなく、
-Rubyらしく読み書きしやすいAPIとして提供します。高速・高機能な
-groongaをRubyらしい書き方で利用できます。
-
-groongaに関する情報は以下を参照して下さい。
-
-* groonga: http://groonga.org/
-
-== 作者
-
-Kouhei Sutou:: <tt><kou@clear-code.com></tt>
-Tasuku SUENAGA:: <tt><a@razil.jp></tt>
-daijiro:: <tt><morita@razil.jp></tt>
-Yuto HAYAMIZU:: <tt><y.hayamizu@gmail.com></tt>
-SHIDARA Yoji:: <tt><dara@shidara.net></tt>
-
-== ライセンス
-
-LGPL 2.1です。詳しくはlicense/LGPLを見てください。
-
-pkg-config.rbはrcairoに付属しているもので、これはRubyライセ
-ンスです。詳しくはlicense/RUBYとlicense/GPLを見てください。
-
-== 依存ソフトウェア
-
-* Ruby >= 1.8 （1.9.1対応）
-* groonga >= 0.1.4
-
-== インストール
-
-  % sudo gem install groonga
-
-== ドキュメント
-
-http://groonga.rubyforge.org/groonga/
-
-== メーリングリスト
-
-質問、要望、バグ報告などはgroongaのMLにお願いします。
-
-http://lists.sourceforge.jp/mailman/listinfo/groonga-dev
-
-== 感謝
-
-* 森さん: 最新groonga対応パッチをくれました。
-* グニャラくん: バグレポートしてくれました。
-* にくさん: バグレポートしてくれました。
-* daraさん:
-  * テストを書いてくれました。
-  * バグを直してくれました。
-* id:mat_akiさん: チュートリアルのバグを教えてくれました。

data/README.rdoc

@@ -1,64 +0,0 @@
-= README
-
-== Name
-
-Ruby/groonga
-
-== Description
-
-Ruby bindings for groonga that provides full text search and
-column store features.
-
-Ruby/groonga is a extension library to use groonga's DB-API
-layer. Ruby/groonga provides Rubyish readable and writable
-API. You can use groonga's first and highly functional
-features from Ruby.
-
-See the following URL about groonga.
-
-* groonga: http://groonga.org/
-
-== Authors
-
-Kouhei Sutou:: <tt><kou@clear-code.com></tt>
-Tasuku SUENAGA:: <tt><a@razil.jp></tt>
-daijiro:: <tt><morita@razil.jp></tt>
-Yuto HAYAMIZU:: <tt><y.hayamizu@gmail.com></tt>
-SHIDARA Yoji:: <tt><dara@shidara.net></tt>
-
-== License
-
-LGPL 2.1. See license/LGPL for details.
-
-pkg-config.rb is a library that is bundled with rcairo. It's
-distributed under Ruby license. See license/RUBY and
-license/GPL for details.
-
-== Dependencies
-
-* Ruby >= 1.8 (including 1.9.1)
-* groonga >= 0.1.4
-
-== Install
-
-  % sudo gem install groonga
-
-== Documents
-
-Japanese only. Sorry.
-
-http://groonga.rubyforge.org/groonga/
-
-== Mailing list
-
-http://rubyforge.org/mailman/listinfo/groonga-users-en
-
-== Thanks
-
-* mori: sent patches to support the latest groonga.
-* Tasuku SUENAGA: sent bug reports.
-* niku: sent bug reports.
-* dara:
-  * wrote tests.
-  * fixed bugs.
-* id:mat_aki: sent bug reports.

data/Rakefile

@@ -1,216 +0,0 @@
-# -*- coding: utf-8; mode: ruby -*-
-#
-# Copyright (C) 2009  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
-
-require 'English'
-
-require 'find'
-require 'fileutils'
-require 'pathname'
-require 'erb'
-require 'rubygems'
-gem 'rdoc'
-require 'hoe'
-
-ENV["NODOT"] = "yes"
-
-base_dir = File.join(File.dirname(__FILE__))
-truncate_base_dir = Proc.new do |x|
-  x.gsub(/^#{Regexp.escape(base_dir + File::SEPARATOR)}/, '')
-end
-
-groonga_ext_dir = File.join(base_dir, 'ext')
-groonga_lib_dir = File.join(base_dir, 'lib')
-$LOAD_PATH.unshift(groonga_ext_dir)
-$LOAD_PATH.unshift(groonga_lib_dir)
-ENV["RUBYLIB"] = "#{groonga_lib_dir}:#{groonga_ext_dir}:#{ENV['RUBYLIB']}"
-
-def guess_version
-  require 'groonga'
-  Groonga.bindings_version
-end
-
-groonga_win32_dir = "groonga"
-FileUtils.rm_rf(groonga_win32_dir)
-
-manifest = File.join(base_dir, "Manifest.txt")
-manifest_contents = []
-base_dir_included_components = %w(AUTHORS Rakefile
-                                  README.rdoc README.ja.rdoc
-                                  NEWS.rdoc NEWS.ja.rdoc
-                                  extconf.rb pkg-config.rb)
-excluded_components = %w(.cvsignore .gdb_history CVS depend Makefile doc pkg
-                         .svn .git doc vendor data .test-result)
-excluded_suffixes = %w(.png .ps .pdf .o .so .a .txt .~)
-Find.find(base_dir) do |target|
-  target = truncate_base_dir[target]
-  components = target.split(File::SEPARATOR)
-  if components.size == 1 and !File.directory?(target)
-    next unless base_dir_included_components.include?(components[0])
-  end
-  Find.prune if (excluded_components - components) != excluded_components
-  next if excluded_suffixes.include?(File.extname(target))
-  manifest_contents << target if File.file?(target)
-end
-
-File.open(manifest, "w") do |f|
-  f.puts manifest_contents.sort.join("\n")
-end
-
-# For Hoe's no user friendly default behavior. :<
-File.open("README.txt", "w") {|file| file << "= Dummy README\n== XXX\n"}
-FileUtils.cp("NEWS.rdoc", "History.txt")
-at_exit do
-  FileUtils.rm_f("README.txt")
-  FileUtils.rm_f("History.txt")
-  FileUtils.rm_f(manifest)
-end
-
-def cleanup_white_space(entry)
-  entry.gsub(/(\A\n+|\n+\z)/, '') + "\n"
-end
-
-ENV["VERSION"] ||= guess_version
-version = ENV["VERSION"]
-project = nil
-Hoe.spec('groonga') do |_project|
-  Hoe::Test::SUPPORTED_TEST_FRAMEWORKS[:testunit2] = "test/run-test.rb"
-  project = _project
-  project.version = version
-  project.rubyforge_name = 'groonga'
-  authors = File.join(base_dir, "AUTHORS")
-  project.author = File.readlines(authors).collect do |line|
-    if /\s*<[^<>]*>$/ =~ line
-      $PREMATCH
-    else
-      nil
-    end
-  end.compact
-  project.email = ['groonga-users-en@rubyforge.org',
-                   'groonga-dev@lists.sourceforge.jp']
-  project.url = 'http://groonga.rubyforge.org/'
-  project.testlib = :testunit2
-  project.test_globs = ["test/run-test.rb"]
-  project.spec_extras = {
-    :extensions => ['extconf.rb'],
-    :require_paths => ["lib", "ext"],
-    :extra_rdoc_files => Dir.glob("**/*.rdoc"),
-  }
-  project.readme_file = "README.ja.rdoc"
-
-  news_of_current_release = File.read("NEWS.rdoc").split(/^==\s.*$/)[1]
-  project.changes = cleanup_white_space(news_of_current_release)
-
-  entries = File.read("README.rdoc").split(/^==\s(.*)$/)
-  description = cleanup_white_space(entries[entries.index("Description") + 1])
-  project.summary, project.description, = description.split(/\n\n+/, 3)
-
-  project.remote_rdoc_dir = "groonga"
-end
-
-project.spec.dependencies.delete_if {|dependency| dependency.name == "hoe"}
-
-if /mswin32/ =~ project.spec.platform.to_s
-  project.spec.extensions = []
-  project.spec.files += ["ext/groonga.so", "ext/libruby-groonga.a"]
-
-  FileUtils.cp_r(File.expand_path("~/.wine/drive_c/groonga-dev"),
-                 groonga_win32_dir)
-  groonga_files = []
-  Find.find(groonga_win32_dir) do |f|
-    groonga_files << f
-  end
-  project.spec.files += groonga_files
-end
-
-ObjectSpace.each_object(Rake::RDocTask) do |rdoc_task|
-  options = rdoc_task.options
-  t_option_index = options.index("--title") || options.index("-t")
-  rdoc_task.options[t_option_index, 2] = nil
-  rdoc_task.title = "Ruby/groonga - #{version}"
-
-  rdoc_task.rdoc_files = ["ext/rb-groonga.c"] + Dir.glob("ext/rb-grn-*.c")
-  rdoc_task.rdoc_files += Dir.glob("lib/**/*.rb")
-  rdoc_task.rdoc_files += Dir.glob("**/*.rdoc")
-end
-
-task :publish_docs => [:prepare_docs_for_publishing]
-
-
-include ERB::Util
-
-def apply_template(file, head, header, footer)
-  content = File.read(file)
-  content = content.sub(/lang="en"/, 'lang="ja"')
-
-  title = nil
-  content = content.sub(/<title>(.+?)<\/title>/) do
-    title = $1
-    head.result(binding)
-  end
-
-  content = content.sub(/<body(?:.*?)>/) do |body_start|
-    "#{body_start}\n#{header.result(binding)}\n"
-  end
-
-  content = content.sub(/<\/body/) do |body_end|
-    "\n#{footer.result(binding)}\n#{body_end}"
-  end
-
-  File.open(file, "w") do |file|
-    file.print(content)
-  end
-end
-
-def erb_template(name)
-  file = File.join("html", "#{name}.html.erb")
-  template = File.read(file)
-  erb = ERB.new(template, nil, "-")
-  erb.filename = file
-  erb
-end
-
-task :prepare_docs_for_publishing do
-  head = erb_template("head")
-  header = erb_template("header")
-  footer = erb_template("footer")
-  Find.find("doc") do |file|
-    if /\.html\z/ =~ file and /_(?:c|rb)\.html\z/ !~ file
-      apply_template(file, head, header, footer)
-    end
-  end
-end
-
-task :publish_html do
-  config = YAML.load(File.read(File.expand_path("~/.rubyforge/user-config.yml")))
-  host = "#{config["username"]}@rubyforge.org"
-
-  rsync_args = "-av --exclude '*.erb' --exclude '*.svg' --exclude .svn"
-  remote_dir = "/var/www/gforge-projects/#{project.rubyforge_name}/"
-  sh "rsync #{rsync_args} html/ #{host}:#{remote_dir}"
-end
-
-task :tag do
-  repository = "svn+ssh://rubyforge.org/var/svn/groonga/groonga"
-  sh("svn cp -m 'release #{version}!!!' " +
-     "#{repository}/trunk #{repository}/tags/#{version}")
-end
-
-# fix Hoe's incorrect guess.
-project.spec.executables.clear
-# project.lib_files = project.spec.files.grep(%r|^src/lib/|)
-
-task(:release).prerequisites.reject! {|name| name == "clean"}

data/benchmark/common.rb

@@ -1,49 +0,0 @@
-require 'benchmark'
-require 'tempfile'
-
-def memory_usage()
-  status = `cat /proc/#{$$}/status`
-  lines = status.split("\n")
-  lines.each do |line|
-    if line =~ /^VmRSS:/
-      line.gsub!(/.*:\s*(\d+).*/, '\1')
-      return line.to_i / 1024.0
-    end
-  end
-  return -1;
-end
-
-@items = []
-
-def item(label, &block)
-  @items << [label, block]
-end
-
-def report(index=0)
-  width = @items.collect do |label, _|
-    label.length
-  end.max
-
-  label, block = @items[index]
-  if label.nil?
-    puts "unavailable report ID: #{index}"
-    puts "available IDs:"
-    @items.each_with_index do |(label, block), i|
-      puts "#{i}: #{label}"
-    end
-    exit 1
-  end
-
-  if index.zero?
-    puts(" " * (width - 1) + Benchmark::Tms::CAPTION.rstrip + "memory".rjust(14))
-  end
-  # GC.disable
-  before = memory_usage
-  result = Benchmark.measure(&block)
-  # GC.enable
-  GC.start
-  size = memory_usage - before
-
-  formatted_size = "%10.3f" % size
-  puts "#{label.ljust(width)} #{result.to_s.strip} #{formatted_size}MB"
-end

data/benchmark/read-write-many-small-items.rb

@@ -1,144 +0,0 @@
-#!/usr/bin/ruby
-
-# This benchmark is based on Tokyo Cabinet's benchmark at
-# http://alpha.mixi.co.jp/blog/?p=791
-#
-# On my environment at 2009/07/14:
-# % for x in {0..9}; do ruby benchmark/read-write-many-small-items.rb $x; done
-#                           user     system      total        real        memory
-# Hash                  0.850000   0.170000   1.020000 (  1.050703)     46.957MB
-# groonga: Hash: memory 1.080000   0.180000   1.260000 (  1.251981)     30.152MB
-# groonga: Trie: memory 1.300000   0.120000   1.420000 (  1.429549)     22.199MB
-# groonga: Hash: file   1.070000   0.190000   1.260000 (  1.276910)     30.156MB
-# groonga: Trie: file   1.280000   0.150000   1.430000 (  1.423066)     22.203MB
-# Localmemcache: file   1.320000   0.150000   1.470000 (  1.497013)     45.984MB
-# TC: Hash: memory      0.940000   0.250000   1.190000 (  1.248141)     48.758MB
-# TC: Tree: memory      0.890000   0.140000   1.030000 (  1.067693)     37.270MB
-# TC: Hash: file        1.740000   2.390000   4.130000 (  4.141555)      8.848MB
-# TC: Tree: file        1.290000   0.180000   1.470000 (  1.476853)     12.805MB
-#
-# CPU: Intel(R) Core(TM)2 Duo 2.33GHz
-# Memory: 2GB
-# Ruby: Debian GNU/Linux sid at 2009/07/14:
-#       ruby 1.8.7 (2009-06-12 patchlevel 174) [x86_64-linux]
-# groonga: HEAD at 2009/07/14: fdaf58df5dd0195c10624eabee3e3f522f4af3f9
-# Ruby/Groonga: trunk at 2009/07/14: r479
-# Localmemcache: HEAD at 2009/07/14: 3121629016344dfd10f7533ca8ec68a0006cca21
-# Tokyo Cabinet: 1.4.29
-# Tokyo Cabinet Ruby: 1.27
-#
-# NOTE:
-# * groonga, Localmemcache and Tokyo Cabinet are built with "-O3" option.
-# * Ruby bindings of them are built with "-O2" option.
-
-require File.join(File.dirname(__FILE__), "common.rb")
-
-n = 500000
-
-values = []
-n.times do |i|
-  values << "%08d" % i
-end
-
-item("Hash") do
-  @hash = {}
-  values.each do |value|
-    @hash[value] = value
-    @hash[value]
-  end
-end
-
-begin
-  base_dir = File.expand_path(File.join(File.dirname(__FILE__), ".."))
-  $LOAD_PATH.unshift(File.join(base_dir, "ext"))
-  $LOAD_PATH.unshift(File.join(base_dir, "lib"))
-
-  require 'groonga'
-  tmp_dir = "/tmp/groonga"
-  FileUtils.rm_rf(tmp_dir)
-  FileUtils.mkdir(tmp_dir)
-  @database = Groonga::Database.create(:path => "#{tmp_dir}/db")
-
-  item("groonga: Hash: file") do
-    @hash = Groonga::Hash.create(:name => "Hash",
-                                 :key_type => "ShortText")
-    column_name = "value"
-    @column = @hash.define_column(column_name, "ShortText")
-    values.each do |value|
-      @hash.set_column_value(value, column_name, value)
-      @hash.column_value(value, column_name)
-    end
-  end
-
-  item("groonga: Trie: file") do
-    @trie = Groonga::PatriciaTrie.create(:name => "PatriciaTrie",
-                                         :key_type => "ShortText")
-    column_name = "value"
-    @column = @trie.define_column(column_name, "ShortText")
-    values.each do |value|
-      @trie.set_column_value(value, column_name, value)
-      @trie.column_value(value, column_name)
-    end
-  end
-rescue LoadError
-end
-
-begin
-  require 'localmemcache'
-
-  item("Localmemcache: file") do
-    LocalMemCache.drop(:namespace => "read-write-many-small-items",
-                       :force => true)
-    @db = LocalMemCache.new(:namespace => "read-write-many-small-items")
-    values.each do |value|
-      @db[value] = value
-      @db[value]
-    end
-  end
-rescue LoadError
-end
-
-begin
-  require 'tokyocabinet'
-
-  item("TC: Hash: memory") do
-    @db = TokyoCabinet::ADB::new
-    @db.open("*#bnum=#{n}#mode=wct#xmsiz=0")
-    values.each do |value|
-      @db.put(value, value)
-      @db.get(value)
-    end
-  end
-
-  item("TC: Tree: memory") do
-    @db = TokyoCabinet::ADB::new
-    @db.open("+#bnum=#{n}#mode=wct#xmsiz=0")
-    values.each do |value|
-      @db.put(value, value)
-      @db.get(value)
-    end
-  end
-
-  hash_file = Tempfile.new(["tc-hash", ".tch"])
-  item("TC: Hash: file") do
-    @db = TokyoCabinet::ADB::new
-    @db.open("#{hash_file.path}#bnum=#{n}#mode=wct#xmsiz=0")
-    values.each do |value|
-      @db.put(value, value)
-      @db.get(value)
-    end
-  end
-
-  tree_file = Tempfile.new(["tc-tree", ".tcb"])
-  item("TC: Tree: file") do
-    @db = TokyoCabinet::ADB::new
-    @db.open("#{tree_file.path}#bnum=#{n}#mode=wct#xmsiz=0")
-    values.each do |value|
-      @db.put(value, value)
-      @db.get(value)
-    end
-  end
-rescue LoadError
-end
-
-report(Integer(ARGV[0] || 0))