mandate 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c40c3c78438f78715fd0ada9e47b9e9e3b9c9245d43bf29624d486b568852ab
-  data.tar.gz: 8954343effdf23246d4d6359c9792ea12720a1573a41ff35fec8ff3a21dea564
+  metadata.gz: 6da8270b314f00464d035de5d4693038ca29de9a55bca052597931c3afaa44b7
+  data.tar.gz: ebd1428fb13336073a2d4a2d9c32c73b777683b99b69c8941b82f7cb94bd61cf
 SHA512:
-  metadata.gz: 63abfab520970461986313ecf404becb3e3689ef62ddc57ffd1d90c4b91440ec211c1335744c1a700ba6602fab5303eca2109b8bd8e7c1c04bd2b82a26ff5fac
-  data.tar.gz: fde32f5e6816c618ad6e88bfa1114729519a1eae8a24fe0462a4a7741951c43bcbe05aa86a93a57c7e911471ac4454f4bba15ee18a6526825a6f3b4e0ddb5cf8
+  metadata.gz: 5a12088967f35d7469fe02657be46005e7fbb927b34c398bd59eaeeebed92d1ee4e68b87ead2f79712e62c2d699b223bec56314100e2752c23bcbfb5910bced7
+  data.tar.gz: b3ecb3e7a5cf4f00ca8619570627a451668d05e993cfeea56e3ed0ca2e4f5cf9c6325453695c5b15aa3e279de0d54fe53bbb5fe62c20abf7da62998bf8e94d51

data/CHANGELOG.md

@@ -1,6 +1,11 @@
+# 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 code base for Ruby 3 (thanks to @erikschierboom)
+- [FEATURE] Simplify codebase for Ruby 3 (thanks to @erikschierboom)
 
 # 0.3.0 / 2019-09-06
 

data/README.md

@@ -28,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
@@ -50,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...
+
+```ruby
+MODELS = ...
+
+class Foobar
+  def initialize(model, color: "blue", owner: )
+    @model = model
+    @color = color
+    @owner = owner
 
-private
-attr_reader :foo, :bar
+    raise unless MODELS[model].colors.include?(color)
+  end
+
+  private
+  attr_reader :model, :color, :owner
+end
 ```
 
 ### Using on_success/on_failure callbacks

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 = "2.0.0".freeze
+  VERSION = "2.1.0".freeze
 end

data/mandate.gemspec

@@ -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: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Jeremy Walker
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-04-19 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