dry-operation 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5b39cd9624408d00958a649070927f493af015cd79d64815edeae30e2b82993
-  data.tar.gz: 9d12151f5a48051502dc88a7c7152819dd7a7baed354088c414f4e698e7ef28a
+  metadata.gz: cc1e7ef446a048939d8e419f77946db6f9ee7621ddad0fed3108fa03129426d9
+  data.tar.gz: e45c7a1c4dc5f3baf42897396c227f34481446a2e3721d9ed4fc5f6a8497b4d9
 SHA512:
-  metadata.gz: c57e54507bcf2f601a2f172a125da654f788b5481aa8d4b60e3025129cc6c88c270853947998ebf997fdae4f52833f6a06288115be9c3bd1678a34f4bc52f86f
-  data.tar.gz: 5baa6f1508f60b8bf64b3ea8409caec2fc58707e153373fbcecbd0dec6b2bcc8dc9e280d641d84501dbe52145c0be3237018fa99f05be958626aecdbf718081e
+  metadata.gz: 4b914c5124f131eb116ce48e919cc38c0cc00c5f70893ae9629c7eb72dd8e35dcd6e709bcf262019104310d4c0035da7e0097b8ee715bdd5585a57458dd6f315
+  data.tar.gz: 4a7d4c96fce72d09f18e4da94dc2db0e49fb1cf99b3acc4ca56f1fbb0e3d9baeed1a862ea0bdf282128afc1d81135175bdbeca469e2605337edbb04c38befd62

data/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Break Versioning](https://www.taoensso.com/break-versioning).
+
+## [Unreleased]
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+[Unreleased]: https://github.com/dry-rb/dry-operation/compare/v1.1.0...main
+
+## [1.1.0] - 2026-02-06
+
+### Changed
+
+- In Rom extension, allow transaction options to be passed via `#transaction`. (@wuarmin in #37)
+    ```ruby
+    # Set options at extension time (used for all transactions within the class):
+    include Dry::Operation::Extensions::ROM[isolation: :serializable]
+
+    # Or per-transaction, in instance methods. These will be merged with the extension-level
+    # options.
+    transaction(savepoint: true) do
+      # This transaction will have options `isolation: :serializable, savepoint: true`
+    end
+    ```
+
+[1.1.0]: https://github.com/dry-rb/dry-operation/compare/v1.0.1...v1.1.0
+
+## [1.0.1] - 2025-10-24
+
+### Changed
+
+- Define `#transaction` method in extension modules themselves (which are included into the operation class), rather than directly on the operation class itself. This adheres to typical Ruby inheritance-based method lookup, and allows for overloads of `#transaction` to be defined directly in the operation class or mixed in via other modules. (@timriley in #33)
+
+[1.0.1]: https://github.com/dry-rb/dry-operation/compare/v1.0.0...v1.0.1
+
+## 1.0.0 - 2024-11-02
+
+### Added
+
+- Initial release. (@waiting-for-dev)

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2024 dry-rb team
+Copyright (c) 2015-2026 Hanakai 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,14 +1,17 @@
-[gem]: https://rubygems.org/gems/dry-operation
+<!--- This file is synced from hanakai-rb/repo-sync -->
+
+[rubygem]: https://rubygems.org/gems/dry-operation
 [actions]: https://github.com/dry-rb/dry-operation/actions
 
-# dry-operation [![Gem Version](https://badge.fury.io/rb/dry-operation.svg)][gem] [![Continuous Integration](https://github.com/dry-rb/dry-operation/actions/workflows/ci.yml/badge.svg)][actions]
+# dry-operation [![Gem Version](https://badge.fury.io/rb/dry-operation.svg)][rubygem] [![CI Status](https://github.com/dry-rb/dry-operation/workflows/CI/badge.svg)][actions]
 
 ## Links
 
-* [User documentation](https://dry-rb.org/gems/dry-operation)
-* [API documentation](http://rubydoc.info/gems/dry-operation)
-* [Forum](https://discourse.dry-rb.org)
+- [User documentation](https://dry-rb.org/gems/dry-operation)
+- [API documentation](http://rubydoc.info/gems/dry-operation)
+- [Forum](https://discourse.dry-rb.org)
 
 ## License
 
-See [`LICENSE`](LICENSE).
+See `LICENSE` file.
+

data/dry-operation.gemspec

@@ -1,31 +1,40 @@
 # frozen_string_literal: true
 
+# This file is synced from hanakai-rb/repo-sync. To update it, edit repo-sync.yml.
+
 lib = File.expand_path("lib", __dir__)
-$LOAD_PATH.prepend(lib) unless $LOAD_PATH.include?(lib)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "dry/operation/version"
 
 Gem::Specification.new do |spec|
-  spec.name = "dry-operation"
-  spec.version = Dry::Operation::VERSION
-  spec.authors = ["dry-rb team"]
-  spec.email = ["gems@dry-rb.org"]
-  spec.homepage = "https://dry-rb.org/gems/dry-operation"
-  spec.summary = "A domain specific language for composable business transaction workflows."
-  spec.license = "MIT"
-
-  spec.metadata = {
-    "bug_tracker_uri" => "https://github.com/dry-rb/dry-operation/issues",
-    "changelog_uri" => "https://github.com/dry-rb/dry-operation/blob/main/CHANGELOG.md",
-    "documentation_uri" => "https://dry-rb.org/gems/dry-operation",
-    "funding_uri" => "https://github.com/sponsors/hanami",
-    "label" => "dry-operation",
-    "source_code_uri" => "https://github.com/dry-rb/dry-operation"
-  }
+  spec.name          = "dry-operation"
+  spec.authors       = ["Hanakai team"]
+  spec.email         = ["info@hanakai.org"]
+  spec.license       = "MIT"
+  spec.version       = Dry::Operation::VERSION.dup
+
+  spec.summary       = "A domain specific language for composable business transaction workflows."
+  spec.description   = spec.summary
+  spec.homepage      = "https://dry-rb.org/gems/dry-operation"
+  spec.files         = Dir["CHANGELOG.md", "LICENSE", "README.md", "dry-operation.gemspec", "lib/**/*"]
+  spec.bindir        = "exe"
+  spec.executables   = Dir["exe/*"].map { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.extra_rdoc_files = ["README.md", "CHANGELOG.md", "LICENSE"]
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-operation/blob/main/CHANGELOG.md"
+  spec.metadata["source_code_uri"]   = "https://github.com/dry-rb/dry-operation"
+  spec.metadata["bug_tracker_uri"]   = "https://github.com/dry-rb/dry-operation/issues"
+  spec.metadata["funding_uri"]       = "https://github.com/sponsors/hanami"
 
   spec.required_ruby_version = ">= 3.1.0"
-  spec.add_dependency "zeitwerk", "~> 2.6"
-  spec.add_dependency "dry-monads", "~> 1.6"
 
-  spec.extra_rdoc_files = Dir["README*", "LICENSE*"]
-  spec.files = Dir["*.gemspec", "lib/**/*"]
+  spec.add_runtime_dependency "dry-monads", "~> 1.6"
+  spec.add_runtime_dependency "zeitwerk", "~> 2.6"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "yard"
 end
+

data/lib/dry/operation/extensions/active_record.rb

@@ -96,33 +96,34 @@ module Dry
             @options = options
           end
 
-          def included(klass)
-            class_exec(@connection, @options) do |default_connection, options|
-              # @!method transaction(connection = ActiveRecord::Base, **options, &steps)
-              #   Wrap the given steps in an ActiveRecord transaction.
-              #
-              #   If any of the steps returns a `Dry::Monads::Result::Failure`, the
-              #   transaction will be rolled back and `:halt` will be thrown with the
-              #   failure as its value.
-              #
-              #   @param connection [#transaction] The class/object to use
-              #   @param options [Hash] Additional options for the ActiveRecord transaction
-              #   @yieldreturn [Object] the result of the block
-              #   @see Dry::Operation#steps
-              #   @see https://api.rubyonrails.org/classes/ActiveRecord/ConnectionAdapters/DatabaseStatements.html#method-i-transaction
-              klass.define_method(:transaction) do |connection = default_connection, **opts, &steps|
-                intercepting_failure do
-                  result = nil
-                  connection.transaction(**options.merge(opts)) do
-                    intercepting_failure(->(failure) {
-                                           result = failure
-                                           raise ::ActiveRecord::Rollback
-                                         }) do
-                      result = steps.()
-                    end
+          def included(_klass)
+            default_connection = @connection
+            default_options = @options
+
+            # @!method transaction(connection = ActiveRecord::Base, **options, &steps)
+            #   Wrap the given steps in an ActiveRecord transaction.
+            #
+            #   If any of the steps returns a `Dry::Monads::Result::Failure`, the
+            #   transaction will be rolled back and `:halt` will be thrown with the
+            #   failure as its value.
+            #
+            #   @param connection [#transaction] The class/object to use
+            #   @param options [Hash] Additional options for the ActiveRecord transaction
+            #   @yieldreturn [Object] the result of the block
+            #   @see Dry::Operation#steps
+            #   @see https://api.rubyonrails.org/classes/ActiveRecord/ConnectionAdapters/DatabaseStatements.html#method-i-transaction
+            define_method(:transaction) do |connection = default_connection, **opts, &steps|
+              intercepting_failure do
+                result = nil
+                connection.transaction(**default_options.merge(opts)) do
+                  intercepting_failure(->(failure) {
+                    result = failure
+                    raise ::ActiveRecord::Rollback
+                  }) do
+                    result = steps.()
                   end
-                  result
                 end
+                result
               end
             end
           end

data/lib/dry/operation/extensions/rom.rb

@@ -9,15 +9,14 @@ end
 module Dry
   class Operation
     module Extensions
-      # Add rom transaction support to operations
+      # Add Rom transaction support to operations.
       #
-      # When this extension is included, you can use a `#transaction` method
-      # to wrap the desired steps in a rom transaction. If any of the steps
-      # returns a `Dry::Monads::Result::Failure`, the transaction will be rolled
-      # back and, as usual, the rest of the flow will be skipped.
+      # When this extension is included, you can use a `#transaction` method to wrap the desired
+      # steps in a Rom transaction. If any of the steps returns a `Dry::Monads::Result::Failure`,
+      # the transaction will be rolled back and, as usual, the rest of the flow will be skipped.
       #
-      # The extension expects the including class to give access to the rom
-      # container via a `#rom` method.
+      # The extension expects the including class to give access to the Rom container via a `#rom`
+      # method.
       #
       # ```ruby
       # require "dry/operation/extensions/rom"
@@ -46,18 +45,27 @@ module Dry
       # end
       # ```
       #
-      # By default, the `:default` gateway will be used. You can change this
-      # when including the extension:
+      # By default, the `:default` gateway will be used and no additional
+      # options will be passed to the Rom transaction.
+      #
+      # You can change the default gateway and transaction options when
+      # including the extension:
       #
       # ```ruby
-      # include Dry::Operation::Extensions::ROM[gateway: :my_gateway]
+      # include Dry::Operation::Extensions::ROM[
+      #   gateway: :my_gateway,
+      #   isolation: :serializable
+      # ]
       # ```
       #
-      # Or you can change it at runtime:
+      # You can also override the gateway and/or transaction options at runtime:
       #
       # ```ruby
-      # user = transaction(gateway: :my_gateway) do
-      #  # ...
+      # user = transaction(
+      #   gateway: :my_gateway,
+      #   isolation: :serializable
+      # ) do
+      #   # ...
       # end
       # ```
       #
@@ -84,37 +92,39 @@ module Dry
         # Include the extension providing a custom gateway
         #
         # @param gateway [Symbol] the rom gateway to use
-        def self.[](gateway: DEFAULT_GATEWAY)
-          Builder.new(gateway: gateway)
+        def self.[](gateway: DEFAULT_GATEWAY, **options)
+          Builder.new(gateway: gateway, **options)
         end
 
         # @api private
         class Builder < Module
-          def initialize(gateway:)
+          def initialize(gateway:, **options)
             super()
             @gateway = gateway
+            @options = options
           end
 
-          def included(klass)
-            class_exec(@gateway) do |default_gateway|
-              klass.define_method(:transaction) do |gateway: default_gateway, &steps|
-                raise Dry::Operation::ExtensionError, <<~MSG unless respond_to?(:rom)
-                  When using the ROM extension, you need to define a #rom method \
-                  that returns the ROM container
-                MSG
+          def included(_klass)
+            default_gateway = @gateway
+            default_options = @options
+
+            define_method(:transaction) do |gateway: default_gateway, **opts, &steps|
+              raise Dry::Operation::ExtensionError, <<~MSG unless respond_to?(:rom)
+                When using the Rom extension, you need to define a #rom method \
+                that returns the Rom container
+              MSG
 
-                intercepting_failure do
-                  result = nil
-                  rom.gateways[gateway].transaction do |t|
-                    intercepting_failure(->(failure) {
-                                           result = failure
-                                           t.rollback!
-                                         }) do
-                      result = steps.()
-                    end
+              intercepting_failure do
+                result = nil
+                rom.gateways[gateway].transaction(**default_options.merge(opts)) do |t|
+                  intercepting_failure(->(failure) {
+                                         result = failure
+                                         t.rollback!
+                                       }) do
+                    result = steps.()
                   end
-                  result
                 end
+                result
               end
             end
           end

data/lib/dry/operation/extensions/sequel.rb

@@ -81,26 +81,26 @@ module Dry
             @options = options
           end
 
-          def included(klass)
-            class_exec(@options) do |default_options|
-              klass.define_method(:transaction) do |**opts, &steps|
-                raise Dry::Operation::ExtensionError, <<~MSG unless respond_to?(:db)
-                  When using the Sequel extension, you need to define a #db method \
-                  that returns the Sequel database object
-                MSG
+          def included(_klass)
+            default_options = @options
 
-                intercepting_failure do
-                  result = nil
-                  db.transaction(**default_options.merge(opts)) do
-                    intercepting_failure(->(failure) {
-                      result = failure
-                      raise ::Sequel::Rollback
-                    }) do
-                      result = steps.()
-                    end
+            define_method(:transaction) do |**opts, &steps|
+              raise Dry::Operation::ExtensionError, <<~MSG unless respond_to?(:db)
+                When using the Sequel extension, you need to define a #db method \
+                that returns the Sequel database object
+              MSG
+
+              intercepting_failure do
+                result = nil
+                db.transaction(**default_options.merge(opts)) do
+                  intercepting_failure(->(failure) {
+                    result = failure
+                    raise ::Sequel::Rollback
+                  }) do
+                    result = steps.()
                   end
-                  result
                 end
+                result
               end
             end
           end

data/lib/dry/operation/version.rb

@@ -2,6 +2,6 @@
 
 module Dry
   class Operation
-    VERSION = "1.0.0"
+    VERSION = "1.1.0"
   end
 end

metadata

@@ -1,52 +1,95 @@
 --- !ruby/object:Gem::Specification
 name: dry-operation
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
-- dry-rb team
-autorequire:
-bindir: bin
+- Hanakai team
+bindir: exe
 cert_chain: []
-date: 2024-11-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: zeitwerk
+  name: dry-monads
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '1.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
-  name: dry-monads
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
-description:
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A domain specific language for composable business transaction workflows.
 email:
-- gems@dry-rb.org
+- info@hanakai.org
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.md
+- CHANGELOG.md
 - LICENSE
+- README.md
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - dry-operation.gemspec
@@ -63,13 +106,11 @@ homepage: https://dry-rb.org/gems/dry-operation
 licenses:
 - MIT
 metadata:
-  bug_tracker_uri: https://github.com/dry-rb/dry-operation/issues
+  allowed_push_host: https://rubygems.org
   changelog_uri: https://github.com/dry-rb/dry-operation/blob/main/CHANGELOG.md
-  documentation_uri: https://dry-rb.org/gems/dry-operation
-  funding_uri: https://github.com/sponsors/hanami
-  label: dry-operation
   source_code_uri: https://github.com/dry-rb/dry-operation
-post_install_message:
+  bug_tracker_uri: https://github.com/dry-rb/dry-operation/issues
+  funding_uri: https://github.com/sponsors/hanami
 rdoc_options: []
 require_paths:
 - lib
@@ -84,8 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A domain specific language for composable business transaction workflows.
 test_files: []