Class: Familia::Horreum::MultiResult

Inherits:
Object
  • Object
show all
Defined in:
lib/familia/horreum/serialization.rb

Overview

The magical MultiResult, keeper of Redis’s deepest secrets!

This quirky little class wraps up the outcome of a Redis “transaction” (or as I like to call it, a “Redis dance party”) with a bow made of pure Ruby delight. It knows if your commands were successful and keeps the results safe in its pocket dimension.

Examples:

Summoning a MultiResult from the void

result = MultiResult.new(true, ["OK", "OK"])

Divining the success of your Redis ritual

if result.successful?
  puts "Huzzah! The Redis spirits smile upon you!"
else
  puts "Alas! The Redis gremlins have conspired against us!"
end

Peering into the raw essence of results

result.results.each_with_index do |value, index|
  puts "Command #{index + 1} whispered back: #{value}"
end

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(success, results) ⇒ MultiResult

Creates a new MultiResult instance.

Parameters:

  • success (Boolean) —

    Whether all commands succeeded

  • results (Array<String>) —

    The raw results from Redis commands



451
452
453
454
 
# File 'lib/familia/horreum/serialization.rb', line 451

def initialize(success, results)
  @success = success
  @results = results
end

Instance Attribute Details

#results ⇒ Array<String> (readonly)

Returns The raw return values from the Redis commands.

Returns:

  • (Array<String>) —

    The raw return values from the Redis commands



439
440
441
 
# File 'lib/familia/horreum/serialization.rb', line 439

def results
  @results
end

#success ⇒ Boolean (readonly)

Returns true if all commands in the transaction succeeded, false otherwise.

Returns:

  • (Boolean) —

    true if all commands in the transaction succeeded, false otherwise



439
440
441
 
# File 'lib/familia/horreum/serialization.rb', line 439

def success
  @success
end

Instance Method Details

#successful? ⇒ Boolean Also known as: success?

Convenient method to check if the commit was successful.

Returns:

  • (Boolean) —

    true if all commands succeeded, false otherwise



472
473
474
 
# File 'lib/familia/horreum/serialization.rb', line 472

def successful?
  @success
end

#tuple ⇒ Array

Returns a tuple representing the result of the transaction.

Examples:

[true, ["OK", true, 1]]

Returns:

  • (Array) —

    A tuple containing the success status and the raw results. The success status is a boolean indicating if all commands succeeded. The raw results is an array of return values from the Redis commands.



465
466
467
 
# File 'lib/familia/horreum/serialization.rb', line 465

def tuple
  [successful?, results]
end