mandate 1.0.0.beta1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3777f95eea23613ab020fee91200b2d2f74b158827c1c48920b7351718466d1
-  data.tar.gz: 13f9b05d1beb3ee5327301877f12055ce9e8a4237a96980fadf23a5e1d642806
+  metadata.gz: 6da8270b314f00464d035de5d4693038ca29de9a55bca052597931c3afaa44b7
+  data.tar.gz: ebd1428fb13336073a2d4a2d9c32c73b777683b99b69c8941b82f7cb94bd61cf
 SHA512:
-  metadata.gz: fa01cdd428d030e7eec7581318726731f2d3c72f8e7034876a3e9d1ae97f26a12a67c41ba9a80d115e260d7c1160d3e8018e5159151d67b57873598538628b23
-  data.tar.gz: 23f4e7d68149d6d4d27d4de21d82c9b64d64a2c420197e1cbc7bc1e9972a900a303b1d20a516bb44b3b7c95834576e34287308ac48914fafe284d70be09c7dd6
+  metadata.gz: 5a12088967f35d7469fe02657be46005e7fbb927b34c398bd59eaeeebed92d1ee4e68b87ead2f79712e62c2d699b223bec56314100e2752c23bcbfb5910bced7
+  data.tar.gz: b3ecb3e7a5cf4f00ca8619570627a451668d05e993cfeea56e3ed0ca2e4f5cf9c6325453695c5b15aa3e279de0d54fe53bbb5fe62c20abf7da62998bf8e94d51

data/.github/workflows/rubocop.yml

@@ -14,9 +14,9 @@ jobs:
       - uses: actions/checkout@v2
 
       - name: Set up Ruby
-        uses: ruby/setup-ruby@42817531497ae2ef0168458f709e451109306bd5
+        uses: ruby/setup-ruby@4726835508d9debb3220096c92d7bf6388485faa
         with:
-          ruby-version: 2.6.6
+          ruby-version: '3.1.0'
 
       - name: Install gems
         run: |

data/.github/workflows/tests.yml

@@ -15,13 +15,13 @@ jobs:
       matrix:
         os:
           - ubuntu-20.04
-        ruby-version: [2.6, 2.7, 3.0]
+        ruby-version: ['3.0', '3.1']
 
     steps:
       - uses: actions/checkout@v2
 
       - name: Set up Ruby
-        uses: ruby/setup-ruby@42817531497ae2ef0168458f709e451109306bd5
+        uses: ruby/setup-ruby@4726835508d9debb3220096c92d7bf6388485faa
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true

data/.rubocop.yml

@@ -3,6 +3,7 @@ require:
   - rubocop-performance
 
 AllCops:
+  TargetRubyVersion: 3.0.0
   NewCops: disable
   Exclude:
     - "bin/**/*"

data/.ruby-version

@@ -1 +1 @@
-2.6.6
+3.1.0

data/CHANGELOG.md

@@ -1,5 +1,16 @@
+# 2.1.0 / 2022-04-23
+
+- [FEATURE] Change initialize_with to take a block which is run after variables are set.
+- [FEATURE] Add optional kwarg specified by using Mandate::NO_DEFAULT.
+
+# 2.0.0 / 2022-04-19
+
+- [FEATURE] Simplify codebase for Ruby 3 (thanks to @erikschierboom)
+
 # 0.3.0 / 2019-09-06
-* [FEATURE] Add success/failure callbacks
+
+- [FEATURE] Add success/failure callbacks
 
 # 0.2.0 / 2018-08-11
-* [FEATURE] Add initialize_with
+
+- [FEATURE] Add initialize_with

data/README.md

@@ -4,6 +4,8 @@
 
 A simple command-pattern helper gem for Ruby.
 
+**Note: As of 2.0.0, Mandate only supports Ruby 3.x. For Ruby 2.x, please use the 1.0.0 release.**
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -26,7 +28,7 @@ Or install it yourself as:
 class Multiplies
   include Mandate
 
-  initialize_with :number_1, :number_2
+  initialize_with :number_1, number_2: 0
 
   def call
     do_the_maths
@@ -48,17 +50,38 @@ Multiplies.(20, 3)
 ### `initialize_with`
 
 The `initialize_with` method creates an initializer and private attr_readers for the specified variables.
+Keyword arguments can be expressed normally, but arguments without default values must be specified with the value `Mandate::NO_DEFAULT`.
+The call also takes a block, which is run after the variables are set.
 
-For example `initialize_with :foo, :bar` is the equivalent of:
+For example, this...
 
 ```ruby
-def initialize(foo, bar)
-  @foo = foo
-  @bar = bar
+MODELS = ...
+
+class Car
+  initialize_with :model, color: "blue", owner: Mandate::NO_DEFAULT do
+    raise unless MODELS[model].colors.include?(color)
+  end
 end
+```
+
+...is the equivalent of...
 
-private
-attr_reader :foo, :bar
+```ruby
+MODELS = ...
+
+class Foobar
+  def initialize(model, color: "blue", owner: )
+    @model = model
+    @color = color
+    @owner = owner
+
+    raise unless MODELS[model].colors.include?(color)
+  end
+
+  private
+  attr_reader :model, :color, :owner
+end
 ```
 
 ### Using on_success/on_failure callbacks

data/lib/mandate/call_injector.rb

@@ -6,16 +6,8 @@ module Mandate
       # which internally calls:
       #   Foobar.new(some, args).call()
       class << base
-        def call(*args)
-          # If the last argument is a hash and the last param is a keyword params (signified by
-          # its type being :key, the we should pass the hash in in using the **kwords syntax.
-          # This fixes a deprecation issue in Ruby 2.7.
-          if args.last.is_a?(Hash) &&
-             instance_method(:initialize).parameters.last&.first == :key
-            new(*args[0..-2], **args[-1]).()
-          else
-            new(*args).()
-          end
+        def call(...)
+          new(...).()
         end
       end
     end

data/lib/mandate/initializer_injector.rb

@@ -1,34 +1,35 @@
+require 'securerandom'
+
 module Mandate
+  NO_DEFAULT = SecureRandom.uuid
+
   module InitializerInjector
     def self.extended(base)
       class << base
-        def initialize_with(*attrs, **kwattrs)
-          if kwattrs.empty?
-            define_method :initialize do |*args|
-              unless args.length == attrs.length
-                raise ArgumentError, "wrong number of arguments (given #{args.length}, expected #{attrs.length})"
-              end
+        def initialize_with(*attrs, **kwattrs, &block)
+          define_method :initialize do |*args, **kwargs|
+            unless args.length == attrs.length
+              raise ArgumentError, "wrong number of arguments (given #{args.length}, expected #{attrs.length})"
+            end
 
-              attrs.zip(args).each do |attr, arg|
-                instance_variable_set("@#{attr}", arg)
-              end
+            attrs.zip(args).each do |attr, arg|
+              instance_variable_set("@#{attr}", arg)
             end
-          else
-            define_method :initialize do |*args, **kwargs|
-              unless args.length == attrs.length
-                raise ArgumentError, "wrong number of arguments (given #{args.length}, expected #{attrs.length})"
-              end
 
-              attrs.zip(args).each do |attr, arg|
-                instance_variable_set("@#{attr}", arg)
-              end
+            kwargs.each do |name, value|
+              raise ArgumentError, "unknown keyword: #{name}" unless kwattrs.key?(name)
 
-              kwargs.each do |name, value|
-                raise ArgumentError, "unknown keyword: #{name}" unless kwattrs.key?(name)
+              instance_variable_set("@#{name}", value)
+            end
 
-                instance_variable_set("@#{name}", value)
-              end
+            kwattrs.each do |key, value|
+              next unless value == NO_DEFAULT
+              next if kwargs.key?(key)
+
+              raise ArgumentError, "Keyword argument was not specified: #{key}"
             end
+
+            instance_eval(&block) if block
           end
 
           attrs.each do |attr|

data/lib/mandate/version.rb

@@ -1,3 +1,3 @@
 module Mandate
-  VERSION = "1.0.0.beta1".freeze
+  VERSION = "2.1.0".freeze
 end

data/mandate.gemspec

@@ -3,7 +3,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "mandate/version"
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = '>= 2.6.0'
+  spec.required_ruby_version = '>= 3.0.0'
   spec.name          = "mandate"
   spec.version       = Mandate::VERSION
   spec.authors       = ["Jeremy Walker"]
@@ -23,5 +23,6 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 2.1"
   spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency 'mocha'
   spec.add_development_dependency "rake", "~> 12.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mandate
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta1
+  version: 2.1.0
 platform: ruby
 authors:
 - Jeremy Walker
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-02-25 00:00:00.000000000 Z
+date: 2022-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  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: rake
   requirement: !ruby/object:Gem::Requirement
@@ -95,14 +109,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: A simple command-pattern helper gem for Ruby