dry-types v1.5.1 Release Notes

Release Date: 2021-02-16 // 8 months ago
  • ๐Ÿ›  Fixed

    • โž• Add missing requires for internal usage of Dry::Equalizer (@timriley in #418)

    Compare v1.5.0...v1.5.1


Previous changes from v1.5.0

  • โž• Added

    • Wrapping constructor types :tada: (@flash-gordon)

    Constructor blocks can have a second argument. The second argument is the underlying type itself:

      age_from_year = Dry::Types['coercible.integer'].constructor do |input, type|
        Date.today.year - type.(input)
      end
      age_from_year.('2000') # => 21
    

    With wrapping constructors you have control over "type application". You can even run it more than once:

      inc = Dry::Types['integer'].constructor(&:succ)
      inc2x = inc.constructor { _2.(_2.(_2.(_1))) }
      inc2x.(10) # => 13
    
    • Fallbacks :tada: (@flash-gordon)
      age = Dry::Types['coercible.ineger'].fallback(18)
      age.('10') # => 10
      age.('20') # => 20
      age.('abc') # => 18
    

    Fallbacks are different from default values: the later will be evaluated only when no input provided.

    Under the hood, .fallback creates a wrapping constructor.

    • params.string as an alias for strict.string. This addition should be non-breaking (@flash-gordon)
    • ๐Ÿ— API for defining custom type builders similar to .default, .constructor, or .optional (@flash-gordon)
      # Making an alias for `.fallback`
      Dry::Types.define_builder(:or) { |type, v| type.fallback(v) }
    
      # Using new builder
      type = Dry::Types['integer'].or(-273)
      type.(:invalid) # => -273
    

    ๐Ÿ”„ Changed

    • ๐Ÿ—„ Inferring predicates from class names is deprecated. It's very unlikely your code depends on it, however, if it does, you'll get an exception with instructions. (@flash-gordon)

    If you don't rely on inferring, just disable it with:

      Dry::Types::PredicateInferrer::Compiler.infer_predicate_by_class_name false
    

    Otherwise, enable it explicitly:

      Dry::Types::PredicateInferrer::Compiler.infer_predicate_by_class_name true
    

    Compare v1.4.0...v1.5.0