contracted_value 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 910e3c46d5bcd1d4f7bce77cc41b89468ee2a3e7fce57bd281a484eb8e114c48
-  data.tar.gz: 488d7ca201c5e973ae5e183154ecb917561d756af14533caa4f06b2f2889c9ac
+  metadata.gz: 26c83184ecb824d29bc3d258555f6f915d0478e7e1d5e8dde8bf8a21935b69a4
+  data.tar.gz: 73caf82b999e6e65cd158316982f5051a19f219eabe85e96434c98be72d973ca
 SHA512:
-  metadata.gz: 208de749d05602d4914bcd9257ff6d902c9bcb3882c1a44ee2f52aab6b5fa6a1889e5a98743a2b2a64f750aac1d15b373599616b82d810ad6798c53fa3e14c85
-  data.tar.gz: d89f379d4f35f69ab269713852194cf04b276db8d25ef08cc602deadcb7148dc03b240711cc9709f2d56a6b9a799ee2253e93d16d5b44f3da9cef45a115b73aa
+  metadata.gz: b712d12af9079d88a5d44c56aaad07fa8e29ae56bed4f37f6fdcd5f36ab2c1e392e1afc56b1e84e98ef9d621a16843ca407dc31002345761c74e16e2301654cc
+  data.tar.gz: eece1cec55a0e03b15da9c7c97d4b8dc5aa55f3e7138ecc5448a2f0b36bcc73da5f6e0b245f4c1d03819342cdee0c39de2c8516afeae47d671bb8db841d8af80

data/.github/workflows/coverage.yml

@@ -26,7 +26,8 @@ jobs:
         os:
           - ubuntu-latest
         ruby:
-          - "3.2"
+          - "3.4"
+          - "4.0"
         gemfile:
           - gemfiles/contracts_17_0.gemfile
     env:
@@ -35,7 +36,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1

data/.github/workflows/tests.yaml

@@ -26,9 +26,11 @@ jobs:
         os:
           - ubuntu-latest
         ruby:
-          - "3.0"
           - "3.1"
           - "3.2"
+          - "3.3"
+          - "3.4"
+          - "4.0"
         gemfile:
           - gemfiles/contracts_17_0.gemfile
         allow_failures:
@@ -45,7 +47,7 @@ jobs:
     continue-on-error: ${{ endsWith(matrix.ruby, 'head') || matrix.ruby == 'debug' }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:

data/CHANGELOG.md

@@ -3,7 +3,8 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
 
-## [Unreleased] - NOW
+## [Unreleased]
+[Unreleased]: https://github.com/PikachuEXE/contracted_value/compare/v0.2.0...master
 
 ### Added
 
@@ -18,7 +19,17 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Nothing
 
 
+## [0.2.0] - 2026-04-29
+[0.2.0]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.2.0
+
+### Added
+
+- Add feature detect_unexpected_keys
+  (https://github.com/PikachuEXE/contracted_value/pull/9)
+
+
 ## [0.1.3] - 2023-10-11
+[0.1.3]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.3
 
 ### Fixed
 
@@ -27,6 +38,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 
 ## [0.1.2] - 2023-10-11
+[0.1.2]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.2
 
 ### Changed
 
@@ -36,6 +48,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 
 ## [0.1.1] - 2022-09-07
+[0.1.1]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.1
 
 ### Changed
 
@@ -47,12 +60,8 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 
 ## [0.1.0] - 2019-06-05
+[0.1.0]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.0
 
 ### Added
 
 - Initial release
-
-[0.1.3]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.3
-[0.1.2]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.2
-[0.1.1]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.1
-[0.1.0]: https://github.com/PikachuEXE/contracted_value/releases/tag/v0.1.0

data/README.md

@@ -247,6 +247,35 @@ WhatIsThis::Entry.new(
 ).something_optional # => nil
 ```
 
+#### Unexpected keys
+Call `detect_unexpected_keys` to detect unexpected keys by raising error  
+It's off by default  
+
+
+```ruby
+module ::WhatIsThis
+  class Entry < ::ContractedValue::Value
+    include ::Contracts::Core
+    include ::Contracts::Builtin
+
+    detect_unexpected_keys
+
+    attribute(
+      :something_required,
+    )
+    attribute(
+      :something_optional,
+      default_value: nil,
+    )
+  end
+end
+
+WhatIsThis::Entry.new(
+  something_required: 123,
+  something_unexpected: "whatever",
+) # => error
+```
+
 
 ### Object Freezing
 All input values are frozen using [`ice_nine`](https://github.com/dkubb/ice_nine) by default  
@@ -353,6 +382,10 @@ Pikachu.new.name.frozen? # => true, as mentioned above default value are always
 Pikachu.new(name: "Pikaaaachuuu").name.frozen? # => false
 ```
 
+#### `detect_unexpected_keys` inherited
+If parent class already called `detect_unexpected_keys`, all children classes would have it enabled too  
+Otherwise you can call `detect_unexpected_keys` in child class(es) without affecting parent class  
+
 
 ## Related gems
 Here is a list of gems which I found and I have tried some of them.  

data/Rakefile

@@ -7,7 +7,7 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-if !ENV["APPRAISAL_INITIALIZED"] && !ENV["TRAVIS"]
+if !ENV["APPRAISAL_INITIALIZED"] && !ENV["CI"]
   task :default do
     sh "appraisal install && rake appraisal spec"
   end

data/contracted_value.gemspec

@@ -38,7 +38,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency "appraisal", "~> 2.0", ">= 2.5.0"
 
   s.add_development_dependency "rspec", "~> 3.0"
-  s.add_development_dependency "rspec-its", "~> 1.0"
+  s.add_development_dependency "rspec-its", "~> 2.0"
 
   s.add_development_dependency "simplecov", ">= 0.21"
   s.add_development_dependency "simplecov-lcov", ">= 0.8"
@@ -52,4 +52,8 @@ Gem::Specification.new do |s|
   s.required_ruby_version = ">= 3.0.0"
 
   s.required_rubygems_version = ">= 1.4.0"
+
+  # requiring all owners to enable MFA on their account
+  # https://guides.rubygems.org/mfa-requirement-opt-in/
+  s.metadata["rubygems_mfa_required"] = "true"
 end

data/lib/contracted_value/core.rb

@@ -79,6 +79,16 @@ module ContractedValue
         )
       end
     end
+
+    class UnexpectedInputKeys < ArgumentError
+      def initialize(keys)
+        super(
+          <<~MSG
+            Unexpected key(s) #{keys.map{|key| ":#{key}" }.join(", ")} detected in input
+          MSG
+        )
+      end
+    end
   end
 
   module Private
@@ -112,6 +122,10 @@ module ContractedValue
       end
     end
 
+    def detect_unexpected_keys(hash)
+      hash.keys - attr_names
+    end
+
     protected
 
     def merge!(other_attr_set)
@@ -238,7 +252,8 @@ module ContractedValue
           )
         end
 
-      self.class.send(:attribute_set).each_attribute do |attribute|
+      attribute_set = self.class.send(:attribute_set)
+      attribute_set.each_attribute do |attribute|
         attr_value = attribute.extract_value(input_attr_values_hash)
 
         sometimes_frozen_attr_value =
@@ -266,6 +281,15 @@ module ContractedValue
         )
       end
 
+      if self.class.send(:should_detect_unexpected_keys)
+        unexpected_keys = attribute_set.detect_unexpected_keys(input_attr_values_hash)
+        if unexpected_keys.any?
+          raise Errors::UnexpectedInputKeys.new(
+            unexpected_keys,
+          )
+        end
+      end
+
       freeze
     end
     # rubocop:enable Metrics/AbcSize
@@ -280,10 +304,19 @@ module ContractedValue
 
     # == Class interface == #
     class << self
-      def inherited(klass)
+      def inherited(child_klass)
         super
 
-        klass.instance_variable_set(:@attribute_set, AttributeSet.new)
+        child_klass.instance_variable_set(:@attribute_set, AttributeSet.new)
+        child_klass.instance_variable_set(
+          :@should_detect_unexpected_keys,
+          if child_klass.superclass.respond_to?(:should_detect_unexpected_keys, true)
+            child_klass.superclass.send(:should_detect_unexpected_keys)
+          else
+            false
+          end
+        )
+
       end
 
       private
@@ -326,6 +359,14 @@ module ContractedValue
         # @attribute_set would be nil
         super_attribute_set.merge(@attribute_set || AttributeSet.new)
       end
+
+      # @api
+      def detect_unexpected_keys
+        @should_detect_unexpected_keys = true
+      end
+
+      # @api private
+      attr_reader :should_detect_unexpected_keys
     end
     # == Class interface == #
   end

data/lib/contracted_value/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContractedValue
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

data/spec/contracted_value/value_spec.rb

@@ -48,12 +48,13 @@ require "spec_helper"
       }.to_not raise_error
     end
 
-    example "does not raise error when declaring 1 attribute with number name" do
+    example "does raise error when declaring 1 attribute with number name" do
       expect {
         value_class.class_eval do
           attribute(1)
         end
-      }.to raise_error(::NoMethodError, /undefined method `to_sym'/)
+      }.to raise_error(::NoMethodError, /undefined method `to_sym'|undefined method 'to_sym'/)
+      # ruby 3.4+ uses different quotes
     end
   end
 
@@ -83,6 +84,12 @@ require "spec_helper"
           }
         end
 
+        let(:inputs_with_extra) do
+          default_inputs.merge(
+            attribute_3: 1,
+          )
+        end
+
         let(:non_hash) do
           []
         end
@@ -156,6 +163,30 @@ require "spec_helper"
             end
           end
         end
+
+        it "does not raise error when extra attribute is input" do
+          aggregate_failures do
+            expect {
+              value_class.new(
+                inputs_with_extra,
+              )
+            }.to_not raise_error
+          end
+        end
+
+        it "does not raise error when extra attribute is input" do
+          aggregate_failures do
+            value_class.class_eval do
+              detect_unexpected_keys
+            end
+
+            expect {
+              value_class.new(
+                inputs_with_extra,
+              )
+            }.to raise_error(::ContractedValue::Errors::UnexpectedInputKeys)
+          end
+        end
       end
 
       context "with class with some attributes declared with contract" do
@@ -621,6 +652,7 @@ require "spec_helper"
             end
             child_value_class.new(attribute_1: "")
           }.to raise_error(::ContractedValue::Errors::InvalidAttributeValue)
+          # Note that the error above is for the input not the attribute declaration
         end
 
         example "does not raise error when declaring existing attribute with different default_value" do
@@ -651,6 +683,66 @@ require "spec_helper"
 
     end
 
+    describe "for detect_unexpected_keys" do
+      let(:child_value_class) do
+        Class.new(parent_value_class)
+      end
+
+      context "when detect_unexpected_keys declared inside parent class" do
+        let(:parent_value_class) do
+          Class.new(described_class).tap do |klass|
+            klass.class_eval do
+              detect_unexpected_keys
+
+              # Too lazy to include parent attributes in all examples
+              attribute(:attribute_1)
+            end
+          end
+        end
+
+        it "does raise error on parent class object" do
+          expect {
+            parent_value_class.new(attribute_1: 1, attribute_2: 2)
+          }.to raise_error(::ContractedValue::Errors::UnexpectedInputKeys)
+        end
+
+        it "does raise error on child class object" do
+          expect {
+            child_value_class.new(attribute_1: 1, attribute_2: 2)
+          }.to raise_error(::ContractedValue::Errors::UnexpectedInputKeys)
+        end
+      end
+
+      context "when detect_unexpected_keys declared inside child class" do
+        let(:parent_value_class) do
+          Class.new(described_class).tap do |klass|
+            klass.class_eval do
+              # Too lazy to include parent attributes in all examples
+              attribute(:attribute_1)
+            end
+          end
+        end
+
+        before do
+          child_value_class.class_eval do
+            detect_unexpected_keys
+          end
+        end
+
+        it "does not raise error on parent class object" do
+          expect {
+            parent_value_class.new(attribute_1: 1, attribute_2: 2)
+          }.to_not raise_error
+        end
+
+        it "does raise error on child class object" do
+          expect {
+            child_value_class.new(attribute_1: 1, attribute_2: 2)
+          }.to raise_error(::ContractedValue::Errors::UnexpectedInputKeys)
+        end
+      end
+    end
+
   end
 
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: contracted_value
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - PikachuEXE
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: contracts
@@ -126,14 +125,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -238,8 +237,8 @@ files:
 homepage: http://github.com/PikachuEXE/contracted_value
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -254,8 +253,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.4.0
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 4.0.9
 specification_version: 4
 summary: Contracted immutable(by default) value objects
 test_files: