dry-types v1.5.1 Release Notes

Release Date: 2021-02-16 // over 1 year 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)
      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