rroonga 7.0.2-x86-mingw32 → 7.1.1-x86-mingw32

data/lib/groonga/statistic-measurer.rb

@@ -1,37 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Copyright (C) 2013  Kouhei Sutou <kou@clear-code.com>
-#
-# This library is free software; you can redistribute it and/or
-# modify it under the terms of the GNU Lesser General Public
-# License version 2.1 as published by the Free Software Foundation.
-#
-# This library is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public
-# License along with this library; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-
-module Groonga
-  # Measures statistic.
-  class StatisticMeasurer
-    MAX_N_ADDITIONAL_PATHS = 4096
-
-    # @param path [String, nil] Measures disk usage of the path.
-    # @return [Integer] 0 if path is @nil@, disk usage of the path otherwise.
-    def measure_disk_usage(path)
-      return 0 if path.nil?
-
-      usage = File.size(path)
-      1.step(MAX_N_ADDITIONAL_PATHS) do |i|
-        additional_path = "%s.%03X" % [path, i]
-        break unless File.exist?(additional_path)
-        usage += File.size(additional_path)
-      end
-      usage
-    end
-  end
-end

data/test/test-statistic-measurer.rb

@@ -1,55 +0,0 @@
-# Copyright (C) 2013  Kouhei Sutou <kou@clear-code.com>
-#
-# This library is free software; you can redistribute it and/or
-# modify it under the terms of the GNU Lesser General Public
-# License version 2.1 as published by the Free Software Foundation.
-#
-# This library is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public
-# License along with this library; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-
-class StatisticMeasurerTest < Test::Unit::TestCase
-  include GroongaTestUtils
-
-  def setup
-    @measurer = Groonga::StatisticMeasurer.new
-  end
-
-  class DiskUsageTest < self
-    def test_nil
-      assert_equal(0, disk_usage(nil))
-    end
-
-    def test_path_only
-      size = 5
-      path = File.join(@tmp_dir, "db")
-      write(path, "X" * size)
-      assert_equal(size, disk_usage(path))
-    end
-
-    def test_additional_path
-      size_per_file = 5
-      path = File.join(@tmp_dir, "db")
-      write(path, "X" * size_per_file)
-      write("#{path}.001", "X" * size_per_file)
-      write("#{path}.002", "X" * size_per_file)
-      assert_equal(3 * size_per_file, disk_usage(path))
-    end
-
-    private
-    def disk_usage(path)
-      @measurer.measure_disk_usage(path)
-    end
-
-    def write(path, content)
-      File.open(path, "w") do |file|
-        file.write(content)
-      end
-    end
-  end
-end

data/vendor/local/share/doc/groonga/en/html/_sources/characteristic.txt

@@ -1,70 +0,0 @@
-.. -*- rst -*-
-.. Groonga project
-
-.. highlightlang:: none
-
-Characteristics of Groonga
-==========================
-
-Groonga overview
-----------------
-
-Groonga is a fast and accurate full text search engine based on inverted index. One of the characteristics of Groonga is that a newly registered document instantly appears in search results. Also, Groonga allows updates without read locks. These characteristics result in superior performance on real-time applications.
-
-Groonga is also a column-oriented database management system (DBMS). Compared with well-known row-oriented systems, such as MySQL and PostgreSQL, column-oriented systems are more suited for aggregate queries. Due to this advantage, Groonga can cover weakness of row-oriented systems.
-
-The basic functions of Groonga are provided in a C library. Also, libraries for using Groonga in other languages, such as Ruby, are provided by related projects. In addition, groonga-based storage engines are provided for MySQL and PostgreSQL. These libraries and storage engines allow any application to use Groonga. See `usage examples <http://groonga.org/users/>`_.
-
-Full text search and Instant update
------------------------------------
-
-In widely used DBMSs, updates are immediately processed, for example, a newly registered record appears in the result of the next query. In contrast, some full text search engines do not support instant updates, because it is difficult to dynamically update inverted indexes, the underlying data structure.
-
-Groonga also uses inverted indexes but supports instant updates. In addition, Groonga allows you to search documents even when updating the document collection. Due to these superior characteristics, Groonga is very flexible as a full text search engine. Also, Groonga always shows good performance because it divides a large task, inverted index merging, into smaller tasks.
-
-Column store and aggregate query
---------------------------------
-
-People can collect more than enough data in the Internet era. However, it is difficult to extract informative knowledge from a large database, and such a task requires a many-sided analysis through trial and error. For example, search refinement by date, time and location may reveal hidden patterns. Aggregate queries are useful to perform this kind of tasks.
-
-An aggregate query groups search results by specified column values and then counts the number of records in each group. For example, an aggregate query in which a location column is specified counts the number of records per location. Making a graph from the result of an aggregate query against a date column is an easy way to visualize changes over time. Also, a combination of refinement by location and an aggregate query against a date column allows visualization of changes over time in specific location. Thus refinement and aggregation are important to perform data mining.
-
-A column-oriented architecture allows Groonga to efficiently process aggregate queries because a column-oriented database, which stores records by column, allows an aggregate query to access only a specified column. On the other hand, an aggregate query on a row-oriented database, which stores records by row, has to access neighbor columns, even though those columns are not required.
-
-Inverted index and tokenizer
-----------------------------
-
-An inverted index is a traditional data structure used for large-scale full text search. A search engine based on inverted index extracts index terms from a document when it is added. Then in retrieval, a query is divided into index terms to find documents containing those index terms. In this way, index terms play an important role in full text search and thus the way of extracting index terms is a key to a better search engine.
-
-A tokenizer is a module to extract index terms. A Japanese full text search engine commonly uses a word-based tokenizer (hereafter referred to as a word tokenizer) and/or a character-based n-gram tokenizer (hereafter referred to as an n-gram tokenizer). A word tokenizer-based search engine is superior in time, space and precision, which is the fraction of relevant documents in a search result. On the other hand, an n-gram tokenizer-based search engine is superior in recall, which is the fraction of retrieved documents in the perfect search result. The best choice depends on the application in practice.
-
-Groonga supports both word and n-gram tokenizers. The simplest built-in tokenizer uses spaces as word delimiters. Built-in n-gram tokenizers (n = 1, 2, 3) are also available by default. In addition, a yet another built-in word tokenizer is available if MeCab, a part-of-speech and morphological analyzer, is embedded. Note that a tokenizer is pluggable and you can develop your own tokenizer, such as a tokenizer based on another part-of-speech tagger or a named-entity recognizer.
-
-Sharable storage and read lock-free
------------------------------------
-
-Multi-core processors are mainstream today and the number of cores per processor is increasing. In order to exploit multiple cores, executing multiple queries in parallel or dividing a query into sub-queries for parallel processing is becoming more important.
-
-A database of Groonga can be shared with multiple threads/processes. Also, multiple threads/processes can execute read queries in parallel even when another thread/process is executing an update query because Groonga uses read lock-free data structures. This feature is suited to a real-time application that needs to update a database while executing read queries. In addition, Groonga allows you to build flexible systems. For example, a database can receive read queries through the built-in HTTP server of Groonga while accepting update queries through MySQL.
-
-Geo-location (latitude and longitude) search
---------------------------------------------
-
-Location services are getting more convenient because of mobile devices with GPS. For example, if you are going to have lunch or dinner at a nearby restaurant, a local search service for restaurants may be very useful, and for such services, fast geo-location search is becoming more important.
-
-Groonga provides inverted index-based fast geo-location search, which supports a query to find points in a rectangle or circle. Groonga gives high priority to points near the center of an area. Also, Groonga supports distance measurement and you can sort points by distance from any point.
-
-Groonga library
----------------
-
-The basic functions of Groonga are provided in a C library and any application can use Groonga as a full text search engine or a column-oriented database. Also, libraries for languages other than C/C++, such as Ruby, are provided in related projects. See `related projects <http://groonga.org/related-projects.html>`_ for details.
-
-Groonga server
---------------
-
-Groonga provides a built-in server command which supports HTTP, the memcached binary protocol and the Groonga Query Transfer Protocol (:doc:`/spec/gqtp`). Also, a Groonga server supports query caching, which significantly reduces response time for repeated read queries. Using this command, Groonga is available even on a server that does not allow you to install new libraries.
-
-Mroonga storage engine
-----------------------
-
-Groonga works not only as an independent column-oriented DBMS but also as storage engines of well-known DBMSs. For example, `Mroonga <http://mroonga.org/>`_ is a MySQL pluggable storage engine using Groonga. By using Mroonga, you can use Groonga for column-oriented storage and full text search. A combination of a built-in storage engine, MyISAM or InnoDB, and a Groonga-based full text search engine is also available. All the combinations have good and bad points and the best one depends on the application. See `related projects <http://groonga.org/related-projects.html>`_ for details.

data/vendor/local/share/doc/groonga/en/html/_sources/client.txt

@@ -1,19 +0,0 @@
-.. -*- rst -*-
-.. Groonga Project
-
-.. highlightlang:: none
-
-Client
-======
-
-Groonga supports the original protocol (:doc:`/spec/gqtp`), the memcached
-binary protocol and HTTP.
-
-As HTTP and memcached binary protocol is matured protocol, you can use
-existing client libraries.
-
-There are some client libraries which provides convenient API to connect
-to Groonga server in some program languages. See `Client libraries
-<http://groonga.org/related-projects.html#libraries>`_ for details.
-
-

data/vendor/local/share/doc/groonga/en/html/_sources/community.txt

@@ -1,49 +0,0 @@
-.. -*- rst -*-
-.. Groonga Project
-
-.. highlightlang:: none
-
-Community
-=========
-
-There are some places for sharing Groonga information.
-We welcome you to join our community.
-
-Mailing List
-------------
-
-There are mailing lists for discussion about Groonga.
-
-For English speakers
-  `groonga-talk@lists.sourceforge.net <http://lists.sourceforge.net/mailman/listinfo/groonga-talk>`_
-
-For Japanese speakers
-  `groonga-dev@lists.osdn.me <http://lists.osdn.me/mailman/listinfo/groonga-dev>`_
-
-Chat room
----------
-
-There are chat rooms for discussion about Groonga.
-
-For English speakers
-  `groonga/en chat room on Gitter <https://gitter.im/groonga/en>`_
-
-For Japanese speakers
-  `groonga/ja chat room on Gitter <https://gitter.im/groonga/ja>`_
-
-Twitter
--------
-
-`@groonga <https://twitter.com/groonga/>`_ tweets Groonga related
-information.
-
-Please follow the account to get the latest Groonga related
-information!
-
-Facebook
---------
-
-`Groonga page on Facebook <http://www.facebook.com/groonga>`_ shares
-Groonga related information.
-
-Please like the page to get the latest Groonga related information!

data/vendor/local/share/doc/groonga/en/html/_sources/contribution.txt

@@ -1,26 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-How to contribute to groonga
-============================
-
-We welcome your contributions to the groonga project. There are many ways
-to contribute, such as using groonga, introduction to others, etc.
-For example, if you find a bug when using groonga, you are welcome to
-report the bug. Coding and documentation are also welcome for groonga and
-its related projects.
-
-As a user:
-  If you are interested in groonga, please read this document and try it.
-As a spokesman:
-  Please introduce groonga to your friends and colleagues.
-As a developer: Bug report, development and documentation
-  This section describes the details.
-
-.. toctree::
-   :maxdepth: 3
-
-   contribution/report
-   contribution/documentation
-   contribution/development

data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development.txt

@@ -1,14 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-For Groonga developers
-======================
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   development/repository
-   development/build
-   development/*

data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build.txt

@@ -1,19 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-How to build Groonga at the repository
-======================================
-
-This document describes how to build Groonga at the repository for
-each build system. You can choose GNU Autotools or CMake if you
-develop Groonga on GNU/Linux or Unix (\*BSD, Solaris, OS X and so
-on). You need to use CMake if you develop on Windows.
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   build/unix_autotools
-   build/unix_cmake
-   build/windows_cmake

data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/unix_autotools.txt

@@ -1,101 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-How to build Groonga at the repository by GNU Autotools
-=======================================================
-
-This document describes how to build Groonga at the repository by GNU
-Autotools.
-
-You can't choose this way if you develop Groonga on Windows. If you
-want to use Windows for developing Groonga, see :doc:`windows_cmake`.
-
-Install depended software
--------------------------
-
-TODO
-
-  * `Autoconf <http://www.gnu.org/software/autoconf/>`_
-  * `Automake <http://www.gnu.org/software/automake/>`_
-  * `GNU Libtool <http://www.gnu.org/software/libtool/>`_
-  * `Ruby <https://www.ruby-lang.org/>`_
-  * `Git <https://git-scm.com/>`_
-  * `Cutter <http://cutter.sourceforge.net/>`_
-  * ...
-
-Checkout Groonga from the repository
-------------------------------------
-
-Users use released source archive. But developers must build Groonga
-at the repository. Because source code in the repository is the
-latest.
-
-The Groonga repository is hosted on `GitHub
-<https://github.com/groonga/groonga>`_. Checkout the latest source
-code from the repository::
-
-  % git clone --recursive git@github.com:groonga/groonga.git
-
-Create ``configure``
---------------------
-
-You need to create ``configure``. ``configure`` is included in source
-archive but not included in the repository.
-
-``configure`` is a build tool that detects your system and generates
-build configurations for your environment.
-
-Run ``autogen.sh`` to create ``configure``::
-
-  % ./autogen.sh
-
-Run ``configure``
------------------
-
-You can custom your build configuration by passing options to
-``configure``.
-
-Here are recommended ``configure`` options for developers::
-
-  % ./configure --prefix=/tmp/local --enable-debug --enable-mruby --with-ruby
-
-Here are descriptions of these options:
-
-``--prefix=/tmp/local``
-    It specifies that you install your Groonga into temporary
-    directory. You can do "clean install" by removing
-    ``/tmp/local`` directory. It'll be useful for debugging install.
-
-``--enable-debug``
-    It enables debug options for C/C++ compiler. It's useful for
-    debugging on debugger such as GDB and LLDB.
-
-``--eanble-mruby``
-    It enables mruby support. The feature isn't enabled by default
-    but developers should enable the feature.
-
-``--with-ruby``
-    It's needed for ``--enable-mruby`` and running functional tests.
-
-Run ``make``
-------------
-
-Now, you can build Groonga.
-
-Here is a recommended ``make`` command line for developers::
-
-  % make -j8 > /dev/null
-
-``-j8`` decreases build time. It enables parallel build. If you have 8
-or more CPU cores, you can increase ``8`` to decreases more build
-time.
-
-You can just see only warning and error messages by ``>
-/dev/null``. Developers shouldn't add new warnings and errors in new
-commit.
-
-See also
---------
-
-  * :doc:`/contribution/development/test`

data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/build/unix_cmake.txt

@@ -1,94 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-How to build Groonga at the repository by CMake on GNU/Linux or Unix
-====================================================================
-
-This document describes how to build Groonga at the repository by
-CMake on GNU/Linux or Unix.
-
-Unix is \*BSD, Solaris, OS X and so on.
-
-If you want to use Windows for developing Groonga, see
-:doc:`windows_cmake`.
-
-You can't choose this way if you want to release Groonga. Groonga
-release system is only supported by GNU Autotools build. See
-:doc:`unix_autotools` about GNU Autotools build.
-
-Install depended software
--------------------------
-
-TODO
-
-  * `CMake <http://www.cmake.org/>`_
-  * `Ruby <https://www.ruby-lang.org/>`_
-  * `Git <https://git-scm.com/>`_
-  * `Cutter <http://cutter.sourceforge.net/>`_
-  * ...
-
-Checkout Groonga from the repository
-------------------------------------
-
-Users use released source archive. But developers must build Groonga
-at the repository. Because source code in the repository is the
-latest.
-
-The Groonga repository is hosted on `GitHub
-<https://github.com/groonga/groonga>`_. Checkout the latest source
-code from the repository::
-
-  % git clone --recursive git@github.com:groonga/groonga.git
-
-Run ``cmake``
--------------
-
-You need to create ``Makefile`` for your environment.
-
-You can custom your build configuration by passing options to
-``cmake``.
-
-Here are recommended ``cmake`` options for developers::
-
-  % cmake . -DCMAKE_INSTALL_PREFIX=/tmp/local -DGRN_WITH_DEBUG=on -DGRN_WITH_MRUBY=on
-
-Here are descriptions of these options:
-
-``-DCMAKE_INSTALL_PREFIX=/tmp/local``
-
-    It specifies that you install your Groonga into temporary
-    directory. You can do "clean install" by removing
-    ``/tmp/local`` directory. It'll be useful for debugging install.
-
-``-DGRN_WITH_DEBUG=on``
-
-    It enables debug options for C/C++ compiler. It's useful for
-    debugging on debugger such as GDB and LLDB.
-
-``-DGRN_WITH_MRUBY=on``
-
-    It enables mruby support. The feature isn't enabled by default
-    but developers should enable the feature.
-
-Run ``make``
-------------
-
-Now, you can build Groonga.
-
-Here is a recommended ``make`` command line for developers::
-
-  % make -j8 > /dev/null
-
-``-j8`` decreases build time. It enables parallel build. If you have 8
-or more CPU cores, you can increase ``8`` to decreases more build
-time.
-
-You can just see only warning and error messages by ``>
-/dev/null``. Developers shouldn't add new warnings and errors in new
-commit.
-
-See also
---------
-
-  * :doc:`/contribution/development/test`