esearch 0.2.0

data/.gitignore

@@ -0,0 +1,5 @@
+/Gemfile.lock
+/tmp
+/.bundle
+/vendor
+/.rbx

data/.rspec

@@ -0,0 +1,6 @@
+--color
+--format progress
+--profile
+--order random
+--fail-fast
+--backtrace

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+script: 'bundle exec rake ci'
+services:
+  - elasticsearch
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - ruby-head
+  - jruby-19mode
+  - jruby-head
+  - rbx-19mode
+matrix:
+  allow_failures:
+    - rvm: rbx-18mode # Json lib is defunct
+notifications:
+  irc: "irc.freenode.org#datamapper"
+  email:
+    - mbj@seonic.net

data/Changelog.md

@@ -0,0 +1,27 @@
+# v0.2.0 2013-05-19
+
+* Rename lib to esearch
+
+# v0.1.5 2013-04-24
+
+* Fix op_type query param for updates
+
+# v0.1.4 2013-04-23
+
+* Correctly pass query params to db.
+
+# v0.1.3 2013-04-23
+
+* Return nil on Document#get when document does not exist
+
+# v0.1.2 2013-04-14
+
+* Do not deep freeze presenters, fixes performance problems.
+
+# v0.1.1 2013-03-09
+
+* Add Presenter::Hit#fields
+
+# v0.1.0 2013-03-09
+
+* First public release!

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'devtools', :git => 'https://github.com/datamapper/devtools.git'
+eval File.read('Gemfile.devtools')

data/Gemfile.devtools

@@ -0,0 +1,60 @@
+# encoding: utf-8
+
+group :development do
+  gem 'rake',  '~> 10.0.4'
+  gem 'rspec', '~> 2.13.0'
+  gem 'yard',  '~> 0.8.6.1'
+end
+
+group :yard do
+  gem 'kramdown', '~> 1.0.1'
+end
+
+group :guard do
+  gem 'guard',         '~> 1.8.0'
+  gem 'guard-bundler', '~> 1.0.0'
+  gem 'guard-rspec',   '~> 2.5.4'
+
+  # file system change event handling
+  gem 'listen',     '~> 1.0.2'
+  gem 'rb-fchange', '~> 0.0.6', :require => false
+  gem 'rb-fsevent', '~> 0.9.3', :require => false
+  gem 'rb-inotify', '~> 0.9.0', :require => false
+
+  # notification handling
+  gem 'libnotify',               '~> 0.8.0', :require => false
+  gem 'rb-notifu',               '~> 0.0.4', :require => false
+  gem 'terminal-notifier-guard', '~> 1.5.3', :require => false
+end
+
+group :metrics do
+  gem 'backports',       '~> 3.3', '>= 3.3.0'
+  gem 'coveralls',       '~> 0.6.6'
+  gem 'flay',            '~> 2.2.0'
+  gem 'flog',            '~> 4.0.0'
+  gem 'reek',            '~> 1.3.1', :git => 'https://github.com/troessner/reek.git'
+  gem 'simplecov',       '~> 0.7.1'
+  gem 'yardstick',       '~> 0.9.6'
+
+  platforms :ruby_19 do
+    gem 'yard-spellcheck', '~> 0.1.5'
+  end
+
+  platforms :mri_19, :rbx do
+    gem 'mutant', '~> 0.2.20'
+  end
+
+  platforms :rbx do
+    gem 'pelusa', '~> 0.2.2'
+  end
+end
+
+group :benchmarks do
+  gem 'rbench', '~> 0.2.3'
+end
+
+platform :jruby do
+  group :jruby do
+    gem 'jruby-openssl', '~> 0.8.5'
+  end
+end

data/Guardfile

@@ -0,0 +1,18 @@
+# encoding: utf-8
+
+guard :bundler do
+  watch('Gemfile')
+end
+
+guard :rspec, :version => 2 do
+  # run all specs if the spec_helper or supporting files files are modified
+  watch('spec/spec_helper.rb')                      { 'spec/unit' }
+  watch(%r{\Aspec/(?:lib|support|shared)/.+\.rb\z}) { 'spec/unit' }
+
+  # run unit specs if associated lib code is modified
+  watch(%r{\Alib/(.+)\.rb\z})                                         { |m| Dir["spec/unit/#{m[1]}"] }
+  watch("lib/#{File.basename(File.expand_path('../', __FILE__))}.rb") { 'spec/unit'                       }
+
+  # run a spec if it is modified
+  watch(%r{\Aspec/(?:unit|integration)/.+_spec\.rb\z})
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Markus Schirp
+
+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,93 @@
+esearch
+=======
+
+[![Build Status](https://secure.travis-ci.org/mbj/esearch.png?branch=master)](http://travis-ci.org/mbj/esearch)
+[![Dependency Status](https://gemnasium.com/mbj/esearch.png)](https://gemnasium.com/mbj/esearch)
+[![Code Climate](https://codeclimate.com/github/mbj/esearch.png)](https://codeclimate.com/github/mbj/esearch)
+
+Terminate the [esearch API](http://www.esearch.org/guide/reference/api/) in a friendly ruby PORO api.
+
+Installation
+------------
+
+Install the gem `esearch` via your preferred method.
+
+Examples
+--------
+
+```ruby
+# Settings suitable for operation on single node
+settings = {
+  :settings => {
+    :number_of_shards => 1,
+    :number_of_replicas => 0
+  }
+)
+
+# Connect to a cluster
+cluster = Esearch::Cluster.connect(uri, Logger.new($stderr, :debug)) }
+
+# Create index 
+index_a = cluster.index('test-a')
+index_a.exist? # => false, does not exist jet
+index_a.create(settings) 
+index_a.exist? # => true
+
+# Create another index
+index_b = cluster.index('test-b')
+index_b.create(SINGLE_NODE_SETTINGS)
+
+# Wait for cluster initialization
+cluster.health(:wait_for_status => :green, :timeout => '10s')
+
+# Access many indexes at once
+indices = cluster.indices(%w(test-a test-b))
+
+# Index some data
+result_a = index_a.type('type-a').index({'foo' => 'bar'})
+result_b = index_b.type('type-b').index({'foo' => 'baz'})
+
+# Refresh indices
+indices.refresh
+
+# Query all documents in index a
+result = index_a.search({:query => { :match_all => {}}})
+result.hits.map(&:source) # => [{'foo' => 'bar'}]
+
+# Query all documents across two indexes
+result = indices.search({:query => { :match_all => {}}})
+result.hits.map(&:source) # => [{'foo' => 'bar'}, {'foo' => 'baz'}]
+
+# Delete a document
+index_a.type('type-a').document(result_a.id).delete
+
+# Query a document by id
+document = index_b.type('type-b').document(result_b.id).get
+document.source # => {'foo' => 'baz'}
+```
+
+Compatibility
+-------------
+
+Tested under {mri,jruby,rbx} > 1.8.
+
+Credits
+-------
+
+* [Markus Schirp (mbj)](https://github.com/mbj) Author
+
+Contributing
+-------------
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with Rakefile or version
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+License
+-------
+
+This gem is published under the MIT license. See LICENSE file.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'devtools'
+Devtools.init_rake_tasks

data/TODO

@@ -0,0 +1,3 @@
+* Investigate into other transport protocols than HTTP
+* Provide Esearch::Document::Version for version scoped operations
+* Add bulk operations

data/config/devtools.yml

@@ -0,0 +1,2 @@
+---
+unit_test_timeout: 1.0

data/config/flay.yml

@@ -0,0 +1,3 @@
+---
+threshold: 12 
+total_score: 189

data/config/flog.yml

@@ -0,0 +1,3 @@
+---
+threshold: 12.7
+total_score: 109.0

data/config/mutant.yml

@@ -0,0 +1,3 @@
+---
+lib: esearch
+namespace: Esearch

data/config/reek.yml

@@ -0,0 +1,103 @@
+---
+UncommunicativeParameterName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+TooManyMethods:
+  max_methods: 10
+  exclude:
+  - Esearch::Command # 12 methods, TODO: Bring down to 10. Extraction of Response class!
+  - Esearch::Request # 4 instance variables. Acceptable as this is a DTO
+  enabled: true
+  max_instance_variables: 3
+UncommunicativeMethodName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^[a-z]$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+LongParameterList:
+  max_params: 2 
+  exclude:
+  - Esearch::Request#initialize # 4 parameters, acceptable it is a DTO
+  enabled: true
+  overrides: {}
+FeatureEnvy:
+  exclude: []
+  enabled: true
+ClassVariable:
+  exclude: []
+  enabled: true
+BooleanParameter:
+  exclude: []
+  enabled: true
+IrresponsibleModule:
+  exclude: []
+  enabled: true
+UncommunicativeModuleName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+NestedIterators:
+  ignore_iterators: []
+  exclude:
+  - Esearch::Presenter#self.expose_tagged_collection # 2 levels
+  enabled: true
+  max_allowed_nesting: 1
+TooManyStatements:
+  max_statements: 5
+  exclude: []
+  enabled: true
+DuplicateMethodCall:
+  allow_calls: 
+  - util.debug
+  exclude: []
+  enabled: true
+  max_calls: 1
+UtilityFunction:
+  max_helper_calls: 1
+  exclude: []
+  enabled: true
+Attribute:
+  exclude: []
+  enabled: false
+UncommunicativeVariableName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+RepeatedConditional:
+  exclude: []
+  enabled: true
+  max_ifs: 2
+DataClump:
+  exclude: []
+  enabled: true
+  max_copies: 1
+  min_clump_size: 3
+ControlParameter:
+  exclude: 
+  - Esearch::Index#read
+  enabled: true
+LongYieldList:
+  max_params: 1
+  exclude: []
+  enabled: true
+UnusedParameters:
+  exclude:
+    - Esearch::NullLogger#self.debug
+    - Esearch::NullLogger#self.error
+    - Esearch::NullLogger#self.info
+    - Esearch::NullLogger#self.warn

data/config/yardstick.yml

@@ -0,0 +1,2 @@
+---
+threshold: 100

data/esearch.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.name        = 'esearch'
+  gem.version     = '0.2.0'
+  gem.authors     = [ 'Markus Schirp' ]
+  gem.email       = [ 'mbj@seonic.net' ]
+  gem.description = 'Esearch driver for ruby'
+  gem.summary     = gem.description
+  gem.homepage    = 'https://github.com/mbj/elasticsearch'
+  gem.license     = 'MIT'
+
+  gem.require_paths    = [ 'lib' ]
+  gem.files            = `git ls-files`.split("\n")
+  gem.test_files       = `git ls-files -- spec`.split("\n")
+  gem.extra_rdoc_files = %w[TODO]
+
+  gem.add_runtime_dependency('descendants_tracker', '~> 0.0.1')
+  gem.add_runtime_dependency('concord',             '~> 0.1.0')
+  gem.add_runtime_dependency('faraday',             '~> 0.8.4')
+  gem.add_runtime_dependency('adamantium',          '~> 0.0.7')
+  gem.add_runtime_dependency('equalizer',           '~> 0.0.5')
+  gem.add_runtime_dependency('abstract_type',       '~> 0.0.5')
+  gem.add_runtime_dependency('multi_json',          '~> 1.7.2')
+  gem.add_runtime_dependency('null_logger',         '~> 0.0.1')
+end

data/lib/esearch.rb

@@ -0,0 +1,43 @@
+require 'multi_json'
+require 'faraday'
+require 'adamantium'
+require 'equalizer'
+require 'concord'
+require 'abstract_type'
+require 'null_logger'
+
+# Library namespace
+module Esearch
+  # Error raised when node signals an exception
+  class RemoteError < StandardError; end
+  # Error raised when protocol is violated
+  class ProtocolError < StandardError; end
+end
+
+require 'esearch/request'
+require 'esearch/mixin'
+require 'esearch/connection'
+require 'esearch/cluster'
+require 'esearch/type'
+require 'esearch/document'
+require 'esearch/indices'
+require 'esearch/index'
+require 'esearch/presenter'
+require 'esearch/presenter/search'
+require 'esearch/presenter/index'
+require 'esearch/presenter/document'
+require 'esearch/presenter/status'
+require 'esearch/presenter/cluster'
+require 'esearch/presenter/hit'
+require 'esearch/presenter/hits'
+require 'esearch/presenter/aspect'
+require 'esearch/presenter/aspect/term'
+require 'esearch/presenter/aspect/range'
+require 'esearch/presenter/facet'
+require 'esearch/command'
+require 'esearch/command/search'
+require 'esearch/command/status'
+require 'esearch/command/index'
+require 'esearch/command/document'
+require 'esearch/command/cluster'
+require 'esearch/command/exist'