oxblood 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 914d269f92807d5e874e813be77ad7a325fa6b86
-  data.tar.gz: e8ec8e0a92d5ccc93a48271b0b44545cdc38a365
+  metadata.gz: 1233a81cff6072fcb573bdc595b996d499f2a414
+  data.tar.gz: 7b3c679039d0bf18efa45c7e6d01e8de01ba88ca
 SHA512:
-  metadata.gz: 6a5584d343e12974e664c75b094662c72b0cc63c6c660c1c6f305d8a8d2cd7de2fe6c7361acf648fa1db7da158e532967be0fee053454e9a6ad785eaa63ecc52
-  data.tar.gz: 2d7ca78e83a921687b56de218a0b57a1bac2a262a66fb8c33c1fb630b623691e610e53ecd01063342e363927d02fb4e77d5d084f675faf7746ba49263ee09424
+  metadata.gz: 3bf913dab69bd847ef4397b40a64b8adab77b4d60a35f6df6b7262f6fd46a3360cf9882cf60e9c8e27415ed29c4710fc977d011336c2c98690f672515f341962
+  data.tar.gz: ceb1eb09ebe2d64fd450dd189edad55e9646cef731829339f62ca27dd11656e0efbc410fd6c768c4013cd7c9057baf7e07accc5f507718bb824e9870bc703075

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.3.0 (2017-04-02)
+  * [#26](https://github.com/etehtsea/oxblood/issues/26):
+    Added server commands support - [@etehtsea](https://github.com/etehtsea)
+  * [#21](https://github.com/etehtsea/oxblood/issues/21):
+    Added geo commands support - [@etehtsea](https://github.com/etehtsea)
+  * [#22](https://github.com/etehtsea/oxblood/issues/22):
+    Added scripting commands support - [@etehtsea](https://github.com/etehtsea)
+
 ## 0.2.0 (2017-01-18)
   * [#13](https://github.com/etehtsea/oxblood/issues/13):
     Added support for ZRANGEBYLEX/ZREMRANGEBYLEX/ZREVRANGEBYLEX - [@etehtsea](https://github.com/etehtsea)

data/README.md

@@ -12,32 +12,33 @@ A straightforward Redis Ruby client.
 - Ruby 2.2.2+
 - JRuby 9k+
 
-## Status
+## Usage
+As a starting point please look at [Oxblood::Pool](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Pool) documentation.
+
+## Documentation
+Documentation and usage examples are available on [Rubydoc](http://rubydoc.info/github/etehtsea/oxblood/master/frames).
 
-- Commands:
-  - Cluster (0/20)
+- [Pipelining](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Pipeline)
+- [Connection pooling](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Pool)
+- [Connection resiliency](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/RSocket)
+- Commands groups:
+  - Cluster
   - [Connection](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Connection)
-  - Geo (0/6)
+  - [Geo](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Geo)
   - [Hashes](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Hashes)
   - [HyperLogLog](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/HyperLogLog)
-  - [Keys](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Keys) (19/22) (See [#4], [#6], [#7])
+  - [Keys](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Keys)
   - [Lists](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Lists)
-  - Pub/Sub (0/6)
-  - Scripting (0/7)
-  - [Server](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Server) (2/31)
+  - Pub/Sub
+  - [Scripting](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Scripting)
+  - [Server](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Server)
   - [Sets](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Sets)
   - [Sorted Sets](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/SortedSets)
-  - [Strings](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Strings) (23/24) (See [#16])
+  - [Strings](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Strings)
   - [Transactions](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Commands/Transactions)
-- [Pipeling](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Pipeline)
-- [Connection pooling](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Pool)
-- [Connection resiliency](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/RSocket)
 
-## Usage
-As a starting point please look at [Oxblood::Pool](http://www.rubydoc.info/github/etehtsea/oxblood/master/Oxblood/Pool) documentation.
-
-## Documentation
-Documentation and usage examples are available on [Rubydoc](http://rubydoc.info/github/etehtsea/oxblood/master/frames).
+## Performance
+Available benchmark results are available [here](https://github.com/etehtsea/oxblood/wiki/Performance).
 
 ## Continuous Integration
 You can check CI status at [Travis CI](https://travis-ci.org/etehtsea/oxblood).
@@ -47,9 +48,3 @@ Bug reports and pull requests are welcome on [GitHub](https://github.com/etehtse
 
 ## License
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-[#4]: https://github.com/etehtsea/oxblood/issues/4
-[#6]: https://github.com/etehtsea/oxblood/issues/6
-[#7]: https://github.com/etehtsea/oxblood/issues/7
-[#16]: https://github.com/etehtsea/oxblood/issues/16
-[#19]: https://github.com/etehtsea/oxblood/issues/19

data/lib/oxblood/commands.rb

@@ -2,10 +2,12 @@ require 'oxblood/commands/hashes'
 require 'oxblood/commands/hyper_log_log'
 require 'oxblood/commands/strings'
 require 'oxblood/commands/connection'
+require 'oxblood/commands/geo'
 require 'oxblood/commands/server'
 require 'oxblood/commands/keys'
 require 'oxblood/commands/lists'
 require 'oxblood/commands/sets'
+require 'oxblood/commands/scripting'
 require 'oxblood/commands/sorted_sets'
 require 'oxblood/commands/transactions'
 
@@ -15,10 +17,12 @@ module Oxblood
     include HyperLogLog
     include Strings
     include Connection
+    include Geo
     include Server
     include Keys
     include Lists
     include Sets
+    include Scripting
     include SortedSets
     include Transactions
   end

data/lib/oxblood/commands/geo.rb

@@ -0,0 +1,169 @@
+module Oxblood
+  module Commands
+    module Geo
+      # Add one or more geospatial items in the geospatial index represented
+      # using a sorted set.
+      # @see https://redis.io/commands/geoadd
+      #
+      # @param [String] key
+      # @param [Array<[String, String, String]>] items
+      #   Geospatial items (longitude, latitude, member)
+      #
+      # @return [Integer] The number of elements added to the sorted set,
+      #   not including elements already existing for which the score was updated.
+      def geoadd(key, *items)
+        run(*items.unshift(:GEOADD, key))
+      end
+
+      # Returns members of a geospatial index as standard geohash strings.
+      # @see https://redis.io/commands/geohash
+      #
+      # @param [String] key
+      # @param [String, Array<String>] members
+      #
+      # @return [Array] The command returns an array where each element is
+      #   the Geohash corresponding to each member name passed as argument to the command.
+      def geohash(key, *members)
+        run(*members.unshift(:GEOHASH, key))
+      end
+
+      # Returns longitude and latitude of members of a geospatial index.
+      # @see https://redis.io/commands/geopos
+      #
+      # @param [String] key
+      # @param [String, Array<String>] members
+      #
+      # @return [Array] an array where each element is a two elements array
+      #   representing longitude and latitude (x,y) of each member name passed
+      #   as argument to the command.
+      #   Non existing elements are reported as `nil` elements of the array.
+      def geopos(key, *members)
+        run(*members.unshift(:GEOPOS, key))
+      end
+
+      # Returns the distance between two members of a geospatial index.
+      # @see https://redis.io/commands/geodist
+      #
+      # @param [String] key
+      # @param [String] member1 name of geospatial index member
+      # @param [String] member2 name of geospatial index member
+      # @param [nil, String] unit that could be one of the following and
+      #   defaults to meters: m (meters), km (kilometers), mi (miles), ft (feet).
+      #
+      # @return [nil, String] The command returns the distance as a double
+      #   (represented as a string) in the specified unit, or nil if one or
+      #   both elements are missing.
+      def geodist(key, member1, member2, unit = nil)
+        if unit
+          run(:GEODIST, key, member1, member2, unit)
+        else
+          run(:GEODIST, key, member1, member2)
+        end
+      end
+
+      # Query a sorted set representing a geospatial index to fetch members
+      # matching a given maximum distance from a point.
+      # @see https://redis.io/commands/georadius
+      #
+      # @param [String] key
+      # @param [String] longitude
+      # @param [String] latitude
+      # @param [Integer] radius
+      # @param [Symbol] unit that could be one of the following and defaults to
+      #   meters: m (meters), km (kilometers), mi (miles), ft (feet).
+      # @param [Hash] opts
+      #
+      # @option opts [Boolean] :withcoord Also return the longitude, latitude
+      #   coordinates of the matching items.
+      # @option opts [Boolean] :withdist Also return the distance of
+      #   the returned items from the specified center. The distance is returned
+      #   in the same unit as the unit specified as the radius argument of
+      #   the command.
+      # @option opts [Boolean] :withhash Also return the raw geohash-encoded
+      #   sorted set score of the item, in the form of a 52 bit unsigned integer.
+      #   This is only useful for low level hacks or debugging and is otherwise
+      #   of little interest for the general user.
+      # @option opts [Symbol] :order The command default is to return unsorted
+      #   items. Two different sorting methods can be invoked using the following
+      #   two options:
+      #     - ASC: from the nearest to the farthest, relative to the center.
+      #     - DESC: from the farthest to the nearest, relative to the center.
+      # @option opts [Integer] :count limit the results to the first N matching items.
+      # @option opts [String] :store generates a valid geo index and stores
+      #   result to key
+      # @option opts [String] :storedist stores calculated distances to key.
+      #
+      # @return [Array] See https://redis.io/commands/georadius#return-value
+      # @return [Integer] if STORE or STOREDIST option was used
+      def georadius(key, longitude, latitude, radius, unit, opts = {})
+        args = [:GEORADIUS, key, longitude, latitude, radius, unit]
+        add_georadius_opts!(args, opts)
+        run(*args)
+      end
+
+      # Query a sorted set representing a geospatial index to fetch members
+      # matching a given maximum distance from a member.
+      # @see https://redis.io/commands/georadiusbymember
+      #
+      # @param [String] key
+      # @param [String] member
+      # @param [Integer] radius
+      # @param [Symbol] unit that could be one of the following and defaults to
+      #   meters: m (meters), km (kilometers), mi (miles), ft (feet).
+      # @param [Hash] opts
+      #
+      # @option opts [Boolean] :withcoord Also return the longitude, latitude
+      #   coordinates of the matching items.
+      # @option opts [Boolean] :withdist Also return the distance of
+      #   the returned items from the specified center. The distance is returned
+      #   in the same unit as the unit specified as the radius argument of
+      #   the command.
+      # @option opts [Boolean] :withhash Also return the raw geohash-encoded
+      #   sorted set score of the item, in the form of a 52 bit unsigned integer.
+      #   This is only useful for low level hacks or debugging and is otherwise
+      #   of little interest for the general user.
+      # @option opts [Symbol] :order The command default is to return unsorted
+      #   items. Two different sorting methods can be invoked using the following
+      #   two options:
+      #     - ASC: from the nearest to the farthest, relative to the center.
+      #     - DESC: from the farthest to the nearest, relative to the center.
+      # @option opts [Integer] :count limit the results to the first N matching items.
+      # @option opts [String] :store generates a valid geo index and stores
+      #   result to key
+      # @option opts [String] :storedist stores calculated distances to key.
+      #
+      # @return [Array] See https://redis.io/commands/georadius#return-value
+      # @return [Integer] if STORE or STOREDIST option was used
+      def georadiusbymember(key, member, radius, unit, opts = {})
+        args = [:GEORADIUSBYMEMBER, key, member, radius, unit]
+        add_georadius_opts!(args, opts)
+        run(*args)
+      end
+
+      private
+
+      # @note Mutates args argument!
+      def add_georadius_opts!(args, opts)
+        args << :WITHCOORD if opts[:withcoord]
+        args << :WITHDIST if opts[:withdist]
+        args << :WITHHASH if opts[:withhash]
+
+        if order = opts[:order]
+          args << order
+        end
+
+        if count = opts[:count]
+          args.push(:COUNT, count)
+        end
+
+        if store_key = opts[:store]
+          args.push(:STORE, store_key)
+        end
+
+        if storedist_key = opts[:storedist]
+          args.push(:STOREDIST, storedist_key)
+        end
+      end
+    end
+  end
+end

data/lib/oxblood/commands/scripting.rb

@@ -0,0 +1,102 @@
+require 'oxblood/commands/scripting'
+
+module Oxblood
+  module Commands
+    module Scripting
+      # Execute a Lua script server side
+      # @see https://redis.io/commands/eval
+      #
+      # @example
+      #   session.eval("return redis.call('set','foo','bar')", 0)
+      #   # => 'OK'
+      #
+      # @example
+      #   session.eval("return redis.call('set',KEYS[1],'bar')", 1, :foo)
+      #   # => 'OK'
+      #
+      # @example
+      #   session.eval("return 10", 0)
+      #   # => 10
+      #
+      # @example
+      #   session.eval("return {1,2,{3,'Hello World!'}}", 0)
+      #   # => [1, 2, [3, 'Hello World!']]
+      #
+      # @example
+      #   session.eval("return redis.call('get','foo')", 0)
+      #   # => 'bar'
+      #
+      # @example
+      #   session.eval("return {1,2,3.3333,'foo',nil,'bar'}", 0)
+      #   # => [1, 2, 3, 'foo']
+      #
+      # @param [String] script
+      # @param [Integer] numkeys
+      # @param [String, Array<String>] keys_and_args
+      def eval(script, numkeys, *keys_and_args)
+        run(:EVAL, script, numkeys, keys_and_args)
+      end
+
+      # Execute a Lua script server side
+      # @see https://redis.io/commands/evalsha
+      #
+      # @param [String] sha1
+      # @param [Integer] numkeys
+      # @param [String, Array<String>] keys_and_args
+      def evalsha(sha1, numkeys, *keys_and_args)
+        run(:EVALSHA, sha1, numkeys, keys_and_args)
+      end
+
+      # Set the debug mode for executed scripts.
+      # @see https://redis.io/commands/script-debug
+      #
+      # @param [Symbol] mode
+      #
+      # @return [String] 'OK'
+      # @return [RError] if wrong mode passed
+      def script_debug(mode)
+        run(:SCRIPT, :DEBUG, mode)
+      end
+
+      # Check existence of scripts in the script cache.
+      # @see https://redis.io/commands/script-exists
+      #
+      # @param [String, Array<String>] sha1_digests
+      #
+      # @return [Array<Integer>] For every corresponding SHA1 digest of a script
+      #   that actually exists in the script cache, an 1 is returned,
+      #   otherwise 0 is returned.
+      def script_exists(*sha1_digests)
+        run(*sha1_digests.unshift(:SCRIPT, :EXISTS))
+      end
+
+      # Remove all the scripts from the script cache.
+      # @see https://redis.io/commands/script-flush
+      #
+      # @return [String] 'OK'
+      def script_flush
+        run(:SCRIPT, :FLUSH)
+      end
+
+      # Kill the script currently in execution.
+      # @see https://redis.io/commands/script-kill
+      #
+      # @return [String] 'OK'
+      # @return [RError] if there is no script to kill
+      def script_kill
+        run(:SCRIPT, :KILL)
+      end
+
+      # Load the specified Lua script into the script cache.
+      # @see https://redis.io/commands/script-load
+      #
+      # @param [String] script
+      #
+      # @return [String] This command returns the SHA1 digest of the script
+      #   added into the script cache
+      def script_load(script)
+        run(:SCRIPT, :LOAD, script)
+      end
+    end
+  end
+end

data/lib/oxblood/commands/server.rb

@@ -1,16 +1,211 @@
 module Oxblood
   module Commands
     module Server
-      # Remove all keys from the current database
+      # Asynchronously rewrite the append-only file.
+      # @see https://redis.io/commands/bgrewriteaof
+      #
+      # @return [String] always 'OK'
+      def bgrewriteaof
+        run(:BGREWRITEAOF)
+      end
+
+      # Asynchronously save the dataset to disk
+      # @see https://redis.io/commands/bgsave
+      #
+      # @return [String] command status message
+      def bgsave
+        run(:BGSAVE)
+      end
+
+      # Get the current conneciton name.
+      # @see https://redis.io/commands/client-getname
+      #
+      # @return [nil, String] client name
+      def client_getname
+        run(:CLIENT, :GETNAME)
+      end
+
+      # Get the list of client connections.
+      # @see https://redis.io/commands/client-list
+      #
+      # @return [String] client list in the formatted string
+      def client_list
+        run(:CLIENT, :LIST)
+      end
+
+      # Kill the connection of a client.
+      # @see https://redis.io/commands/client-kill
+      #
+      # @param [Hash, String] opts_or_addr hash of options or addr in
+      #   an addr:port form.
+      #
+      # @option opts_or_addr [Integer] :id unique client ID.
+      # @option opts_or_addr [Symbol] :type Close connections of all the clients
+      #   of specified type (for example: `normal`, `master`, `slave`, `pubsub`).
+      # @option opts_or_addr [String] :addr ip:port which matches a line
+      #   returned by CLIENT LIST command (addr field).
+      # @option opts_or_addr [Boolean] :skipme Skip client that is calling this
+      #   command (enabled by default).
+      #
+      # @return [String] 'OK'
+      # @return [Integer] the number of clients killed when called with
+      #   the filter/value format
+      def client_kill(opts_or_addr = {})
+        if opts_or_addr.is_a?(String)
+          run(:CLIENT, :KILL, opts_or_addr)
+        else
+          args = [:CLIENT, :KILL]
+
+          if v = opts_or_addr[:id]
+            args.push(:ID, v)
+          end
+
+          if v = opts_or_addr[:type]
+            args.push(:TYPE, v)
+          end
+
+          if v = opts_or_addr[:addr]
+            args.push(:ADDR, v)
+          end
+
+          if opts_or_addr.key?(:skipme)
+            case opts_or_addr[:skipme]
+            when false, 'no'.freeze
+              args.push(:SKIPME, 'no'.freeze)
+            when true, 'yes'.freeze
+              args.push(:SKIPME, 'yes'.freeze)
+            end
+          end
+
+          run(*args)
+        end
+      end
+
+      # Set the current connection name.
+      # @see https://redis.io/commands/client-setname
+      #
+      # @param [String] connection_name
+      #
+      # @return [String] 'OK' in case of success.
+      def client_setname(connection_name)
+        run(:CLIENT, :SETNAME, connection_name)
+      end
+
+      # Stop processing commands from clients for some time.
+      # @see https://redis.io/commands/client-pause
+      #
+      # @param [Integer] timeout in milliseconds
+      #
+      # @return [String] 'OK' in case of success.
+      def client_pause(timeout)
+        run(:CLIENT, :PAUSE, timeout)
+      end
+
+      # Get array of Redis command details.
+      # @see https://redis.io/commands/command
+      #
+      # @return [Array] nested list of command details
+      def command
+        run(:COMMAND)
+      end
+
+      # Get total number of Redis commands.
+      # @see https://redis.io/commands/command-count
+      #
+      # @return [Integer] number of commands returned by COMMAND
+      def command_count
+        run(:COMMAND, :COUNT)
+      end
+
+      # Extract keys given a full Redis command
+      # @see https://redis.io/commands/command-getkeys
+      #
+      # @return [Array] list of keys from your command
+      def command_getkeys(*args)
+        run(*args.unshift(:COMMAND, :GETKEYS))
+      end
+
+      # Get array of specific Redis command details.
+      # @see https://redis.io/commands/command-info
+      #
+      # @param [String, Array<String>] command_names
+      #
+      # @return [Array] nested list of command details.
+      def command_info(*command_names)
+        run(*command_names.unshift(:COMMAND, :INFO))
+      end
+
+      # Get the value of a configuration parameter
+      # @see https://redis.io/commands/config-get
+      #
+      # @param [String] parameter
+      #
+      # @return [Array] parameters with values
+      def config_get(parameter)
+        run(:CONFIG, :GET, parameter)
+      end
+
+      # Rewrite the configuration file with the in memory configuration
+      # @see https://redis.io/commands/config-rewrite
+      #
+      # @return [String] 'OK'
+      def config_rewrite
+        run(:CONFIG, :REWRITE)
+      end
+
+      # Set a configuration parameter to the given value
+      # @see https://redis.io/commands/config-set
+      #
+      # @param [String] parameter
+      # @param [String] value
+      #
+      # @return [String] OK if parameter was set properly.
+      def config_set(parameter, value)
+        run(:CONFIG, :SET, parameter, value)
+      end
+
+      # Reset the stats returned by INFO
+      # @see https://redis.io/commands/config-resetstat
+      #
+      # @return [String] 'OK'
+      def config_resetstat
+        run(:CONFIG, :RESETSTAT)
+      end
+
+      # Return the number of keys in the selected database
+      # @see https://redis.io/commands/dbsize
+      #
+      # @return [Integer] selected database size
+      def dbsize
+        run(:DBSIZE)
+      end
+
+      # Remove all keys from all databases.
+      # @see https://redis.io/commands/flushall
+      #
+      # @param [Hash] opts
+      #
+      # @option opts [Boolean] :async
+      #
+      # @return [String] 'OK'
+      def flushall(opts = {})
+        opts[:async] ? run(:FLUSHALL, :ASYNC) : run(:FLUSHALL)
+      end
+
+      # Remove all keys from the current database.
       # @see http://redis.io/commands/flushdb
       #
+      # @param [Hash] opts
+      #
+      # @option opts [Boolean] :async
+      #
       # @return [String] should always return 'OK'
-      def flushdb
-        run(:FLUSHDB)
+      def flushdb(opts = {})
+        opts[:async] ? run(:FLUSHDB, :ASYNC) : run(:FLUSHDB)
       end
 
       # Returns information and statistics about the server in a format that is
-      # simple to parse by computers and easy to read by humans
+      # simple to parse by computers and easy to read by humans.
       # @see http://redis.io/commands/info
       #
       # @param [String] section used to select a specific section of information
@@ -19,6 +214,94 @@ module Oxblood
       def info(section = nil)
         section ? run(:INFO, section) : run(:INFO)
       end
+
+      # Get the UNIX timestamp of the last successful save to disk.
+      # @see https://redis.io/commands/lastsave
+      #
+      # @return [Integer] an UNIX timestamp.
+      def lastsave
+        run(:LASTSAVE)
+      end
+
+      # Return the role of the instance in the context of replication.
+      # @see https://redis.io/commands/role
+      #
+      # @return [Array] where the first element is one of master, slave,
+      #   sentinel and the additional elements are role-specific as illustrated
+      #   above.
+      def role
+        run(:ROLE)
+      end
+
+      # Synchronously save the dataset to disk.
+      # @see https://redis.io/commands/save
+      #
+      # @return [String] 'OK'
+      def save
+        run(:SAVE)
+      end
+
+      # Synchronously save the dataset to disk and then shutdown the server.
+      # @see https://redis.io/commands/shutdown
+      #
+      # @param [Hash] opts
+      #
+      # @option opts [Boolean] :save truthy value acts as SAVE and explicit
+      #   `false` value acts as NOSAVE. `nil` or absence of option don't add anything.
+      #
+      # @return [RError] in case of failure and nothing
+      # @return [nil] in case of success
+      def shutdown(opts = {})
+        case opts[:save]
+        when nil
+          run(:SHUTDOWN)
+        when false
+          run(:SHUTDOWN, :NOSAVE)
+        else
+          run(:SHUTDOWN, :SAVE)
+        end
+      rescue Errno::ECONNRESET
+        nil
+      end
+
+      # Make the server a slave of another instance, or promote it as master.
+      # @see https://redis.io/commands/slaveof
+      #
+      # @example Make server slave
+      #   session.slaveof('localhost', 7777)
+      # @example Promote to master
+      #   session.slaveof(:NO, :ONE)
+      #
+      # @param [String] host
+      # @param [String] port
+      #
+      # @return [String] 'OK'
+      def slaveof(host, port)
+        run(:SLAVEOF, host, port)
+      end
+
+      # Manages the Redis slow queries log.
+      # @see https://redis.io/commands/slowlog
+      #
+      # @param [Symbol] subcommand For example :len, :reset, :get
+      # @param [String] argument
+      #
+      # @return [Integer] for :len subcommand
+      # @return [String] 'OK' for :reset subcommand
+      # @return [Array] for :get subcommand
+      def slowlog(subcommand, argument = nil)
+        args = [:SLOWLOG, subcommand]
+        args << argument if argument
+        run(*args)
+      end
+
+      # Returns the current server time.
+      # @see https://redis.io/commands/time
+      #
+      # @return [Array<String, String>] unix time in seconds and microseconds.
+      def time
+        run(:TIME)
+      end
     end
   end
 end

data/lib/oxblood/pipeline.rb

@@ -3,7 +3,7 @@ require 'oxblood/commands'
 
 module Oxblood
   # Redis pipeling class. Commands won't be send until {#sync} is called.
-  # Error responses won't be raises and should be checked manually in the
+  # Error responses won't be raised and should be checked manually in the
   # responses array.
   # @see http://redis.io/topics/pipelining#redis-pipelining
   #

data/lib/oxblood/pool.rb

@@ -8,7 +8,7 @@ module Oxblood
   #
   # @example
   #   pool = Oxblood::Pool.new(size: 8)
-  #   pool.with { |c| c.ping } # => 'PONG'
+  #   pool.with { |s| s.ping } # => 'PONG'
   class Pool
     # Initialize connection pool
     #

data/lib/oxblood/version.rb

@@ -1,3 +1,3 @@
 module Oxblood
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: oxblood
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Konstantin Shabanov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-18 00:00:00.000000000 Z
+date: 2017-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -118,11 +118,13 @@ files:
 - lib/oxblood.rb
 - lib/oxblood/commands.rb
 - lib/oxblood/commands/connection.rb
+- lib/oxblood/commands/geo.rb
 - lib/oxblood/commands/hashes.rb
 - lib/oxblood/commands/hyper_log_log.rb
 - lib/oxblood/commands/keys.rb
 - lib/oxblood/commands/lists.rb
 - lib/oxblood/commands/scan.rb
+- lib/oxblood/commands/scripting.rb
 - lib/oxblood/commands/server.rb
 - lib/oxblood/commands/sets.rb
 - lib/oxblood/commands/sorted_sets.rb
@@ -158,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 2.6.10
 signing_key: 
 specification_version: 4
 summary: A Ruby Redis client