Class: Transproc::Function Private

Inherits:
Object
  • Object
show all
Defined in:
lib/transproc/function.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.

Transformation proc wrapper allowing composition of multiple procs into a data-transformation pipeline.

This is used by Transproc to wrap registered methods.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(fn, options = {}) ⇒ Function

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.

Returns a new instance of Function.



35
36
37
38
39
 
# File 'lib/transproc/function.rb', line 35

def initialize(fn, options = {})
  @fn = fn
  @args = options.fetch(:args, [])
  @name = options.fetch(:name, fn)
end

Instance Attribute Details

#args ⇒ Array (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.

Additional arguments that will be passed to the wrapped proc

Returns:

  • (Array) 


25
26
27
 
# File 'lib/transproc/function.rb', line 25

def args
  @args
end

#fn ⇒ Proc, Composed (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.

Wrapped proc or another composite function

Returns:

  • (Proc, Composed) 


18
19
20
 
# File 'lib/transproc/function.rb', line 18

def fn
  @fn
end

#name ⇒ <type] The name of the function (readonly)

Returns <type] The name of the function.

Returns:

  • (<type] The name of the function) —

    <type] The name of the function



32
33
34
 
# File 'lib/transproc/function.rb', line 32

def name
  @name
end

Instance Method Details

#==(other) ⇒ Object Also known as: eql? 



78
79
80
81
 
# File 'lib/transproc/function.rb', line 78

def ==(other)
  return false unless other.instance_of?(self.class)
  [fn, name, args] == [other.fn, other.name, other.args]
end

#call(*value) ⇒ Object Also known as: []

Call the wrapped proc

Parameters:

  • value (Object) —

    The input value



48
49
50
 
# File 'lib/transproc/function.rb', line 48

def call(*value)
  fn.call(*value, *args)
end

#compose(other) ⇒ Composite Also known as: +, >>

Compose this function with another function or a proc

Parameters:

Returns:



62
63
64
 
# File 'lib/transproc/function.rb', line 62

def compose(other)
  Composite.new(self, other)
end

#to_ast ⇒ Array

Return a simple AST representation of this function

Returns:

  • (Array) 


89
90
91
92
 
# File 'lib/transproc/function.rb', line 89

def to_ast
  args_ast = args.map { |arg| arg.respond_to?(:to_ast) ? arg.to_ast : arg }
  [name, args_ast]
end

#to_proc ⇒ Proc

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.

Converts a transproc to a simple proc

Returns:

  • (Proc) 


98
99
100
101
102
103
104
 
# File 'lib/transproc/function.rb', line 98

def to_proc
  if args.size > 0
    proc { |*value| fn.call(*value, *args) }
  else
    fn.to_proc
  end
end

#with(*args) ⇒ Function

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.

Return a new fn with curried args

Returns:



73
74
75
 
# File 'lib/transproc/function.rb', line 73

def with(*args)
  self.class.new(fn, name: name, args: args)
end