attribool 2.0.2 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d928a7ac0b90deb248cfcbb3a9b638baa6a38a8c62691c884df1e2db2f7c6d04
-  data.tar.gz: 525256019fd56a8bc53695c1772e6367fcb6dac0ac05da4a4f457431029d21d9
+  metadata.gz: d04f89c318e02c603522d41b99a64ef3cc228da4132ac58122abde616c955486
+  data.tar.gz: 9555723018f19c3a5fd8a77c86c975597c21ee8b525d9571977b8287d8685844
 SHA512:
-  metadata.gz: 3719316d9feaa069f64748a23ef1ba9531dbecb6b7cb3188e8292f9f70a7cdd3a262522b63a8a6c7b9673a232a3c6e2dc86953cba6527ea6c9727d5e32360c0f
-  data.tar.gz: 792822e7f8e5ee0242d8a60cd5ab0870613794a26652bcb7025dbdda5dd3500bee8004c66fdd297c8e0a26c0e6ec1a458967e69186a91a1795bb5ee92e65a4d6
+  metadata.gz: 64c66f2a26f7b2280f961b97ed373703e55696a1ae741032909355565da7313b9c166b04037855c062f76681234478d8d230ab9bc36114e288ed6a5ce61ccba4
+  data.tar.gz: 6287a1d91606e76e595c8b1670d1dff3066e313dc25f70ba5fbb0722a1a2601e7648f2ff9cd6899df84da504c02d4caa263e7a2fef4a9eca140c9b867c01234b

data/.github/workflows/ruby.yml

@@ -13,7 +13,7 @@ jobs:
 
     strategy:
       matrix:
-        ruby-version: ['3.2', '3.1', '3.0', '2.7', '2.6']
+        ruby-version: ['3.2', '3.1', '3.0']
 
     steps:
       - uses: actions/checkout@v3

data/.projections.json

@@ -0,0 +1,40 @@
+{
+  "lib/attribool/validators/*_validator.rb": {
+    "command": "validator",
+    "related": "lib/attribool/validator_service.rb",
+    "alternate": "test/attribool/validators/{}_test.rb",
+    "template": [
+      "# frozen_string_literal: true",
+      "",
+      "module Attribool::Validators",
+      "  ##",
+      "  # Ensures that {blank} is validated.",
+      "  class {capitalize|camelcase}Validator",
+      "    ##",
+      "    # Construct the validator.",
+      "    #",
+      "    # @param [Todo] todo",
+      "    def initialize(todo)",
+      "      @todo = todo",
+      "    end",
+      "",
+      "    ##",
+      "    # Todo?",
+      "    #",
+      "    # @return [Boolean]",
+      "    def valid?",
+      "      # TODO",
+      "    end",
+      "",
+      "    ##",
+      "    # The exception to raise if validations fail.",
+      "    #",
+      "    # @return [TodoError] the exception with message",
+      "    def error",
+      "      TodoError.new(\"todo\")",
+      "    end",
+      "  end",
+      "end"
+    ]
+  }
+}

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    attribool (2.0.2)
+    attribool (2.0.4)
 
 GEM
   remote: https://rubygems.org/

data/Rakefile

@@ -19,3 +19,48 @@ RDoc::Task.new do |rdoc|
 end
 
 task default: :test
+
+namespace :version do
+  desc "Print the current version from the version.rb file"
+  task :current do
+    puts Attribool::VERSION
+  end
+
+  namespace :increment do
+    desc "Increment the version's PATCH level"
+    task :patch do
+      File.join(__dir__, "lib", "attribool", "version.rb").then do |version_file|
+        File.write(
+          version_file,
+          File.read(version_file).sub(/(PATCH\s=\s)(\d+)/) { "#{$1}#{$2.next}" }
+        )
+      end
+      system("bundle lock")
+    end
+    desc "Increment the version's MINOR level"
+    task :minor do
+      File.join(__dir__, "lib", "attribool", "version.rb").then do |version_file|
+        File.write(
+          version_file,
+          File.read(version_file)
+            .sub(/(PATCH\s=\s)(\d+)/) { "#{$1}0" }
+            .sub(/(MINOR\s=\s)(\d+)/) { "#{$1}#{$2.next}" }
+        )
+      end
+      system("bundle lock")
+    end
+    desc "Increment the version's MAJOR level"
+    task :major do
+      File.join(__dir__, "lib", "attribool", "version.rb").then do |version_file|
+        File.write(
+          version_file,
+          File.read(version_file)
+            .sub(/(PATCH\s=\s)(\d+)/) { "#{$1}0" }
+            .sub(/(MINOR\s=\s)(\d+)/) { "#{$1}0" }
+            .sub(/(MAJOR\s=\s)(\d+)/) { "#{$1}#{$2.next}" }
+        )
+      end
+      system("bundle lock")
+    end
+  end
+end

data/lib/attribool/attribute_list.rb

@@ -1,11 +1,23 @@
 # frozen_string_literal: true
 
+require "forwardable"
+
 module Attribool
   ##
   # Enumerable class that generates a list of attributes from a list of strings
   # or symbols.
   class AttributeList
     include Enumerable
+    extend Forwardable
+
+    ##
+    # :method: each
+    # Yield every entry in the list to a block.
+    #
+    # @param [block] &block
+    #
+    # @return [Enumerable]
+    def_delegators :@entries, :each
 
     ##
     # Create an +AttributeList+ from a list of attribute names.
@@ -27,15 +39,5 @@ module Attribool
       ValidatorService.call(:attribute_list, *attributes)
       @entries = attributes
     end
-
-    ##
-    # Yield every entry in the list to a block.
-    #
-    # @param [block] &block
-    #
-    # @return [Enumerable]
-    def each(&block)
-      @entries.each(&block)
-    end
   end
 end

data/lib/attribool/validator_service.rb

@@ -1,17 +1,38 @@
 # frozen_string_literal: true
 
 module Attribool
+  ##
+  # A simple interface to run validators, which should implement a +valid?+
+  # method which returns true if conditions are valid, and an +error+ method
+  # which returns an exception class and message to be raised when validations
+  # fail.
   class ValidatorService
-    def self.call(validator, *args)
-      new(validator, *args).validate
+    ##
+    # Run the validator.
+    #
+    # @param [Symbol] validator_name
+    #
+    # @param [Object] *args to be forwarded to validator
+    def self.call(validator_name, *args)
+      new(::Attribool::Validators.fetch(validator_name), *args).validate
     end
 
+    ##
+    # Construct the service and inject the validator.
+    #
+    # @param [Class] Validator
+    #
+    # @param [Object] *args
     def initialize(validator, *args)
-      @validator = ::Attribool::Validators.const_get(
-        "#{validator.to_s.split("_").map(&:capitalize).join}Validator"
-      ).new(*args)
+      @validator = validator.new(*args)
     end
 
+    ##
+    # Raises the validator's exception unless its conditions are met.
+    #
+    # @return [Boolean]
+    #
+    # @raise [Exception] if validation fails
     def validate
       @validator.valid? || raise(@validator.error)
     end

data/lib/attribool/validators/attribute_list_validator.rb

@@ -1,15 +1,29 @@
 # frozen_string_literal: true
 
 module Attribool::Validators
+  ##
+  # Ensures that every item is an instance of +Attribool::Attribute+.
   class AttributeListValidator
+    ##
+    # Construct the validator.
+    #
+    # @param [Attribool::Attribute] *items
     def initialize(*items)
       @items = items
     end
 
+    ##
+    # Are all items an instance of +Attribool::Attribute+?
+    #
+    # @return [Boolean]
     def valid?
       @items.all?(Attribool::Attribute)
     end
 
+    ##
+    # The exception to raise if validations fail.
+    #
+    # @return [TypeError] the exception with message
     def error
       TypeError.new("All items must be an instance of Attribool::Attribute")
     end

data/lib/attribool/validators/condition_validator.rb

@@ -1,15 +1,29 @@
 # frozen_string_literal: true
 
 module Attribool::Validators
+  ##
+  # Ensures that a condition is either +nil+ or a +Proc+.
   class ConditionValidator
+    ##
+    # Construct the validator.
+    #
+    # @param [nil, Proc] condition
     def initialize(condition)
       @condition = condition
     end
 
+    ##
+    # Is the condition either +nil+ or a +Proc+?
+    #
+    # @return [Boolean]
     def valid?
       @condition.nil? || @condition.is_a?(Proc)
     end
 
+    ##
+    # The exception to raise if validations fail.
+    #
+    # @return [ArgumentError] the exception with message
     def error
       ArgumentError.new("Condition is not a proc")
     end

data/lib/attribool/validators/method_name_validator.rb

@@ -5,15 +5,25 @@ module Attribool::Validators
   # Ensures that if multiple attributes are being defined, and +method_name+
   # is provided, that +method_name+ is a +Proc+.
   class MethodNameValidator
+    ##
+    # Construct the validator.
+    #
+    # @param [Attribool::Attribute] *items
     def initialize(method_name, number_of_attributes)
       @method_name = method_name
       @number_of_attributes = number_of_attributes
     end
 
+    ##
+    # Is there either one attribute, or is +method_name+ +nil+ or a +Proc+?
     def valid?
       @number_of_attributes == 1 || nil_or_proc?
     end
 
+    ##
+    # The exception to raise if validations fail.
+    #
+    # @return [ArgumentError] the exception with message
     def error
       ArgumentError.new("Must use a Proc when creating multiple methods")
     end

data/lib/attribool/validators/nil_attribute_validator.rb

@@ -1,17 +1,35 @@
 # frozen_string_literal: true
 
 module Attribool::Validators
+  ##
+  # Ensures that a value is not +nil+, unless +nil+ is allowed as a value.
   class NilAttributeValidator
+    ##
+    # Construct the validator.
+    #
+    # @param [String, Symbol] ivar
+    #
+    # @param [Object] value
+    #
+    # @param [Boolean] allow_nil
     def initialize(ivar, value, allow_nil)
       @ivar = ivar
       @value = value
       @allow_nil = allow_nil
     end
 
+    ##
+    # Do we either allow values to be +nil+, or is the value not +nil+?
+    #
+    # @return [Boolean]
     def valid?
       @allow_nil || !@value.nil?
     end
 
+    ##
+    # The exception to raise if validations fail.
+    #
+    # @return [TypeError] the exception with message
     def error
       TypeError.new("#{@ivar} is nil")
     end

data/lib/attribool/validators/strict_boolean_validator.rb

@@ -1,16 +1,32 @@
 # frozen_string_literal: true
 
 module Attribool::Validators
+  ##
+  # Ensures that a value is a boolean, unless strictness isn't enforced.
   class StrictBooleanValidator
+    ##
+    # Construct the validator.
+    #
+    # @param [Object] value
+    #
+    # @param [Boolean] strict
     def initialize(value, strict)
       @value = value
       @strict = strict
     end
 
+    ##
+    # Is +strict+ set to +false+, or is +@value+ a boolean?
+    #
+    # @return [Boolean]
     def valid?
       !@strict || [TrueClass, FalseClass].include?(@value.class)
     end
 
+    ##
+    # The exception to raise if validations fail.
+    #
+    # @return [ArgumentError] the exception with message
     def error
       ArgumentError.new("#{@value} is not a boolean")
     end

data/lib/attribool/validators.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Attribool
+  ##
+  # Namespace for Validators. Also provides a method for fetching a validator.
+  module Validators
+    module_function
+
+    ##
+    # Fetches a Validator class.
+    #
+    # @param [String, Symbol] validator_name
+    #
+    # @return [Class]
+    #
+    # @example
+    #   Attribool::Validators.fetch(:nil_attribute)
+    #   # => NilAttributeValidator
+    def fetch(validator_name)
+      const_get(
+        "#{validator_name.to_s.split("_").map(&:capitalize).join}Validator"
+      )
+    end
+  end
+end

data/lib/attribool/value.rb

@@ -1,13 +1,25 @@
 # frozen_string_literal: true
 
 module Attribool
+  ##
+  # An abstraction of any class that can convert itself to a boolean.
   class Value
+    ##
+    # Construct the value with an optional +Proc+ condition.
+    #
+    # @param [Object] value
+    #
+    # @param [Proc] condition (default: nil)
     def initialize(value, condition = nil)
       ValidatorService.call(:condition, condition)
       @value = value
       @condition = condition
     end
 
+    ##
+    # Convert the value or the condition to a boolean based off truthiness.
+    #
+    # @return [Boolean]
     def to_boolean
       !!(@condition ? @condition.call(@value) : @value)
     end

data/lib/attribool/version.rb

@@ -21,14 +21,14 @@ module Attribool
     # Patch version.
     #
     # @return [Integer]
-    PATCH = 2
+    PATCH = 4
 
     module_function
 
     ##
     # Version as +[MAJOR, MINOR, PATCH]+
     #
-    # @return [Array]
+    # @return [Array<Integer>]
     def to_a
       [MAJOR, MINOR, PATCH]
     end
@@ -54,5 +54,5 @@ module Attribool
   # The version, as a string.
   #
   # @return [String]
-  VERSION = Version.to_s.freeze
+  VERSION = Version.to_s
 end

data/lib/attribool.rb

@@ -3,6 +3,7 @@
 require_relative "attribool/version"
 require_relative "attribool/value"
 require_relative "attribool/attribute"
+require_relative "attribool/validators"
 require_relative "attribool/reader_name"
 require_relative "attribool/attribute_list"
 require_relative "attribool/validator_service"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: attribool
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.4
 platform: ruby
 authors:
 - Evan Gray
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-23 00:00:00.000000000 Z
+date: 2024-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -100,6 +100,7 @@ extra_rdoc_files: []
 files:
 - ".github/workflows/ruby.yml"
 - ".gitignore"
+- ".projections.json"
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -111,6 +112,7 @@ files:
 - lib/attribool/attribute_list.rb
 - lib/attribool/reader_name.rb
 - lib/attribool/validator_service.rb
+- lib/attribool/validators.rb
 - lib/attribool/validators/attribute_list_validator.rb
 - lib/attribool/validators/condition_validator.rb
 - lib/attribool/validators/method_name_validator.rb