Class: Methodist::Interactor

Inherits:
Pattern
  • Object
show all
Includes:
Dry::Transaction
Defined in:
lib/methodist/interactor.rb

Overview

Methodist::Interactor

Base class for a Methodist interactor.

Methodist::Interactor dependency from dry-rb transactions and dry-rb validations

Defined Under Namespace

Classes: InputClassError, SchemaDefinitionError

Constant Summary collapse

NEW_DRY_VALIDATION_V = 
'1.0.0'.freeze

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Pattern

#methodistic?

Class Attribute Details

.input_schema ⇒ Object (readonly)

Returns the value of attribute input_schema.



18
19
20
 
# File 'lib/methodist/interactor.rb', line 18

def input_schema
  @input_schema
end

Instance Attribute Details

#validation_result ⇒ Object

Returns the value of attribute validation_result.



15
16
17
 
# File 'lib/methodist/interactor.rb', line 15

def validation_result
  @validation_result
end

Class Method Details

.schema(&block) ⇒ Object

Method set Dry::Validation schema for an interactor.

Receive block for generating Dry::Validation schema result.

class InteractorClass < Methodist::Interactor
  schema do
    required(:name).value(:str?)
  end

  step :validate
end

InteractorClass.new.call(name: nil) #=> Failure(ValidationError)

See

dry-rb.org/gems/dry-validation/

github.com/dry-rb/dry-transaction



41
42
43
44
45
46
47
 
# File 'lib/methodist/interactor.rb', line 41

def schema(&block)
  if block_given?
    @input_schema = dry_schema(&block)
  else
    raise SchemaDefinitionError, 'You must pass block to `schema`'
  end
end

Instance Method Details

#validate(input) ⇒ Object

Method for validation input of interactor parameters.

Parameters

  • input [Hash] - parameters for interactor

Example

# app/interactors/interactor_class.rb
class InteractorClass < Methodist::Interactor
  schema do
    required(:name).value(:str?)
  end

  step :validate
end

# your controller action
def create
  result = InteractorClass.new.call(name: nil) #=> Failure(ValidationError)
  raise InteractorError, result.value if result.failure?
end

Return

  • Dry::Monads::Result::Success - success result of interactor step

  • Dry::Monads::Result::Failure - failure result of interactor step

Raise

  • SchemaDefinitionError - raise if method was called without a schema definition

Attention

You can redefine failure_validation_value for a custom value returning in case of validation Failure

Raises:



96
97
98
99
100
101
102
103
 
# File 'lib/methodist/interactor.rb', line 96

def validate(input)
  input = {} unless input
  raise InputClassError, 'If you want to use custom #validate, you have to pass a hash to an interactor' unless input.is_a?(Hash)
  raise SchemaDefinitionError, 'You have to define a schema with #schema method' unless input_schema
  @validation_result = input_schema.call(input)
  return Success(validation_result.to_h) if validation_result.success?
  Failure(failure_validation_value)
end