dry-monads 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ccc6809b903aa20a600330e62b86d8164da8394f2b7c63740d6708c73386578
-  data.tar.gz: a1c92edd9908da609bfe9048bf5ca1220d1f7e4c2cc894df9ea025e7df578625
+  metadata.gz: 4c3b21d3e3072a7a21013aa3fc863b50e1aca7707122980adcc5313bff792743
+  data.tar.gz: 9b3df76a0c3ce66eb88e8e1bf6b66804f43268b56cb407310944ca7e51614469
 SHA512:
-  metadata.gz: 9286042f25cbb89f74d7159ef238cb834f7dddc74890c7d575978a14bd69d8d95aa46728c0f7dbfa81507af068cba4f3efa871eed9ec60d95da62db6f9810320
-  data.tar.gz: d723b367ba2014fa7bf907316dd93cff45be330329c83281a8640aaaa480a83c20e222d8d89736caf6acc6675c61927e3e54bf0ecb1b4df73ec1d5e2999f0d9a
+  metadata.gz: 4056e685a4f47e8168fc97ddb4d773ad5f257d9fcc9d484e35221016961ccb525c475b0f20a9ac48ea7f7a14bfbd6ebe98b4672d7695c687efb3ffd8ebd6244b
+  data.tar.gz: 28740b0f45b4e782b9def280eb1f527ce2d970a901d60d883129c31338e481ebb9190836ceb63330e555958a873185d9ae6ad869edd22ab3623975564328d30f

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 <!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
+## 1.7.0 2025-01-07
+
+
+### Fixed
+
+- Fix pattern matching for `Try` values (@alexkalderimis)
+
+### Changed
+
+- Set 3.1 as minimum Ruby version (@flash-gordon)
+
+[Compare v1.6.0...v1.7.0](https://github.com/dry-rb/dry-monads/compare/v1.6.0...v1.7.0)
+
 ## 1.6.0 2022-11-04
 
 

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2022 dry-rb team
+Copyright (c) 2015-2023 dry-rb team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/README.md

@@ -1,29 +1,21 @@
 <!--- this file is synced from dry-rb/template-gem project -->
 [gem]: https://rubygems.org/gems/dry-monads
 [actions]: https://github.com/dry-rb/dry-monads/actions
-[codacy]: https://www.codacy.com/gh/dry-rb/dry-monads
-[chat]: https://dry-rb.zulipchat.com
-[inchpages]: http://inch-ci.org/github/dry-rb/dry-monads
 
-# dry-monads [![Join the chat at https://dry-rb.zulipchat.com](https://img.shields.io/badge/dry--rb-join%20chat-%23346b7a.svg)][chat]
-
-[![Gem Version](https://badge.fury.io/rb/dry-monads.svg)][gem]
-[![CI Status](https://github.com/dry-rb/dry-monads/workflows/ci/badge.svg)][actions]
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/f2eed41bf7f04b38b0a7691c2cf6e73c)][codacy]
-[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/f2eed41bf7f04b38b0a7691c2cf6e73c)][codacy]
-[![Inline docs](http://inch-ci.org/github/dry-rb/dry-monads.svg?branch=main)][inchpages]
+# dry-monads [![Gem Version](https://badge.fury.io/rb/dry-monads.svg)][gem] [![CI Status](https://github.com/dry-rb/dry-monads/workflows/CI/badge.svg)][actions]
 
 ## Links
 
 * [User documentation](https://dry-rb.org/gems/dry-monads)
 * [API documentation](http://rubydoc.info/gems/dry-monads)
+* [Forum](https://discourse.dry-rb.org)
 
 ## Supported Ruby versions
 
 This library officially supports the following Ruby versions:
 
-* MRI `>= 2.7.0`
-* jruby `>= 9.3` (postponed until 2.7 is supported)
+* MRI `>= 3.1`
+* jruby `>= 9.4` (not tested on CI)
 
 ## License
 

data/dry-monads.gemspec

@@ -21,19 +21,16 @@ Gem::Specification.new do |spec|
   spec.executables   = []
   spec.require_paths = ["lib"]
 
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-monads/blob/main/CHANGELOG.md"
-  spec.metadata["source_code_uri"]   = "https://github.com/dry-rb/dry-monads"
-  spec.metadata["bug_tracker_uri"]   = "https://github.com/dry-rb/dry-monads/issues"
+  spec.metadata["allowed_push_host"]     = "https://rubygems.org"
+  spec.metadata["changelog_uri"]         = "https://github.com/dry-rb/dry-monads/blob/main/CHANGELOG.md"
+  spec.metadata["source_code_uri"]       = "https://github.com/dry-rb/dry-monads"
+  spec.metadata["bug_tracker_uri"]       = "https://github.com/dry-rb/dry-monads/issues"
+  spec.metadata["rubygems_mfa_required"] = "true"
 
-  spec.required_ruby_version = ">= 2.7.0"
+  spec.required_ruby_version = ">= 3.1.0"
 
   # to update dependencies edit project.yml
-  spec.add_runtime_dependency "concurrent-ruby", "~> 1.0"
-  spec.add_runtime_dependency "dry-core", "~> 1.0", "< 2"
-  spec.add_runtime_dependency "zeitwerk", "~> 2.6"
-
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec"
+  spec.add_dependency "concurrent-ruby", "~> 1.0"
+  spec.add_dependency "dry-core", "~> 1.1"
+  spec.add_dependency "zeitwerk", "~> 2.6"
 end

data/lib/dry/monads/conversion_stubs.rb

@@ -4,7 +4,7 @@ module Dry
   module Monads
     module ConversionStubs
       def self.[](*method_names)
-        Module.new do
+        ::Module.new do
           method_names.each do |name|
             define_method(name) do |*|
               Methods.public_send(name)

data/lib/dry/monads/do/all.rb

@@ -153,5 +153,18 @@ module Dry
 
     require "dry/monads/registry"
     register_mixin(:do, Do::All)
+
+    if ::Gem::Version.new(::RUBY_VERSION) >= ::Gem::Version.new("3.4.0")
+      ::Warning.singleton_class.prepend(::Module.new {
+        def warn(message, category: nil)
+          if message.include?("lib/dry/monads/do.rb") &&
+            message.include?("warning: the block passed to")
+            nil
+          else
+            super
+          end
+        end
+      })
+    end
   end
 end

data/lib/dry/monads/errors.rb

@@ -23,7 +23,7 @@ module Dry
     class ConstructorNotAppliedError < ::NoMethodError
       def initialize(method_name, constructor_name)
         super(
-          "For calling .#{method_name} on #{constructor_name}() build a value "\
+          "For calling .#{method_name} on #{constructor_name}() build a value " \
           "by appending parens: #{constructor_name}()"
         )
       end

data/lib/dry/monads/lazy.rb

@@ -13,11 +13,11 @@ module Dry
 
       class << self
         # @private
-        def new(promise = nil, &block)
+        def new(promise = nil, &)
           if promise
             super(promise)
           else
-            super(Concurrent::Promise.new(executor: :immediate, &block))
+            super(Concurrent::Promise.new(executor: :immediate, &))
           end
         end
 
@@ -27,9 +27,7 @@ module Dry
       # Forces the compution and returns its value.
       #
       # @return [Object]
-      def value!
-        @promise.execute.value!
-      end
+      def value! = @promise.execute.value!
       alias_method :force!, :value!
 
       # Forces the computation. Note that if the computation
@@ -42,23 +40,22 @@ module Dry
       end
 
       # @return [Boolean]
-      def evaluated?
-        @promise.complete?
-      end
+      def evaluated? = @promise.complete?
       deprecate :complete?, :evaluated?
 
       undef_method :wait
 
       # @return [String]
       def to_s
-        state = case promise.state
-                when :fulfilled
-                  value!.inspect
-                when :rejected
-                  "!#{promise.reason.inspect}"
-                else
-                  "?"
-                end
+        state =
+          case promise.state
+          when :fulfilled
+            value!.inspect
+          when :rejected
+            "!#{promise.reason.inspect}"
+          else
+            "?"
+          end
 
         "Lazy(#{state})"
       end
@@ -79,9 +76,7 @@ module Dry
           #
           # @param block [Proc]
           # @return [Lazy]
-          def Lazy(&block)
-            Lazy.new(&block)
-          end
+          def Lazy(&) = Lazy.new(&)
         end
 
         include Constructors

data/lib/dry/monads/list.rb

@@ -9,9 +9,7 @@ module Dry
         #
         # @param values [Array<Object>] List elements
         # @return [List]
-        def [](*values)
-          new(values)
-        end
+        def [](*values) = new(values)
 
         # Coerces a value to a list. `nil` will be coerced to an empty list.
         #
@@ -144,9 +142,7 @@ module Dry
       #
       # @param other [List] Other list
       # @return [List]
-      def +(other)
-        List.new(to_ary + other.to_ary)
-      end
+      def +(other) = List.new(to_ary + other.to_ary)
 
       # Returns a string representation of the list.
       #
@@ -167,24 +163,18 @@ module Dry
       # Returns the first element.
       #
       # @return [Object]
-      def first
-        value.first
-      end
+      def first = value.first
 
       # Returns the last element.
       #
       # @return [Object]
-      def last
-        value.last
-      end
+      def last = value.last
 
       # Folds the list from the left.
       #
       # @param initial [Object] Initial value
       # @return [Object]
-      def fold_left(initial, &block)
-        value.reduce(initial, &block)
-      end
+      def fold_left(initial, &) = value.reduce(initial, &)
       alias_method :foldl, :fold_left
       alias_method :reduce, :fold_left
 
@@ -200,52 +190,38 @@ module Dry
       # Whether the list is empty.
       #
       # @return [TrueClass, FalseClass]
-      def empty?
-        value.empty?
-      end
+      def empty? = value.empty?
 
       # Sorts the list.
       #
       # @return [List]
-      def sort
-        coerce(value.sort)
-      end
+      def sort = coerce(value.sort)
 
       # Filters elements with a block
       #
       # @return [List]
-      def filter(&block)
-        coerce(value.select(&block))
-      end
+      def filter(&) = coerce(value.select(&))
       alias_method :select, :filter
 
       # List size.
       #
       # @return [Integer]
-      def size
-        value.size
-      end
+      def size = value.size
 
       # Reverses the list.
       #
       # @return [List]
-      def reverse
-        coerce(value.reverse)
-      end
+      def reverse = coerce(value.reverse)
 
       # Returns the first element wrapped with a `Maybe`.
       #
       # @return [Maybe<Object>]
-      def head
-        Monads::Maybe.coerce(value.first)
-      end
+      def head = Monads::Maybe.coerce(value.first)
 
       # Returns list's tail.
       #
       # @return [List]
-      def tail
-        coerce(value.drop(1))
-      end
+      def tail = coerce(value.drop(1))
 
       # Turns the list into a typed one.
       # Type is required for some operations like .traverse.
@@ -258,8 +234,8 @@ module Dry
             raise ArgumentError, "Cannot infer a monad for an empty list"
           else
             self.class.warn(
-              "Automatic monad inference is deprecated, pass a type explicitly "\
-              "or use a predefined constant, e.g. List::Result\n"\
+              "Automatic monad inference is deprecated, pass a type explicitly " \
+              "or use a predefined constant, e.g. List::Result\n" \
               "#{caller.find { _1 !~ %r{(lib/dry/monads)|(gems)} }}"
             )
             self.class.new(value, value[0].monad)
@@ -272,9 +248,7 @@ module Dry
       # Whether the list is types
       #
       # @return [Boolean]
-      def typed?
-        !type.nil?
-      end
+      def typed? = !type.nil?
 
       # Traverses the list with a block (or without it).
       # This methods "flips" List structure with the given monad (obtained from the type).
@@ -305,24 +279,20 @@ module Dry
       #
       # @param list [List]
       # @return [List]
-      def apply(list = Undefined, &block)
-        v = Undefined.default(list, &block)
+      def apply(list = Undefined, &)
+        v = Undefined.default(list, &)
         fmap(Curry).bind { |f| v.fmap { f.(_1) } }
       end
 
       # Returns the List monad.
       #
       # @return [Monad]
-      def monad
-        List
-      end
+      def monad = List
 
       # Returns self.
       #
       # @return [List]
-      def to_monad
-        self
-      end
+      def to_monad = self
 
       # Iterates over the list and collects Some values.
       #
@@ -367,15 +337,11 @@ module Dry
       #   end
       #
       # @api private
-      def deconstruct
-        value
-      end
+      def deconstruct = value
 
       private
 
-      def coerce(other)
-        self.class.coerce(other)
-      end
+      def coerce(other) = self.class.coerce(other)
 
       # Empty list
       EMPTY = List.new([].freeze).freeze
@@ -388,17 +354,11 @@ module Dry
 
         attr_reader :type
 
-        def initialize(type)
-          @type = type
-        end
+        def initialize(type) = @type = type
 
-        def [](*args)
-          List.new(args, type)
-        end
+        def [](*args) = List.new(args, type)
 
-        def coerce(value)
-          List.coerce(value, type)
-        end
+        def coerce(value) = List.coerce(value, type)
 
         def pure(val = Undefined, &block)
           value = Undefined.default(val, block)
@@ -433,9 +393,7 @@ module Dry
 
         # List constructor.
         # @return [List]
-        def List(value)
-          List.coerce(value)
-        end
+        def List(value) = List.coerce(value)
       end
     end
 

data/lib/dry/monads/maybe.rb

@@ -46,38 +46,28 @@ module Dry
       end
 
       # Returns true for an instance of a {Maybe::None} monad.
-      def none?
-        is_a?(None)
-      end
+      def none? = is_a?(None)
       alias_method :failure?, :none?
 
       # Returns true for an instance of a {Maybe::Some} monad.
-      def some?
-        is_a?(Some)
-      end
+      def some? = is_a?(Some)
       alias_method :success?, :some?
 
       # Returns self, added to keep the interface compatible with that of Either monad types.
       #
       # @return [Maybe::Some, Maybe::None]
-      def to_maybe
-        self
-      end
+      def to_maybe = self
 
       # Returns self.
       #
       # @return [Maybe::Some, Maybe::None]
-      def to_monad
-        self
-      end
+      def to_monad = self
 
       # Returns the Maybe monad.
       # This is how we're doing polymorphism in Ruby 😕
       #
       # @return [Monad]
-      def monad
-        Maybe
-      end
+      def monad = Maybe
 
       # Represents a value that is present, i.e. not nil.
       #
@@ -96,9 +86,7 @@ module Dry
         #    end
         #
         # @api public
-        def self.[](*value)
-          new(value)
-        end
+        def self.[](*value) = new(value)
 
         def initialize(value = Undefined)
           raise ArgumentError, "nil cannot be some" if value.nil?
@@ -124,11 +112,11 @@ module Dry
           if next_value.nil?
             if self.class.warn_on_implicit_nil_coercion
               Core::Deprecations.warn(
-                "Block passed to Some#fmap returned `nil` and was chained to None. "\
-                "This is literally an unlawful behavior and it will not be supported in "\
-                "dry-monads 2. \nPlease, replace `.fmap` with `.maybe` in places where you "\
-                "expect `nil` as block result.\n"\
-                "You can opt out of these warnings with\n"\
+                "Block passed to Some#fmap returned `nil` and was chained to None. " \
+                "This is literally an unlawful behavior and it will not be supported in " \
+                "dry-monads 2. \nPlease, replace `.fmap` with `.maybe` in places where you " \
+                "expect `nil` as block result.\n" \
+                "You can opt out of these warnings with\n" \
                 "Dry::Monads::Maybe.warn_on_implicit_nil_coercion false",
                 uplevel: 0,
                 tag: :"dry-monads"
@@ -151,9 +139,7 @@ module Dry
         # @param args [Array<Object>] arguments will be transparently passed through to #bind
         # @return [Maybe::Some, Maybe::None] Wrapped result, i.e. nil will be mapped to None,
         #                                    other values will be wrapped with Some
-        def maybe(...)
-          Maybe.coerce(bind(...))
-        end
+        def maybe(...) = Maybe.coerce(bind(...))
 
         # Accepts a block and runs it against the wrapped value.
         # If the block returns a trurhy value the result is self,
@@ -246,26 +232,19 @@ module Dry
         # @param args [Array<Object>] arguments will be passed to the underlying `#or` call
         # @return [Maybe::Some, Maybe::None] Lifted `#or` result, i.e. nil will be mapped to None,
         #                                    other values will be wrapped with Some
-        def or_fmap(...)
-          Maybe.coerce(self.or(...))
-        end
+        def or_fmap(...) = Maybe.coerce(self.or(...))
 
         # @return [String]
-        def to_s
-          "None"
-        end
+        def to_s = "None"
         alias_method :inspect, :to_s
 
         # @api private
-        def eql?(other)
-          other.is_a?(None)
-        end
+        def eql?(other) = other.is_a?(None)
+
         alias_method :==, :eql?
 
         # @private
-        def hash
-          None.instance.object_id
-        end
+        def hash = None.instance.object_id
 
         # Pattern matching
         #
@@ -277,16 +256,12 @@ module Dry
         #   end
         #
         # @api private
-        def deconstruct
-          EMPTY_ARRAY
-        end
+        def deconstruct = EMPTY_ARRAY
 
         # @see Maybe::Some#filter
         #
         # @return [Maybe::None]
-        def filter(_ = Undefined)
-          self
-        end
+        def filter(_ = Undefined) = self
       end
 
       # A module that can be included for easier access to Maybe monads.
@@ -302,9 +277,7 @@ module Dry
         module Constructors
           # @param value [Object] the value to be stored in the monad
           # @return [Maybe::Some, Maybe::None]
-          def Maybe(value)
-            Maybe.coerce(value)
-          end
+          def Maybe(value) = Maybe.coerce(value)
 
           # Some constructor
           #
@@ -322,9 +295,7 @@ module Dry
           end
 
           # @return [Maybe::None]
-          def None
-            None.new(RightBiased::Left.trace_caller)
-          end
+          def None = None.new(RightBiased::Left.trace_caller)
         end
 
         include Constructors
@@ -393,9 +364,7 @@ module Dry
 
       class Failure < Result
         # @return [Maybe::None]
-        def to_maybe
-          Maybe::None.new(trace)
-        end
+        def to_maybe = Maybe::None.new(trace)
       end
     end
 
@@ -415,16 +384,12 @@ module Dry
     class Try
       class Value < Try
         # @return [Maybe]
-        def to_maybe
-          Dry::Monads::Maybe(@value)
-        end
+        def to_maybe = ::Dry::Monads::Maybe(@value)
       end
 
       class Error < Try
         # @return [Maybe::None]
-        def to_maybe
-          Maybe::None.new(RightBiased::Left.trace_caller)
-        end
+        def to_maybe = Maybe::None.new(RightBiased::Left.trace_caller)
       end
     end
 
@@ -433,18 +398,14 @@ module Dry
         # Converts to Maybe::Some
         #
         # @return [Maybe::Some]
-        def to_maybe
-          Maybe.pure(value!)
-        end
+        def to_maybe = Maybe.pure(value!)
       end
 
       class Invalid < Validated
         # Converts to Maybe::None
         #
         # @return [Maybe::None]
-        def to_maybe
-          Maybe::None.new(RightBiased::Left.trace_caller)
-        end
+        def to_maybe = Maybe::None.new(RightBiased::Left.trace_caller)
       end
     end
 

data/lib/dry/monads/registry.rb

@@ -43,9 +43,7 @@ module Dry
       end
 
       # @private
-      def known_monads
-        @constants.keys
-      end
+      def known_monads = @constants.keys
 
       # @private
       def load_monad(name)
@@ -59,15 +57,13 @@ module Dry
 
       # @private
       def constructors
-        @constructors ||= registry.values.filter_map { |m|
+        @constructors ||= registry.values.filter_map do |m|
           m::Constructors if m.const_defined?(:Constructors)
-        }
+        end
       end
 
       # @private
-      def all_loaded?
-        registry.size.eql?(@constants.size)
-      end
+      def all_loaded? = registry.size.eql?(@constants.size)
     end
   end
 end

data/lib/dry/monads/result/fixed.rb

@@ -8,11 +8,9 @@ module Dry
       # @see Monads#Result
       # @private
       class Fixed < ::Module
-        def self.[](error, **options)
-          new(error, **options)
-        end
+        def self.[](error, **options) = new(error, **options)
 
-        def initialize(error, **_options)
+        def initialize(error, **)
           super()
 
           @mod = ::Module.new do