aerospike 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f0d72ca366a1dfef80e3703e8ff0ca7577d99b2c
-  data.tar.gz: f18c8e3563d2b70041fa0d187af3917e35839ed8
+  metadata.gz: d49c7d62bc7171c98eac791bf1ff48bc19eed19e
+  data.tar.gz: 10b103d7857eff070e3a4dbf23d03df2a4f73009
 SHA512:
-  metadata.gz: 650892d7b9ed21af36a832ba0312763fe24a7cdf0acc7234729b19481c6b7f9b9218b4adb7ac6f63501e7e1c3cf40efe877bfa7ab6a3f9a5f1b23eb53227674d
-  data.tar.gz: 1502c11fb3eba7ed1ffe38fda35554808a53a831ddc2898b0f1fbbe3d088f76cbed5625bfcaafb7c38d0099c82adefb35376796e5aa09bbd2fb79ad421664e11
+  metadata.gz: 45ecde047634d1a23464184a27abaa701f742c9a6b4a29797e66d351fd1b080e3d205c797865e85dd9f70c1c239412de5214b4adfbdacaa6f5ac17048ee25a78
+  data.tar.gz: a19481a42cba1e64845a7bc98812c9ef73ff22d835a76fa3b0e815904de0574a080ae9dbcf09adbd57ca78606ac6e1743d3f56498a702e788b244f2cc6134932

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+v2.5.0 / 2017-10-10
+===================
+
+* **New Features**
+  * Support nobins flag on query operations
+  * Support CDT List Increment operation. Requires Aerospike server version 3.15 or later.
+
+* **Updates**
+  * The deprecated Large Data Types(LDT) feature has been removed.
+  * Ruby 2.1 has been removed from the client's test matrix as [official support for Ruby 2.1 has ended in Apr 2017](https://www.ruby-lang.org/en/news/2017/04/01/support-of-ruby-2-1-has-ended/). Nothing has changed in the client that would break compatibility with Ruby 2.1 yet. But compatibility is not guaranteed for future client releases.
+
 v2.4.0 / 2017-04-06
 ===================
 

data/README.md

@@ -7,7 +7,7 @@
 
 An Aerospike library for Ruby.
 
-This library is compatible with Ruby 2.1+ and supports Linux, Mac OS X and various other BSDs. Rubinius is supported, but not JRuby.
+This library is compatible with Ruby 2.2+ and supports Linux, Mac OS X and various other BSDs. Rubinius is supported, but not JRuby.
 
 - [Usage](#Usage)
 - [Prerequisites](#Prerequisites)
@@ -61,7 +61,7 @@ Details about the API are available in the [`docs`](docs) directory.
 <a name="Prerequisites"></a>
 ## Prerequisites
 
-[Ruby](https://ruby-lang.org) version v2.0+ is required.
+[Ruby](https://ruby-lang.org) version v2.2+ is required.
 
 Aerospike Ruby client implements the wire protocol, and does not depend on the C client.
 It is thread friendly.
@@ -81,7 +81,7 @@ Supported operating systems:
 
 ### Installation from source
 
-1. Install Ruby 2.0+
+1. Install Ruby 2.2+
 2. Install RubyGems
 3. Install Bundler: ```gem install bundler```
 4. Install dependencies: ```bundler install```

data/lib/aerospike.rb

@@ -84,11 +84,6 @@ require 'aerospike/cluster/partition'
 require 'aerospike/cluster/node'
 require 'aerospike/cluster/partition_tokenizer_new'
 require 'aerospike/cluster/partition_tokenizer_old'
-require 'aerospike/ldt/large_map'
-require 'aerospike/ldt/large_set'
-require 'aerospike/ldt/large_stack'
-require 'aerospike/ldt/large'
-require 'aerospike/ldt/large_list'
 require 'aerospike/info'
 require 'aerospike/udf'
 require 'aerospike/bin'

data/lib/aerospike/cdt/list_operation.rb

@@ -49,6 +49,7 @@ module Aerospike
       SET           = 9
       TRIM          = 10
       CLEAR         = 11
+      INCREMENT     = 12
       SIZE          = 16
       GET           = 17
       GET_RANGE     = 18
@@ -150,6 +151,18 @@ module Aerospike
         create_operation(Operation::CDT_MODIFY, CLEAR, bin_name)
       end
 
+      ##
+      # Create list increment operation.
+      # Server increments list[index] by value. If not specified, value defaults to 1.
+      # Server returns the value of list[index] after the operation.
+      def self.increment(bin_name, index, value = nil)
+        if value
+          create_operation(Operation::CDT_MODIFY, INCREMENT, bin_name, index, value)
+        else
+          create_operation(Operation::CDT_MODIFY, INCREMENT, bin_name, index)
+        end
+      end
+
       ##
       # Create list size operation.
       # Server returns size of list.

data/lib/aerospike/client.rb

@@ -371,49 +371,6 @@ module Aerospike
       command.record
     end
 
-    #-------------------------------------------------------------------
-    # Large collection functions (Supported by Aerospike 3 servers only)
-    #-------------------------------------------------------------------
-
-    #  Initialize large list operator.  This operator can be used to create and manage a list
-    #  within a single bin.
-    #
-    #  This method is only supported by Aerospike 3 servers.
-    def get_large_list(key, bin_name, user_module=nil, options={})
-      policy = create_policy(options, WritePolicy)
-      LargeList.new(self, policy, key, bin_name, user_module)
-    end
-
-    #  Initialize large map operator.  This operator can be used to create and manage a map
-    #  within a single bin.
-    #
-    #  This method is only supported by Aerospike 3 servers.
-    #  DEPRECATED. This method will be removed from the client in the future.
-    def get_large_map(key, bin_name, user_module=nil, options={})
-      policy = create_policy(options, WritePolicy)
-      LargeMap.new(self, policy, key, bin_name, user_module)
-    end
-
-    #  Initialize large set operator.  This operator can be used to create and manage a set
-    #  within a single bin.
-    #
-    #  This method is only supported by Aerospike 3 servers.
-    #  DEPRECATED. This method will be removed from the client in the future.
-    def get_large_set(key, bin_name, user_module=nil, options={})
-      policy = create_policy(options, WritePolicy)
-      LargeSet.new(self, policy, key, bin_name, user_module)
-    end
-
-    #  Initialize large stack operator.  This operator can be used to create and manage a stack
-    #  within a single bin.
-    #
-    #  This method is only supported by Aerospike 3 servers.
-    #  DEPRECATED. This method will be removed from the client in the future.
-    def get_large_stack(key, bin_name, user_module=nil, options={})
-      policy = create_policy(options, WritePolicy)
-      LargeStack.new(self, policy, key, bin_name, user_module)
-    end
-
     #---------------------------------------------------------------
     # User defined functions (Supported by Aerospike 3 servers only)
     #---------------------------------------------------------------

data/lib/aerospike/policy/query_policy.rb

@@ -17,14 +17,18 @@ require 'aerospike/policy/batch_policy'
 
 module Aerospike
 
-  # Container object for scan policy command.
+  # Container object for query policy command.
   class QueryPolicy < BatchPolicy
 
+    attr_accessor :include_bin_data
+
     def initialize(opt={})
       super(opt)
 
       @max_retries = 0
 
+      @include_bin_data = opt.fetch(:include_bin_data, true)
+
       self
     end
 

data/lib/aerospike/query/query_command.rb

@@ -116,7 +116,7 @@ module Aerospike
 
       size_buffer
 
-      readAttr = INFO1_READ
+      readAttr = @policy.include_bin_data ? INFO1_READ : INFO1_READ | INFO1_NOBINDATA
       operation_count = (@statement.filters.to_a.length == 0 && @statement.bin_names.to_a.length == 0) ? @statement.bin_names.length : 0
 
       write_header(@policy, readAttr, 0, fieldCount, operation_count)

data/lib/aerospike/version.rb

@@ -1,4 +1,4 @@
 # encoding: utf-8
 module Aerospike
-  VERSION = "2.4.0"
+  VERSION = "2.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aerospike
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Khosrow Afroozeh
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-06 00:00:00.000000000 Z
+date: 2017-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: msgpack
@@ -93,11 +93,6 @@ files:
 - lib/aerospike/info.rb
 - lib/aerospike/key.rb
 - lib/aerospike/language.rb
-- lib/aerospike/ldt/large.rb
-- lib/aerospike/ldt/large_list.rb
-- lib/aerospike/ldt/large_map.rb
-- lib/aerospike/ldt/large_set.rb
-- lib/aerospike/ldt/large_stack.rb
 - lib/aerospike/loggable.rb
 - lib/aerospike/operation.rb
 - lib/aerospike/policy/admin_policy.rb
@@ -151,7 +146,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: 2.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/aerospike/ldt/large.rb

@@ -1,57 +0,0 @@
-# encoding: utf-8
-# Copyright 2014-2017 Aerospike, Inc.
-#
-# Portions may be licensed to Aerospike, Inc. under one or more contributor
-# license agreements.
-#
-# Licensed under the Apache License, Version 2.0 (the 'License'); you may not
-# use this file except in compliance with the License. You may obtain a copy of
-# the License at http:#www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations under
-# the License.
-
-require 'aerospike/value/particle_type'
-
-module Aerospike
-
-  private
-
-  class Large
-
-    def initialize(client, policy, key, bin_name, user_module=nil)
-      @client = client
-      @policy = policy
-      @key = key
-      @bin_name = bin_name
-      @user_module = user_module unless user_module.nil?
-
-      self
-    end
-
-    # Delete bin containing the object.
-    def destroy
-      @client.execute_udf(@key, @PACKAGE_NAME, 'destroy', [@bin_name], @policy)
-    end
-
-    # Return size of object.
-    def size
-      @client.execute_udf(@key, @PACKAGE_NAME, 'size', [@bin_name], @policy)
-    end
-
-    # Return map of object configuration parameters.
-    def config
-      @client.execute_udf(@key, @PACKAGE_NAME, 'get_config', [@bin_name], @policy)
-    end
-
-    # Return list of all objects on the stack.
-    def scan
-      @client.execute_udf(@key, @PACKAGE_NAME, 'scan', [@bin_name], @policy)
-    end
-
-  end # class
-
-end #class

data/lib/aerospike/ldt/large_list.rb

@@ -1,101 +0,0 @@
-# encoding: utf-8
-# Copyright 2014-2017 Aerospike, Inc.
-#
-# Portions may be licensed to Aerospike, Inc. under one or more contributor
-# license agreements.
-#
-# Licensed under the Apache License, Version 2.0 (the 'License'); you may not
-# use this file except in compliance with the License. You may obtain a copy of
-# the License at http:#www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations under
-# the License.
-
-require 'aerospike/ldt/large'
-
-module Aerospike
-
-  private
-
-  class LargeList < Large
-
-    def initialize(client, policy, key, bin_name, user_module=nil)
-      @PACKAGE_NAME = 'llist'
-
-      super(client, policy, key, bin_name, user_module)
-
-      self
-    end
-
-    # Add values to the list.  If the list does not exist, create it using specified user_module configuration.
-    #
-    # values      values to add
-    def add(*values)
-      if values.length == 1
-        @client.execute_udf(@key, @PACKAGE_NAME, 'add', [@bin_name, values[0], @user_module], @policy)
-      else
-        @client.execute_udf(@key, @PACKAGE_NAME, 'add_all', [@bin_name, values, @user_module], @policy)
-      end
-    end
-
-    # Update/Add each value in array depending if key exists or not.
-    # If value is a map, the key is identified by "key" entry.  Otherwise, the value is the key.
-    # If large list does not exist, create it using specified user_module configuration.
-    #
-    # values      values to update
-    def update(*values)
-      if values.length == 1
-        @client.execute_udf(@key, @PACKAGE_NAME, 'update', [@bin_name, values[0], @user_module], @policy)
-      else
-        @client.execute_udf(@key, @PACKAGE_NAME, 'update_all', [@bin_name, values, @user_module], @policy)
-      end
-    end
-
-    # Delete value from list.
-    #
-    # value       value to delete
-    def remove(value)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'remove', [@bin_name, value], @policy)
-    end
-
-    # Select values from list.
-    #
-    # value       value to select
-    # returns          list of entries selected
-    def find(value)
-      begin
-        @client.execute_udf(@key, @PACKAGE_NAME, 'find', [@bin_name, value], @policy)
-      rescue Aerospike::Exceptions::Aerospike => e
-        unless e.result_code == Aerospike::ResultCode::UDF_BAD_RESPONSE && e.message.index("Item Not Found")
-          Aerospike.logger.error(e)
-          raise e
-        end
-        nil
-      end
-    end
-
-    # Select values from list and apply specified Lua filter.
-    #
-    # value       value to select
-    # filter_name    Lua function name which applies filter to returned list
-    # filter_args    arguments to Lua function name
-    # returns          list of entries selected
-    def find_then_filter(value, filter_name, *filter_args)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'find_then_filter', [@bin_name, value, @user_module, filter_name, filter_args], @policy)
-    end
-
-    # Select values from list and apply specified Lua filter.
-    #
-    # filter_name    Lua function name which applies filter to returned list
-    # filter_args    arguments to Lua function name
-    # returns          list of entries selected
-    def filter(filter_name, *filter_args)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'filter', [@bin_name, @user_module, filter_name, filter_args], @policy)
-    end
-
-  end # class
-
-end #class

data/lib/aerospike/ldt/large_map.rb

@@ -1,91 +0,0 @@
-# encoding: utf-8
-# Copyright 2014-2017 Aerospike, Inc.
-#
-# Portions may be licensed to Aerospike, Inc. under one or more contributor
-# license agreements.
-#
-# Licensed under the Apache License, Version 2.0 (the 'License'); you may not
-# use this file except in compliance with the License. You may obtain a copy of
-# the License at http:#www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations under
-# the License.
-
-##############################################################
-#
-# NOTICE:
-#      THIS FEATURE HAS BEEN DEPRECATED ON SERVER.
-#      THE API WILL BE REMOVED FROM THE CLIENT IN THE FUTURE.
-#
-##############################################################
-
-require 'aerospike/ldt/large'
-
-module Aerospike
-
-  private
-
-  class LargeMap < Large
-
-    def initialize(client, policy, key, bin_name, user_module=nil)
-      @PACKAGE_NAME = 'lmap'
-
-      super(client, policy, key, bin_name, user_module)
-
-      self
-    end
-
-    # Add entry to map.  If the map does not exist, create it using specified user_module configuration.
-    #
-    # name        entry key
-    # value       entry value
-    def put(name, value)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'put', [@bin_name, name, value, @user_module], @policy)
-    end
-
-    # Add map values to map.  If the map does not exist, create it using specified user_module configuration.
-    #
-    # map       map values to push
-    def put_map(the_map)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'put_all', [@bin_name, the_map, @user_module], @policy)
-    end
-
-    # Get value from map given name key.
-    #
-    # name        key.
-    # return          map of items selected
-    def get(name)
-      begin
-        @client.execute_udf(@key, @PACKAGE_NAME, 'get', [@bin_name, name, @user_module], @policy)
-      rescue Aerospike::Exceptions::Aerospike => e
-        unless e.result_code == Aerospike::ResultCode::UDF_BAD_RESPONSE && e.message.index("Item Not Found")
-          Aerospike.logger.error(e)
-          raise e
-        end
-        nil
-      end
-    end
-
-    # Get value from map given name key.
-    #
-    # name        key.
-    # return          map of items selected
-    def remove(name)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'remove', [@bin_name, name, @user_module], @policy)
-    end
-
-    # Select items from map.
-    #
-    # filter_name    Lua function name which applies filter to returned list
-    # filter_args    arguments to Lua function name
-    # return          list of items selected
-    def filter(filter_name, *filter_args)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'filter', [@bin_name, @user_module, filter_name, filter_args], @policy)
-    end
-
-  end # class
-
-end #class

data/lib/aerospike/ldt/large_set.rb

@@ -1,86 +0,0 @@
-# encoding: utf-8
-# Copyright 2014-2017 Aerospike, Inc.
-#
-# Portions may be licensed to Aerospike, Inc. under one or more contributor
-# license agreements.
-#
-# Licensed under the Apache License, Version 2.0 (the 'License'); you may not
-# use this file except in compliance with the License. You may obtain a copy of
-# the License at http:#www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations under
-# the License.
-
-##############################################################
-#
-# NOTICE:
-#      THIS FEATURE HAS BEEN DEPRECATED ON SERVER.
-#      THE API WILL BE REMOVED FROM THE CLIENT IN THE FUTURE.
-#
-##############################################################
-
-require 'aerospike/ldt/large'
-
-module Aerospike
-
-  private
-
-  class LargeSet < Large
-
-    def initialize(client, policy, key, bin_name, user_module=nil)
-      @PACKAGE_NAME = 'lset'
-
-      super(client, policy, key, bin_name, user_module)
-
-      self
-    end
-
-    # Add values to the list.  If the list does not exist, create it using specified user_module configuration.
-    #
-    # values      values to add
-    def add(*values)
-      if values.length == 1
-        @client.execute_udf(@key, @PACKAGE_NAME, 'add', [@bin_name, values[0], @user_module], @policy)
-      else
-        @client.execute_udf(@key, @PACKAGE_NAME, 'add_all', [@bin_name, values, @user_module], @policy)
-      end
-    end
-
-    # Delete value from list.
-    #
-    # value       value to delete
-    def remove(value)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'remove', [@bin_name, value], @policy)
-    end
-
-    # Select values from list.
-    #
-    # value       value to select
-    # returns          list of entries selected
-    def get(value)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'get', [@bin_name, value], @policy)
-    end
-
-    # Check existence of value in the set.
-    #
-    # value       value to check
-    # returns          true if found, otherwise false
-    def exists(value)
-      1 == @client.execute_udf(@key, @PACKAGE_NAME, 'exists', [@bin_name, value], @policy)
-    end
-
-    # Select values from list and apply specified Lua filter.
-    #
-    # filter_name    Lua function name which applies filter to returned list
-    # filter_args    arguments to Lua function name
-    # returns          list of entries selected
-    def filter(filter_name, *filter_args)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'filter', [@bin_name, @user_module, filter_name, filter_args], @policy)
-    end
-
-  end # class
-
-end #class

data/lib/aerospike/ldt/large_stack.rb

@@ -1,80 +0,0 @@
-# encoding: utf-8
-# Copyright 2014-2017 Aerospike, Inc.
-#
-# Portions may be licensed to Aerospike, Inc. under one or more contributor
-# license agreements.
-#
-# Licensed under the Apache License, Version 2.0 (the 'License'); you may not
-# use this file except in compliance with the License. You may obtain a copy of
-# the License at http:#www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations under
-# the License.
-
-##############################################################
-#
-# NOTICE:
-#      THIS FEATURE HAS BEEN DEPRECATED ON SERVER.
-#      THE API WILL BE REMOVED FROM THE CLIENT IN THE FUTURE.
-#
-##############################################################
-
-require 'aerospike/ldt/large'
-
-module Aerospike
-
-  private
-
-  class LargeStack < Large
-
-    def initialize(client, policy, key, bin_name, user_module=nil)
-      @PACKAGE_NAME = 'lstack'
-
-      super(client, policy, key, bin_name, user_module)
-
-      self
-    end
-
-    # Push values onto stack.  If the stack does not exist, create it using specified user_module configuration.
-    #
-    # values      values to push
-    def push(*values)
-      if values.length == 1
-        @client.execute_udf(@key, @PACKAGE_NAME, 'push', [@bin_name, values[0], @user_module], @policy)
-      else
-        @client.execute_udf(@key, @PACKAGE_NAME, 'push_all', [@bin_name, values, @user_module], @policy)
-      end
-    end
-
-    # Select items from top of stack.
-    #
-    # peek_count     number of items to select.
-    # returns          list of items selected
-    def peek(peek_count)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'peek', [@bin_name, peek_count], @policy)
-    end
-
-    # Select items from top of stack.
-    #
-    # peek_count     number of items to select.
-    # returns          list of items selected
-    def pop(count)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'pop', [@bin_name, count], @policy)
-    end
-
-    # Select items from top of stack.
-    #
-    # peek_count     number of items to select.
-    # filter_name    Lua function name which applies filter to returned list
-    # filter_args    arguments to Lua function name
-    # returns          list of items selected
-    def filter(peek_count, filter_name, *filter_args)
-      @client.execute_udf(@key, @PACKAGE_NAME, 'filter', [@bin_name, peek_count, @user_module, filter_name, filter_args], @policy)
-    end
-
-  end # class
-
-end #class