Class: Farce::Internal::DryTypes::CollectionType

Inherits:
Object
  • Object
show all
Includes:
Dry::Types::Builder, Dry::Types::Type
Defined in:
lib/farce/integrations/dry_types.rb

Overview

A regular dry type that constructs a Farce value.

Direct Known Subclasses

AtomType, MapType, SequenceType

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#source ⇒ Dry::Types::Type (readonly)

The dry type evaluated before Farce construction.

Returns:

  • (Dry::Types::Type) —

    The source type.



147
148
149
 
# File 'lib/farce/integrations/dry_types.rb', line 147

def source
  @source
end

Instance Method Details

#call(input = ::Dry::Types::Undefined) {|partial| ... } ⇒ Object? Also known as: []

Apply validation, coercion, and Farce construction to input.

Parameters:

  • input (Object) (defaults to: ::Dry::Types::Undefined) —

    The input value.

Yields:

  • (partial) —

    Handle a coercion or construction failure.

Yield Parameters:

  • partial (Object) —

    The partial value supplied by dry-types.

Yield Returns:

  • (Object) —

    The fallback returned instead of a Farce value.

Returns:

  • (Object, nil) —

    The Farce value, nil for an optional type, or the failure block result.



179
 
# File 'lib/farce/integrations/dry_types.rb', line 179

def call(input = ::Dry::Types::Undefined, &) = @type.call(input, &)

#constrained? ⇒ Boolean

Report whether this type contains constraints.

Returns:

  • (Boolean) —

    Whether constraints are present.



236
 
# File 'lib/farce/integrations/dry_types.rb', line 236

def constrained? = @type.constrained?

#default? ⇒ Boolean

Report whether this is a default type.

Returns:

  • (Boolean) —

    Whether a default is configured.



232
 
# File 'lib/farce/integrations/dry_types.rb', line 232

def default? = @type.default?

#inspect ⇒ String

Return the wrapped dry type representation.

Returns:

  • (String) —

    The printable type representation.



266
 
# File 'lib/farce/integrations/dry_types.rb', line 266

def inspect = @type.inspect

#meta ⇒ Hash #meta(data) ⇒ CollectionType

Read or extend this type's metadata.

Overloads:

  • #meta ⇒ Hash

    Returns The current metadata.

    Returns:

    • (Hash) —

      The current metadata.

  • #meta(data) ⇒ CollectionType

    Returns A collection type carrying the metadata.

    Parameters:

    • data (Hash) —

      Metadata to merge into the source type.

    Returns:



279
280
281
282
283
 
# File 'lib/farce/integrations/dry_types.rb', line 279

def meta(data = ::Dry::Types::Undefined)
  return @type.meta if ::Dry::Types::Undefined.equal?(data)

  self.class.new(source.meta(data), kind:, configuration:)
end

#name ⇒ String

Return the output type name.

Returns:

  • (String) —

    The Farce class or optional union name.



228
 
# File 'lib/farce/integrations/dry_types.rb', line 228

def name = @type.name

#optional? ⇒ Boolean

Report whether this type accepts nil.

Returns:

  • (Boolean) —

    Whether the type is optional.



240
 
# File 'lib/farce/integrations/dry_types.rb', line 240

def optional? = @type.optional?

#primitive?(input) ⇒ Boolean

Test whether a value is accepted by the output type.

Parameters:

  • input (Object) —

    The value to test.

Returns:

  • (Boolean) —

    Whether the value is a configured Farce object or accepted nil.



219
 
# File 'lib/farce/integrations/dry_types.rb', line 219

def primitive?(input) = @type.primitive?(input)

#pristine ⇒ CollectionType

Return a new type without source metadata.

Returns:



287
 
# File 'lib/farce/integrations/dry_types.rb', line 287

def pristine = self.class.new(source.pristine, kind:, configuration:)

#to_ast(meta: true) ⇒ Array

Return the dry-types abstract syntax tree.

Parameters:

  • meta (Boolean) (defaults to: true) —

    Whether metadata is included.

Returns:

  • (Array) —

    The type AST.



258
 
# File 'lib/farce/integrations/dry_types.rb', line 258

def to_ast(meta: true) = @type.to_ast(meta:)

#to_proc ⇒ Proc

Convert this type to a callable object.

Returns:

  • (Proc) —

    A proc that applies the type.



262
 
# File 'lib/farce/integrations/dry_types.rb', line 262

def to_proc = proc { call(it) }

#try(input) {|failure| ... } ⇒ Dry::Types::Result, Object

Try to construct a Farce value and return a dry-types result.

Parameters:

  • input (Object) —

    The value to process.

Yields:

  • (failure) —

    Handle a failed attempt.

Yield Parameters:

  • failure (Dry::Types::Result::Failure) —

    The failure result.

Yield Returns:

  • (Object) —

    The fallback result.

Returns:

  • (Dry::Types::Result, Object) —

    The result or failure block value.



203
 
# File 'lib/farce/integrations/dry_types.rb', line 203

def try(input, &) = @type.try(input, &)

#valid?(input = ::Dry::Types::Undefined) ⇒ Boolean Also known as: ===

Test whether input can produce a valid Farce value.

Parameters:

  • input (Object) (defaults to: ::Dry::Types::Undefined) —

    The value to test.

Returns:

  • (Boolean) —

    Whether applying the type succeeds.



208
 
# File 'lib/farce/integrations/dry_types.rb', line 208

def valid?(input = ::Dry::Types::Undefined) = @type.valid?(input)

#with(mode: UNDEFINED, scope: UNDEFINED, **source_options) ⇒ CollectionType

Return a new Farce type with different output or source options.

Parameters:

  • mode (Symbol) (defaults to: UNDEFINED) —

    The transfer mode for the shared variant.

  • scope (Symbol) (defaults to: UNDEFINED) —

    The storage scope for the local variant.

  • source_options (Hash) —

    Options forwarded to the source dry type.

Returns:

Raises:

  • (ArgumentError) —

    If the Farce type does not support the requested output option.



295
296
297
298
299
 
# File 'lib/farce/integrations/dry_types.rb', line 295

def with(mode: UNDEFINED, scope: UNDEFINED, **source_options)
  configured = configuration.with(kind:, mode:, scope:)
  next_source = source_options.empty? ? source : source.with(**source_options)
  self.class.new(next_source, kind:, configuration: configured)
end