Class: ConvenientService::Utils::Proc::ExecConfig Private

Inherits:
Support::Command show all
Defined in:
lib/convenient_service/utils/proc/exec_config.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Since:

  • 1.0.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Support::Command

[], call

Constructor Details

#initialize(proc, object) ⇒ void

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parameters:

  • proc (Proc)
  • object (Object) —

    Can be any type.

Since:

  • 1.0.0



29
30
31
32
 
# File 'lib/convenient_service/utils/proc/exec_config.rb', line 29

def initialize(proc, object)
  @proc = proc
  @object = object
end

Instance Attribute Details

#object ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Since:

  • 1.0.0



16
17
18
 
# File 'lib/convenient_service/utils/proc/exec_config.rb', line 16

def object
  @object
end

#proc ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Since:

  • 1.0.0



22
23
24
 
# File 'lib/convenient_service/utils/proc/exec_config.rb', line 22

def proc
  @proc
end

Instance Method Details

#call ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Note:

Second form allows to access methods from the enclosing context (like test in examples).

Returns Can be any type.

Examples:

Preparation.

class Foo
  class << self
    def stack
      @stack ||= SomeMiddlewareStack.new
    end

    def configure(&block)
      ConvenientService::Utils::Proc.exec_config(block, stack)
    end

    def test
    end
  end
end

First form - no arguments. Block is executed inside the object context (stack in this particular case, see preparation example).

class Foo
  configure do
    use SomeMiddleware

    test # Raises Exception since `test` is NOT defined in `stack`.
  end
end

Second form - one argument. Block is executed in the enclosing context.

class Foo
  configure do |stack|
    stack.use SomeMiddleware

    test # Works.
  end
end

Returns:

  • (Object) —

    Can be any type.

Since:

  • 1.0.0



76
77
78
 
# File 'lib/convenient_service/utils/proc/exec_config.rb', line 76

def call
  proc_has_one_positional_argument? ? proc.call(object) : object.instance_exec(&proc)
end