OpenSearch

The opensearch library provides a Ruby client and API for OpenSearch.

Features overview:

Compatibility

The OpenSearch client for Ruby is compatible with Ruby 1.9 and higher.

The client’s API is compatible with OpenSearch’s API versions from 1.0.0 till current.

Installation

Install the package from Rubygems:

gem install opensearch-ruby

To use an unreleased version, either add it to your Gemfile for Bundler:

gem 'opensearch-ruby', git: 'git://github.com/opensearch-project/opensearch-ruby.git'

or install it from a source code checkout:

git clone https://github.com/opensearch-project/opensearch-ruby
cd opensearch-ruby/opensearch
bundle install
rake install

Usage

This library is a wrapper for two separate libraries:

Install the opensearch package and use the API directly:

require 'opensearch'

client = OpenSearch::Client.new log: true

client.cluster.health

client.transport.reload_connections!

client.search q: 'test'

# etc.

Please refer to the specific library documentation for details:

Development

You can run rake -T to check the test tasks. Use COVERAGE=true before running a test task to check the coverage with Simplecov.

License

This software is licensed under the Apache 2 license.