aerospike 2.7.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2351767e50e34f9aec1da0eb58c6d5fb5b8a39f83d3aa2d2f9c88ed5d446b15a
-  data.tar.gz: 7104f9494a571dcf34a4809f0e4331acc76981649a53df06dd5f5c3ceddbcd0d
+  metadata.gz: 604462bd062c1fea97323684cfe3512a962e52c69b651e6ee86251a22769fcf0
+  data.tar.gz: 6d62d86f30470b07daaa46cfef8188addd558d60be17c0e5398e6fef772ef37f
 SHA512:
-  metadata.gz: a48674b7bf187a0660d0a2b0e9c070f1b9f270d31dda522a2264cb2821470c193d2714944f35e4c65c2f05ee06fc299894d4721e348b8c986d5124f8d95ae2ef
-  data.tar.gz: febaffccf38b34e5b6653ce078630eacf73fead0d2cd840d09a87016a3adc3a8ff26a00460031a18d52d8a3bda6e9def1c7259917291f79857e020212812ebb1
+  metadata.gz: 631961c7e7d06bdaeeb8aeb456fe02c52b000f28ae4f0293ace79842dc9d1ccf83c478b06826b11d939b60663cc844183e32b1d5b3b41b925035e007d9fdec5f
+  data.tar.gz: c5f5e285521e445d35c2723a1849d2072dcbd72223998b3f5559d0bc7eac563917be43d8c1ec9dbc81e04a65fd537502bede46df7808e10bd8d63f3a5ce93d78

data/CHANGELOG.md

@@ -1,5 +1,26 @@
-v2.7.0 / 2018-04-12
-===================
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+## [2.8.0] - 2018-08-06
+
+* **New Features**
+  * Support latest CDT List/Map server-side operations: [[#69](https://github.com/aerospike/aerospike-client-ruby/pull/69)]
+    * Operations on Ordered Lists & Bounded Lists via new List Policy. (Requires server version v3.16.0 or later.)
+    * Option to invert selection criteria for certain List/Map get/remove operations. (Requires server version v3.16.0 or later.)
+    * List/Map index/rank relative get/remove operations. (Requires server version v4.3.0 or later.)
+    * Partial list/map updates using PARTIAL / NO_FAIL write flags. (Requires server version v4.3.0 or later.)
+  * Benchmarks: Output total TPS metrics at end of run [[#71](https://github.com/aerospike/aerospike-client-ruby/pull/71)]
+
+* **Bug Fixes**
+  * Check connection status of sockets retrieved from connection pool [[#72](https://github.com/aerospike/aerospike-client-ruby/pull/72)]
+
+* **Updates**
+  * Add JRuby back to CI test matrix [[#70](https://github.com/aerospike/aerospike-client-ruby/pull/70)]
+
+## [2.7.0] - 2018-04-12
 
 * **New Features**
   * Batch Index protocol support. Thanks to [@deenbandhu-agarwal](https://github.com/deenbandhu-agarwal)! [[#61](https://github.com/aerospike/aerospike-client-ruby/pull/61)]
@@ -7,8 +28,7 @@ v2.7.0 / 2018-04-12
   * New node removal strategy. Thanks to [@wallin](https://github.com/wallin)! [[#63](https://github.com/aerospike/aerospike-client-ruby/pull/63)]
   * Support for IPv6. Requires Aerospike Enterprise Edition v3.10 or later. Thanks to [@wallin](https://github.com/wallin)! [[#65](https://github.com/aerospike/aerospike-client-ruby/pull/65)]
 
-v2.6.0 / 2018-03-27
-===================
+## [2.6.0] - 2018-03-27
 
 * **New Features**
   * Support for peers protocol for cluster discovery. Requires Aerospike server version 3.10 or later. Thanks to [@wallin](https://github.com/wallin) of [castle.io](https://castle.io/)! [[#59](https://github.com/aerospike/aerospike-client-ruby/pull/59)]
@@ -20,8 +40,7 @@ v2.6.0 / 2018-03-27
 * **Updates**
   * Update minimum required Ruby version to v2.3.
 
-v2.5.1 / 2018-01-25
-===================
+## [2.5.1] - 2018-01-25
 
 * **Bug Fixes**
   * Some secondary index queries fail with parameter error on Aerospike Server v3.15.1.x [#57](https://github.com/aerospike/aerospike-client-ruby/issues/57)
@@ -30,8 +49,7 @@ v2.5.1 / 2018-01-25
   * Added Ruby 2.5 to test matrix
   * Updated documentation for Client#truncate command [CLIENT-985]
 
-v2.5.0 / 2017-10-10
-===================
+## [2.5.0] - 2017-10-10
 
 * **New Features**
   * Support nobins flag on query operations
@@ -41,8 +59,7 @@ v2.5.0 / 2017-10-10
   * 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
-===================
+## [2.4.0] - 2017-04-06
 
 * **New Features**
   * Support ns/set truncate command [#47](https://github.com/aerospike/aerospike-client-ruby/issues/47)
@@ -54,8 +71,7 @@ v2.4.0 / 2017-04-06
 * **Updates**
   * Ruby 2.0 has been removed from the client's test matrix as [official support for Ruby 2.0 has ended in Feb 2016](https://www.ruby-lang.org/en/news/2016/02/24/support-plan-of-ruby-2-0-0-and-2-1/). Nothing has changed in the client that would break compatibility with Ruby 2.0 yet. But compatibility is not guaranteed for future client releases. [#52](https://github.com/aerospike/aerospike-client-ruby/pull/52)
 
-v2.3.0 / 2017-01-04
-===================
+## [2.3.0] - 2017-01-04
 
 * **Bug Fixes**
   * Fix BytesValue used as record key. [#42](https://github.com/aerospike/aerospike-client-ruby/issues/42)
@@ -63,8 +79,7 @@ v2.3.0 / 2017-01-04
 * **Changes**
   * Deprecate unsupport key types - only integer, string and byte keys are supported. [#43](https://github.com/aerospike/aerospike-client-ruby/issues/43)
 
-v2.2.1 / 2016-11-14
-===================
+## [2.2.1] - 2016-11-14
 
 * **New Features**
   * Added constants `Aerospike::TTL::*` for "special" TTL values, incl. Aerospike::TTL::DONT_UPDATE (requires Aerospike Server v3.10.1 or later)
@@ -72,8 +87,7 @@ v2.2.1 / 2016-11-14
 * **Bug Fixes**
   * Fix "Add node failed: wrong number of arguments". [#41](https://github.com/aerospike/aerospike-client-ruby/issues/41)
 
-v2.2.0 / 2016-09-20
-===================
+## [2.2.0] - 2016-09-20
 
 * **New Features**
   * Support for durable delete write policy [CLIENT-768]; requires Aerospike
@@ -92,8 +106,7 @@ v2.2.0 / 2016-09-20
   * Added note about potential issues with usage in Ruby on Rails with Phusion Passenger.
   * Amend/clean up documentation of client policies.
 
-v2.1.1 / 2016-08-16
-===================
+## [2.1.1] - 2016-08-16
 
 * **Bug Fixes**
   * Fix incorrect expiration times on records fetched via batch_get or query operations. [#38](https://github.com/aerospike/aerospike-client-ruby/issues/38)
@@ -102,8 +115,7 @@ v2.1.1 / 2016-08-16
   * Add support for two new server error codes (23 & 24) introduced in Aerospike Server v3.9.1.
   * Records returned by batch_get operation should include the full key incl. the user key part.
 
-v2.1.0 / 2016-07-19
-===================
+## [2.1.0] - 2016-07-19
 
 * **Fixes**
   * Fix a typo in the `max_retries` policy parameter name. [PR #37](https://github.com/aerospike/aerospike-client-ruby/pull/37) Thanks to [@murphyslaw](https://github.com/murphyslaw)!
@@ -114,8 +126,7 @@ v2.1.0 / 2016-07-19
   * Support for creating indexes on Lists and Maps [CLIENT-685]
   * Support GeoJSON values in Lists and Maps
 
-v2.0.0 / 2016-05-27
-===================
+## [2.0.0] - 2016-05-27
 
 * **Breaking Changes** - Please refer to detailed list of [API changes](docs/api-changes.md#v2.0.0) for further details.
   * Incompatible integer key digests: digests for integer keys computed by v2 and v1 are different; the Aerospike server uses the key digest to retrieve records. This will impact your ability to read records with integer keys that were created by a v1 client version.
@@ -132,8 +143,7 @@ v2.0.0 / 2016-05-27
   * Fix digest creation for integer keys. [PR #34](https://github.com/aerospike/aerospike-client-ruby/pull/34). Thanks to [@murphyslaw](https://github.com/murphyslaw)!
   * Prevent "value must be enumerable" error when client cannot connect to cluster. [#35](https://github.com/aerospike/aerospike-client-ruby/issues/35). Thanks to [@rohanthewiz](https://github.com/rohanthewiz)!
 
-1.0.12 / 2016-02-11
-===================
+## [1.0.12] - 2016-02-11
 
 * **Fixes**:
 
@@ -144,8 +154,7 @@ v2.0.0 / 2016-05-27
     bins; thanks to [fs-wu](https://github.com/fs-wu) for finding the issue and
     reporting it. [aerospike/aerospike-client-ruby#33]
 
-1.0.11 / 2015-12-04
-===================
+## [1.0.11] - 2015-12-04
 
   Major feature and bug fix release.
 
@@ -174,8 +183,7 @@ v2.0.0 / 2016-05-27
 
     * Scan and Query termination has been fixed.
 
-1.0.10 / 2015-09-22
-===================
+## [1.0.10] - 2015-09-22
 
   Major fix release.
 
@@ -187,8 +195,7 @@ v2.0.0 / 2016-05-27
 
     * Fixes an issue with dead connections that would cause an infinite loop.
 
-1.0.9 / 2015-08-11
-==================
+## [1.0.9] - 2015-08-11
 
   Minor fix release.
 
@@ -196,8 +203,7 @@ v2.0.0 / 2016-05-27
 
     * Sends the original key value to the server for all relevant commands, including `operate` and `execute_udf`
 
-1.0.8 / 2015-07-23
-==================
+## [1.0.8] - 2015-07-23
 
   Minor fix release.
 
@@ -213,8 +219,7 @@ v2.0.0 / 2016-05-27
 
     * Fixes an issue with including the `statement.rb` in the manifest. Thanks to [Ángel M](https://github.com/Angelmmiguel)
 
-1.0.7 / 2015-05-15
-==================
+## [1.0.7] - 2015-05-15
 
   Minor fixes.
 
@@ -234,8 +239,7 @@ v2.0.0 / 2016-05-27
 
     * Removed deprecated `SetCapacity()` and `GetCapacity()` methods for LDTs.
 
-1.0.6 / 2015-04-02
-==================
+## [1.0.6] - 2015-04-02
 
   Minor fixes.
 
@@ -243,8 +247,7 @@ v2.0.0 / 2016-05-27
 
     * Fixed running a stream query without parameters to the function.
 
-1.0.5 / 2015-03-25
-==================
+## [1.0.5] - 2015-03-25
 
   Minor improvements.
 
@@ -252,8 +255,7 @@ v2.0.0 / 2016-05-27
 
     * Added `:execute_udf_on_query` method to `Aerospike::Client`
 
-1.0.4 / 2015-03-24
-==================
+## [1.0.4] - 2015-03-24
 
   Hot fix.
 
@@ -261,8 +263,7 @@ v2.0.0 / 2016-05-27
 
     * Close a socket if connection raises an exception to avoid leaking the file descriptor.
 
-1.0.3 / 2015-03-24
-==================
+## [1.0.3] - 2015-03-24
 
   Minor fixes and improvements.
 
@@ -275,8 +276,7 @@ v2.0.0 / 2016-05-27
     * Wait for a good connection on `socket.connect_nonblock` to prevent infinite loops on read/write operations.
 
 
-1.0.2 / 2015-03-14
-==================
+## [1.0.2] - 2015-03-14
 
   Minor improvements.
 
@@ -284,8 +284,7 @@ v2.0.0 / 2016-05-27
 
     * Added `:new_many` method to `Aerospike::Client`
 
-1.0.1 / 2015-01-28
-==================
+## [1.0.1] - 2015-01-28
 
   Hot fix.
 
@@ -293,8 +292,7 @@ v2.0.0 / 2016-05-27
 
     * Added `bcrypt` to the gem dependencies.
 
-1.0.0 / 2015-01-26
-==================
+## [1.0.0] - 2015-01-26
 
   Major release. With this release, Ruby client graduates to version 1.
 
@@ -316,8 +314,7 @@ v2.0.0 / 2016-05-27
 
     * fixed size returned from `BytesValue.write`
 
-0.1.6 / 2014-12-28
-==================
+## [0.1.6] - 2014-12-28
 
   Minor features added, minor fixes and improvements.
 
@@ -331,8 +328,7 @@ v2.0.0 / 2016-05-27
     * Fixed setting timeout on connection
     * Fixed exception handling typo for Connection#write
 
-0.1.5 / 2014-12-08
-==================
+## [0.1.5] - 2014-12-08
 
   Major features added, minor fixes and improvements.
 
@@ -345,8 +341,7 @@ v2.0.0 / 2016-05-27
 
     * Fixed getting back results only for specified bin names.
 
-0.1.3 / 2014-10-27
-==================
+## [0.1.3] - 2014-10-27
 
   Minor fix.
 
@@ -354,8 +349,7 @@ v2.0.0 / 2016-05-27
 
     * Fixed LDT bin and module name packing.
 
-0.1.2 / 2014-10-25
-==================
+## [0.1.2] - 2014-10-25
 
   Minor fix.
 
@@ -363,8 +357,7 @@ v2.0.0 / 2016-05-27
 
     * Fixed String unpacking for single byte strings.
 
-0.1.1 / 2014-10-25
-==================
+## [0.1.1] - 2014-10-25
 
   Minor fixes.
 
@@ -373,7 +366,6 @@ v2.0.0 / 2016-05-27
     * Fixed String packing header in Hash and Array.
     * #find on LDTs returns `nil` instad of raising an exception if the item is not found.
 
-0.1.0 / 2014-10-14
-==================
+## [0.1.0] - 2014-10-14
 
   * Initial Release.

data/lib/aerospike.rb

@@ -27,6 +27,7 @@ require 'aerospike/atomic/atomic'
 
 require 'aerospike/client'
 require 'aerospike/utils/pool'
+require 'aerospike/utils/connection_pool'
 require 'aerospike/utils/packer'
 require 'aerospike/utils/unpacker'
 require 'aerospike/utils/buffer'
@@ -63,9 +64,15 @@ require 'aerospike/command/unsupported_particle_type_validator'
 require 'aerospike/key'
 require 'aerospike/operation'
 require 'aerospike/cdt/list_operation'
+require 'aerospike/cdt/list_order'
+require 'aerospike/cdt/list_return_type'
+require 'aerospike/cdt/list_sort_flags'
+require 'aerospike/cdt/list_write_flags'
+require 'aerospike/cdt/list_policy'
 require 'aerospike/cdt/map_operation'
 require 'aerospike/cdt/map_order'
 require 'aerospike/cdt/map_return_type'
+require 'aerospike/cdt/map_write_flags'
 require 'aerospike/cdt/map_write_mode'
 require 'aerospike/cdt/map_policy'
 require 'aerospike/geo_json'

data/lib/aerospike/cdt/list_operation.rb

@@ -1,12 +1,15 @@
-# encoding: utf-8
-# Copyright 2016-2017 Aerospike, Inc.
+# frozen_string_literal: true
+
+# Copyright 2016-2018 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
+# 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
@@ -36,33 +39,70 @@ module Aerospike
     # range is partially out of bounds, the valid part of the range will be
     # returned.
 
-    class ListOperation
-
-      APPEND        = 1
-      APPEND_ITEMS  = 2
-      INSERT        = 3
-      INSERT_ITEMS  = 4
-      POP           = 5
-      POP_RANGE     = 6
-      REMOVE        = 7
-      REMOVE_RANGE  = 8
-      SET           = 9
-      TRIM          = 10
-      CLEAR         = 11
-      INCREMENT     = 12
-      SIZE          = 16
-      GET           = 17
-      GET_RANGE     = 18
+    class ListOperation < Operation
+
+      SET_TYPE = 0
+      APPEND = 1
+      APPEND_ITEMS = 2
+      INSERT = 3
+      INSERT_ITEMS = 4
+      POP = 5
+      POP_RANGE = 6
+      REMOVE = 7
+      REMOVE_RANGE = 8
+      SET = 9
+      TRIM = 10
+      CLEAR = 11
+      INCREMENT = 12
+      SORT = 13
+      SIZE = 16
+      GET = 17
+      GET_RANGE = 18
+      GET_BY_INDEX = 19
+      GET_BY_RANK = 21
+      GET_BY_VALUE = 22
+      GET_BY_VALUE_LIST = 23
+      GET_BY_INDEX_RANGE = 24
+      GET_BY_VALUE_INTERVAL = 25
+      GET_BY_RANK_RANGE = 26
+      GET_BY_VALUE_REL_RANK_RANGE = 27
+      REMOVE_BY_INDEX = 32
+      REMOVE_BY_RANK = 34
+      REMOVE_BY_VALUE = 35
+      REMOVE_BY_VALUE_LIST = 36
+      REMOVE_BY_INDEX_RANGE = 37
+      REMOVE_BY_VALUE_INTERVAL = 38
+      REMOVE_BY_RANK_RANGE = 39
+      REMOVE_BY_VALUE_REL_RANK_RANGE = 40
+
+      attr_reader :list_op, :arguments, :policy, :return_type
+
+      def initialize(op_type, list_op, bin_name, *arguments, return_type: nil)
+        @op_type = op_type
+        @bin_name = bin_name
+        @bin_value = nil
+        @list_op = list_op
+        @arguments = arguments
+        @return_type = return_type
+      end
+
+      ##
+      #  Create a set list order operation.
+      #  Server sets list order.
+      #  Server returns null.
+      def self.set_order(bin_name, order)
+        ListOperation.new(Operation::CDT_MODIFY, SET_TYPE, bin_name, order)
+      end
 
       ##
       #  Create list append operation.
       #  Server appends value(s) to end of the list bin.
       #  Server returns list size.
-      def self.append(bin_name, *values)
+      def self.append(bin_name, *values, policy: ListPolicy::DEFAULT)
         if values.length > 1
-          create_operation(Operation::CDT_MODIFY, APPEND_ITEMS, bin_name, values)
+          ListOperation.new(Operation::CDT_MODIFY, APPEND_ITEMS, bin_name, values, policy.order, policy.flags)
         else
-          create_operation(Operation::CDT_MODIFY, APPEND, bin_name, values.first)
+          ListOperation.new(Operation::CDT_MODIFY, APPEND, bin_name, values.first, policy.order, policy.flags)
         end
       end
 
@@ -70,11 +110,11 @@ module Aerospike
       #  Create list insert operation.
       #  Server inserts value(s) at the specified index of the list bin.
       #  Server returns list size.
-      def self.insert(bin_name, index, *values)
+      def self.insert(bin_name, index, *values, policy: ListPolicy::DEFAULT)
         if values.length > 1
-          create_operation(Operation::CDT_MODIFY, INSERT_ITEMS, bin_name, index, values)
+          ListOperation.new(Operation::CDT_MODIFY, INSERT_ITEMS, bin_name, index, values, policy.flags)
         else
-          create_operation(Operation::CDT_MODIFY, INSERT, bin_name, index, values.first)
+          ListOperation.new(Operation::CDT_MODIFY, INSERT, bin_name, index, values.first, policy.flags)
         end
       end
 
@@ -82,7 +122,7 @@ module Aerospike
       # Create list pop operation.
       # Server returns item at specified index and removes item from list bin.
       def self.pop(bin_name, index)
-        create_operation(Operation::CDT_MODIFY, POP, bin_name, index)
+        ListOperation.new(Operation::CDT_MODIFY, POP, bin_name, index)
       end
 
       ##
@@ -93,9 +133,9 @@ module Aerospike
       # removes those items from the list bin.
       def self.pop_range(bin_name, index, count=nil)
         if count
-          create_operation(Operation::CDT_MODIFY, POP_RANGE, bin_name, index, count)
+          ListOperation.new(Operation::CDT_MODIFY, POP_RANGE, bin_name, index, count)
         else
-          create_operation(Operation::CDT_MODIFY, POP_RANGE, bin_name, index)
+          ListOperation.new(Operation::CDT_MODIFY, POP_RANGE, bin_name, index)
         end
       end
 
@@ -104,7 +144,7 @@ module Aerospike
       # Server removes item at specified index from list bin.
       # Server returns number of items removed.
       def self.remove(bin_name, index)
-        create_operation(Operation::CDT_MODIFY, REMOVE, bin_name, index)
+        ListOperation.new(Operation::CDT_MODIFY, REMOVE, bin_name, index)
       end
 
       ##
@@ -115,9 +155,9 @@ module Aerospike
       # Server returns number of items removed.
       def self.remove_range(bin_name, index, count=nil)
         if count
-          create_operation(Operation::CDT_MODIFY, REMOVE_RANGE, bin_name, index, count)
+          ListOperation.new(Operation::CDT_MODIFY, REMOVE_RANGE, bin_name, index, count)
         else
-          create_operation(Operation::CDT_MODIFY, REMOVE_RANGE, bin_name, index)
+          ListOperation.new(Operation::CDT_MODIFY, REMOVE_RANGE, bin_name, index)
         end
       end
 
@@ -125,22 +165,19 @@ module Aerospike
       # Create list set operation.
       # Server sets item value at specified index in list bin.
       # Server does not return a result by default.
-      def self.set(bin_name, index, value)
-        create_operation(Operation::CDT_MODIFY, SET, bin_name, index, value)
+      def self.set(bin_name, index, value, policy: ListPolicy::DEFAULT)
+        ListOperation.new(Operation::CDT_MODIFY, SET, bin_name, index, value, policy.flags)
       end
 
       ##
       # Create list trim operation.
+      #
       # Server removes items in list bin that do not fall into range specified
-      # by index and count. If count is not specified, server will keep all
-      # items starting at the specified index to the end of the list.
+      # by index and count.
+      #
       # Server returns number of items removed.
-      def self.trim(bin_name, index, count=nil)
-        if count
-          create_operation(Operation::CDT_MODIFY, TRIM, bin_name, index, count)
-        else
-          create_operation(Operation::CDT_MODIFY, TRIM, bin_name, index)
-        end
+      def self.trim(bin_name, index, count)
+        ListOperation.new(Operation::CDT_MODIFY, TRIM, bin_name, index, count)
       end
 
       ##
@@ -148,33 +185,37 @@ module Aerospike
       # Server removes all items in the list bin.
       # Server does not return a result by default.
       def self.clear(bin_name)
-        create_operation(Operation::CDT_MODIFY, CLEAR, bin_name)
+        ListOperation.new(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
+      def self.increment(bin_name, index, value = 1, policy: ListPolicy::DEFAULT)
+        ListOperation.new(Operation::CDT_MODIFY, INCREMENT, bin_name, index, value, policy.order, policy.flags)
+      end
+
+      ##
+      # Create list sort operation.
+      # Server sorts list according to sort_flags.
+      # Server does not return a result by default.
+      def self.sort(bin_name, sort_flags = ListSortFlags::DEFAULT)
+        ListOperation.new(Operation::CDT_MODIFY, SORT, bin_name, sort_flags)
       end
 
       ##
       # Create list size operation.
       # Server returns size of list.
       def self.size(bin_name)
-        create_operation(Operation::CDT_READ, SIZE, bin_name)
+        ListOperation.new(Operation::CDT_READ, SIZE, bin_name)
       end
 
       ##
       # Create list get operation.
       # Server returns the item at the specified index in the list bin.
       def self.get(bin_name, index)
-        create_operation(Operation::CDT_READ, GET, bin_name, index)
+        ListOperation.new(Operation::CDT_READ, GET, bin_name, index)
       end
 
       ##
@@ -184,18 +225,270 @@ module Aerospike
       # starting at the specified index to the end of the list.
       def self.get_range(bin_name, index, count=nil)
         if count
-          create_operation(Operation::CDT_READ, GET_RANGE, bin_name, index, count)
+          ListOperation.new(Operation::CDT_READ, GET_RANGE, bin_name, index, count)
+        else
+          ListOperation.new(Operation::CDT_READ, GET_RANGE, bin_name, index)
+        end
+      end
+
+      # Create list get by index operation.
+      #
+      # Server selects list item identified by index.
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_index(bin_name, index, return_type: ListReturnType::NONE)
+        ListOperation.new(Operation::CDT_READ, GET_BY_INDEX, bin_name, index, return_type: return_type)
+      end
+
+      # Create list get by index range operation.
+      #
+      # Server selects list item identified by index range
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_index_range(bin_name, index, count=nil, return_type: ListReturnType::NONE)
+        if count
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_INDEX_RANGE, bin_name, index, count, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_INDEX_RANGE, bin_name, index, return_type: return_type)
+        end
+      end
+
+      # Create list get by rank operation.
+      #
+      # Server selects list item identified by rank.
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_rank(bin_name, rank, return_type: ListReturnType::NONE)
+        ListOperation.new(Operation::CDT_READ, GET_BY_RANK, bin_name, rank, return_type: return_type)
+      end
+
+      # Create list get by rank range operation.
+      #
+      # Server selects list item identified by rank range.
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_rank_range(bin_name, rank, count=nil, return_type: ListReturnType::NONE)
+        if count
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_RANK_RANGE, bin_name, rank, count, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_RANK_RANGE, bin_name, rank, return_type: return_type)
+        end
+      end
+
+      # Create list get by value operation.
+      #
+      # Server selects list items identified by value.
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_value(bin_name, value, return_type: ListReturnType::NONE)
+        InvertibleListOp.new(Operation::CDT_READ, GET_BY_VALUE, bin_name, value, return_type: return_type)
+      end
+
+      # Create list get by value range operation.
+      #
+      # Server selects list items identified by value range (value_begin
+      # inclusive, value_end exclusive). If value_begin is null, the range is
+      # less than value_end. If value_end is null, the range is greater than
+      # equal to value_begin.
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_value_range(bin_name, value_begin, value_end = nil, return_type: ListReturnType::NONE)
+        if value_end
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_VALUE_INTERVAL, bin_name, value_begin, value_end, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_VALUE_INTERVAL, bin_name, value_begin, return_type: return_type)
+        end
+      end
+
+      # Create list get by value list operation.
+      #
+      # Server selects list items identified by values.
+      #
+      # Server returns selected data specified by return_type.
+      def self.get_by_value_list(bin_name, values, return_type: ListReturnType::NONE)
+        InvertibleListOp.new(Operation::CDT_READ, GET_BY_VALUE_LIST, bin_name, values, return_type: return_type)
+      end
+
+      # Create list get by value relative to rank range list operation.
+      #
+      # Server selects list items nearest to value and greater, by relative
+      # rank with a count limit.
+      #
+      # Server returns selected data specified by return_type.
+      #
+      # Examples for ordered list [0, 4, 5, 9, 11, 15]:
+      # <ul>
+      # <li>(value, rank, count) = [selected items]</li>
+      # <li>(5, 0, 2) = [5, 9]</li>
+      # <li>(5, 1, 1) = [9]</li>
+      # <li>(5, -1, 2) = [4, 5]</li>
+      # <li>(3, 0, 1) = [4]</li>
+      # <li>(3, 3, 7) = [11, 15]</li>
+      # <li>(3, -3, 2) = []</li>
+      # </ul>
+      #
+      # Without count:
+      #
+      # Examples for ordered list [0, 4, 5, 9, 11, 15]:
+      # <ul>
+      # <li>(value, rank) = [selected items]</li>
+      # <li>(5, 0) = [5, 9, 11, 15]</li>
+      # <li>(5, 1) = [9, 11, 15]</li>
+      # <li>(5, -1) = [4, 5, 9, 11, 15]</li>
+      # <li>(3, 0) = [4, 5, 9, 11, 15]</li>
+      # <li>(3, 3) = [11, 15]</li>
+      # <li>(3, -3) = [0, 4, 5, 9, 11, 15]</li>
+      # </ul>
+      def self.get_by_value_rel_rank_range(bin_name, value, rank, count = nil, return_type: ListReturnType::NONE)
+        if count
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_VALUE_REL_RANK_RANGE, bin_name, value, rank, count, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_READ, GET_BY_VALUE_REL_RANK_RANGE, bin_name, value, rank, return_type: return_type)
+        end
+      end
+
+      # Create list remove by index operation.
+      #
+      # Server removes list item identified by index.
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_index(bin_name, index, return_type: ListReturnType::NONE)
+        ListOperation.new(Operation::CDT_MODIFY, REMOVE_BY_INDEX, bin_name, index, return_type: return_type)
+      end
+
+      # Create list remove by index range operation.
+      #
+      # Server removes list item identified by index range
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_index_range(bin_name, index, count=nil, return_type: ListReturnType::NONE)
+        if count
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_INDEX_RANGE, bin_name, index, count, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_INDEX_RANGE, bin_name, index, return_type: return_type)
+        end
+      end
+
+      # Create list remove by rank operation.
+      #
+      # Server removes list item identified by rank.
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_rank(bin_name, rank, return_type: ListReturnType::NONE)
+        ListOperation.new(Operation::CDT_MODIFY, REMOVE_BY_RANK, bin_name, rank, return_type: return_type)
+      end
+
+      # Create list remove by rank range operation.
+      #
+      # Server removes list item identified by rank range.
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_rank_range(bin_name, rank, count=nil, return_type: ListReturnType::NONE)
+        if count
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_RANK_RANGE, bin_name, rank, count, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_RANK_RANGE, bin_name, rank, return_type: return_type)
+        end
+      end
+
+      # Create list remove by value operation.
+      #
+      # Server removes list items identified by value.
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_value(bin_name, value, return_type: ListReturnType::NONE)
+        InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE, bin_name, value, return_type: return_type)
+      end
+
+      # Create list remove by value range operation.
+      #
+      # Server removes list items identified by value range (value_begin
+      # inclusive, value_end exclusive). If value_begin is null, the range is
+      # less than value_end. If value_end is null, the range is greater than
+      # equal to value_begin.
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_value_range(bin_name, value_begin, value_end = nil, return_type: ListReturnType::NONE)
+        if value_end
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_INTERVAL, bin_name, value_begin, value_end, return_type: return_type)
         else
-          create_operation(Operation::CDT_READ, GET_RANGE, bin_name, index)
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_INTERVAL, bin_name, value_begin, return_type: return_type)
         end
       end
 
+      # Create list remove by value list operation.
+      #
+      # Server removes list items identified by values.
+      #
+      # Server returns selected data specified by return_type.
+      def self.remove_by_value_list(bin_name, values, return_type: ListReturnType::NONE)
+        InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_LIST, bin_name, values, return_type: return_type)
+      end
+
+      # Create list remove by value relative to rank range list operation.
+      #
+      # Server removes list items nearest to value and greater, by relative
+      # rank with a count limit.
+      #
+      # Server returns selected data specified by return_type.
+      #
+      # Examples for ordered list [0, 4, 5, 9, 11, 15]:
+      # <ul>
+      # <li>(value, rank, count) = [selected items]</li>
+      # <li>(5, 0, 2) = [5, 9]</li>
+      # <li>(5, 1, 1) = [9]</li>
+      # <li>(5, -1, 2) = [4, 5]</li>
+      # <li>(3, 0, 1) = [4]</li>
+      # <li>(3, 3, 7) = [11, 15]</li>
+      # <li>(3, -3, 2) = []</li>
+      # </ul>
+      #
+      # Without count:
+      #
+      # Examples for ordered list [0, 4, 5, 9, 11, 15]:
+      # <ul>
+      # <li>(value, rank) = [selected items]</li>
+      # <li>(5, 0) = [5, 9, 11, 15]</li>
+      # <li>(5, 1) = [9, 11, 15]</li>
+      # <li>(5, -1) = [4, 5, 9, 11, 15]</li>
+      # <li>(3, 0) = [4, 5, 9, 11, 15]</li>
+      # <li>(3, 3) = [11, 15]</li>
+      # <li>(3, -3) = [0, 4, 5, 9, 11, 15]</li>
+      # </ul>
+      def self.remove_by_value_rel_rank_range(bin_name, value, rank, count = nil, return_type: ListReturnType::NONE)
+        if count
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_REL_RANK_RANGE, bin_name, value, rank, count, return_type: return_type)
+        else
+          InvertibleListOp.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_REL_RANK_RANGE, bin_name, value, rank, return_type: return_type)
+        end
+      end
+
+      def and_return(return_type)
+        @return_type = return_type
+        @bin_value = nil
+        self
+      end
+
+      def invert_selection?
+        false
+      end
+
+      def bin_value
+        @bin_value ||= pack_bin_value
+      end
+
       private
 
-      def self.create_operation(type, cdt_type, bin, *args)
+      def pack_bin_value
         bytes = nil
         Packer.use do |packer|
-          packer.write_raw_short(cdt_type)
+          packer.write_raw_short(list_op)
+          args = arguments.dup
+          if return_type
+            rt = return_type
+            rt |= ListReturnType::INVERTED if invert_selection?
+            args.unshift(rt)
+          end
           if args.length > 0
             packer.write_array_header(args.length)
             args.each do |value|
@@ -204,7 +497,30 @@ module Aerospike
           end
           bytes = packer.bytes
         end
-        return Operation.new(type, bin, BytesValue.new(bytes))
+        BytesValue.new(bytes)
+      end
+    end
+
+    class InvertibleListOp < ListOperation
+
+      ##
+      # Invert meaning of list command and return value.
+      #
+      # For example:
+      #
+      #     ListOperation.remove_by_index_range(binName, index, count)
+      #       .and_return(ListReturnType::VALUE)
+      #       .invert_selection
+      #
+      # When calling invert_selection() on the list operation, the items
+      # outside the specified range will be removed and returned.
+      def invert_selection
+        @invert_selection = !@invert_selection
+        self
+      end
+
+      def invert_selection?
+        !!@invert_selection
       end
 
     end