mangrove 0.34.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1dfe08aeea0151d419caef995589fe18b98674aeb78817f651d58eef0b45e552
-  data.tar.gz: 070b2971e1f62072b6e26289fe7e04f0f5527c414db63664cb76ef82c19b9ffd
+  metadata.gz: b672fc8a3a469a1d00a066bbc9781acbfd0229e5acf40f4d05452a3db9bd6ff2
+  data.tar.gz: 1fd9cdd284c43bbceb6b0bc44d21f358cc85d9fef1a5a3d6e9244529aa072279
 SHA512:
-  metadata.gz: 75bc64b315237e3e0c44ce8245a13e4562daf2ac2444cd3aff98151869f3c3f796259b9f62ab3d3b5fc2a58749033e3839e44d86785c20f0ec1a6b3a51e23474
-  data.tar.gz: 60204fffda1d393f5d1b6b0c893c29757d66c14c149685b0e138d2b1e86926da61784315f789c45dcec549dd564cc87f0c7166f9c5f259ce9de05081d41ddac2
+  metadata.gz: c85f28b501f523e3d541a19a64cc560f252ce72479e1df036b75c09dfec4d43843169a614922ce1aece40867434cd5b471aaa2e4eb37337f8694f38971dc491f
+  data.tar.gz: a806cd4beb648c60e7e5ceed320ca63d0e9033b7d940fc14fbd0a3254b44b2a657704cf5ee82097aad991b11d7bf0285f99fa0bbe1946ecb5492e6f49f76fe1b

data/.rubocop.yml

@@ -35,6 +35,7 @@ Naming/VariableNumber:
   EnforcedStyle: snake_case
 
 Style/BlockDelimiters:
+  Enabled: false
   EnforcedStyle: always_braces
   AllowedMethods:
   - describe

data/README.md

@@ -2,18 +2,18 @@
 
 Mangrove is a Ruby toolkit that brings a functional, statically-typed flavor to your Sorbet-enabled projects. Inspired by concepts from languages like Rust and Haskell, Mangrove provides a robust set of tools—primarily `Result` and ADT-like Enums—to help you write safer, more expressive Ruby code.
 
-- **[Documentation](https://kazzix14.github.io/mangrove/docs/)**
-- **[Coverage](https://kazzix14.github.io/mangrove/coverage/index.html#_AllFiles)**
+- [Documentation](https://kazzix14.github.io/mangrove/docs/)
+- [Coverage](https://kazzix14.github.io/mangrove/coverage/index.html#_AllFiles)
 
 ---
 
 ## Highlights
 
 - **Sorbet Integration**
-  Built from the ground up to work smoothly with Sorbet’s type system.
+  Built from the ground up to work smoothly with Sorbet's type system.
 
 - **Result Type**
-  Model success/failure outcomes with explicit types—no more “return false or nil” for errors!
+  Model success/failure outcomes with explicit types—no more "return false or nil" for errors!
 
 - **Enums (ADTs)**
   Define your own sealed enums with typed variants. Each variant can hold distinct inner data.
@@ -33,17 +33,17 @@ bundle add mangrove
 
 ## Usage Overview
 
-Mangrove revolves around **`Result`** and a sealed “Enum” mechanism for ADTs.
+Mangrove revolves around **`Result`** and a sealed "Enum" mechanism for ADTs.
 
 ### Result
 
 A `Result` is either `Ok(T)` or `Err(E)`. You can compose them with monadic methods like `and_then` and `or_else`.
-For “early returns” in a functional style, you have two main approaches:
+For "early returns" in a functional style, you have two main approaches:
 
 1. **A context-based DSL (e.g., `ctx.try!`)**
 2. **An instance method on `Result` itself, `unwrap_in(ctx)`**, which behaves similarly.
 
-Here’s an example of chaining requests and short-circuiting on error:
+Here's an example of chaining requests and short-circuiting on error:
 
 ```ruby
 class MyClient
@@ -87,6 +87,32 @@ end
 # More chaining, etc...
 ```
 
+### Extension Methods
+
+Mangrove provides convenient extension methods through `Mangrove::Result::Ext`. These methods allow you to easily wrap any value in a `Result`:
+
+```ruby
+# Include the extension in your classes
+class Object
+  include Mangrove::Result::Ext
+end
+
+# Now you can use in_ok and in_err on any object
+"success".in_ok  # => Result::Ok("success")
+"error".in_err   # => Result::Err("error")
+
+# Useful in method chains
+"hello"
+  .upcase
+  .in_ok
+  .map_ok { |s| "#{s}!" }  # => Result::Ok("HELLO!")
+
+# Error case
+"error message"
+  .in_err
+  .map_err { |e| "#{e}!" } # => Result::Err("error message!")
+```
+
 ### Enums (ADTs)
 
 Define an enum with typed variants:

data/lib/mangrove/result/ext.rb

@@ -0,0 +1,18 @@
+# typed: true
+# frozen_string_literal: true
+
+module Mangrove
+  module Result
+    module Ext
+      extend T::Sig
+
+      def in_ok
+        Mangrove::Result::Ok.new(self)
+      end
+
+      def in_err
+        Mangrove::Result::Err.new(self)
+      end
+    end
+  end
+end

data/lib/mangrove/result.rb

@@ -2,6 +2,7 @@
 # frozen_string_literal: true
 
 require_relative "result/control_signal"
+require_relative "result/ext"
 
 module Mangrove
   # Result is a type that represents either success (`Ok`) or failure (`Err`).

data/lib/mangrove/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Mangrove
-  VERSION = "0.34.0"
+  VERSION = "0.35.0"
 end

data/lib/tapioca/dsl/compilers/mangrove_result_ext.rb

@@ -0,0 +1,40 @@
+# typed: strict
+# frozen_string_literal: true
+
+require "mangrove/result/ext"
+require "tapioca/dsl"
+require "sorbet-runtime"
+
+module Tapioca
+  module Compilers
+    class MangroveResultExt < Tapioca::Dsl::Compiler
+      extend T::Sig
+
+      ConstantType = type_member { { fixed: T.class_of(Mangrove::Result::Ext) } }
+
+      sig { override.returns(T::Enumerable[Module]) }
+      def self.gather_constants
+        all_classes.select { |c| c < ::Mangrove::Result::Ext }
+      end
+
+      sig { override.void }
+      def decorate
+        return unless valid_constant_name?(constant.to_s)
+
+        root.create_path(constant) do |klass|
+          klass.create_method("in_ok", return_type: "Mangrove::Result::Ok[#{constant}]")
+          klass.create_method("in_err", return_type: "Mangrove::Result::Err[#{constant}]")
+        end
+      rescue NameError
+        # 握りつぶす
+      end
+
+      private
+
+      sig { params(string: String).returns(T::Boolean) }
+      def valid_constant_name?(string)
+        Object.const_defined?(string) && !!(string =~ /\A[A-Z][a-zA-Z0-9_]*\z/)
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangrove
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Kazuma Murata
@@ -46,8 +46,10 @@ files:
 - lib/mangrove/option/control_signal.rb
 - lib/mangrove/result.rb
 - lib/mangrove/result/control_signal.rb
+- lib/mangrove/result/ext.rb
 - lib/mangrove/version.rb
 - lib/tapioca/dsl/compilers/mangrove_enum.rb
+- lib/tapioca/dsl/compilers/mangrove_result_ext.rb
 - rbi/mangrove.rbi
 - sig/mangrove.rbs
 - sorbet/config