kind 4.1.0 → 5.4.0

data/lib/kind/validator.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'kind/basic'
+
 module Kind
   module Validator
     DEFAULT_STRATEGIES = ::Set.new(%w[instance_of kind_of]).freeze
@@ -38,3 +40,112 @@ module Kind
     end
   end
 end
+
+require 'active_model'
+require 'active_model/validations'
+
+class KindValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    return if options[:allow_nil] && value.nil?
+
+    return unless error = call_validation_for(attribute, value)
+
+    raise Kind::Error.new("#{attribute} #{error}") if options[:strict]
+
+    record.errors.add(attribute, error)
+  end
+
+  private
+
+    def call_validation_for(attribute, value)
+      expected = options[:with] || options[:in]
+
+      return validate_with_default_strategy(expected, value) if expected
+
+      return kind_of(expected, value) if expected = options[:of]
+      return kind_is(expected, value) if expected = options[:is]
+      return respond_to(expected, value) if expected = options[:respond_to]
+      return instance_of(expected, value) if expected = options[:instance_of]
+      return array_with(expected, value) if expected = options[:array_with]
+      return array_of(expected, value) if expected = options[:array_of]
+
+      raise Kind::Validator::InvalidDefinition.new(attribute)
+    end
+
+    def validate_with_default_strategy(expected, value)
+      send(Kind::Validator.default_strategy, expected, value)
+    end
+
+    def kind_of(expected, value)
+      if ::Array === expected
+        return if expected.any? { |type| type === value }
+
+        "must be a kind of #{expected.map { |type| type.name }.join(', ')}"
+      else
+        return if expected === value
+
+        expected.respond_to?(:name) ? "must be a kind of #{expected.name}" : 'invalid kind'
+      end
+    end
+
+    CLASS_OR_MODULE = 'Class/Module'.freeze
+
+    def kind_is(expected, value)
+      return kind_is_not(expected, value) unless expected.kind_of?(::Array)
+
+      result = expected.map { |kind| kind_is_not(kind, value) }.tap(&:compact!)
+
+      result.empty? || result.size < expected.size ? nil : result.join(', ')
+    end
+
+    def kind_is_not(expected, value)
+      case expected
+      when ::Class
+        return if expected == Kind.of_class(value) || value < expected
+
+        "must be the class or a subclass of `#{expected.name}`"
+      when ::Module
+        return if value.kind_of?(::Class) && value <= expected
+        return if expected == Kind.of_module_or_class(value) || value.kind_of?(expected)
+
+        "must include the `#{expected.name}` module"
+      else
+        raise Kind::Error.new(CLASS_OR_MODULE, expected)
+      end
+    end
+
+    def respond_to(expected, value)
+      method_names = Array(expected)
+
+      expected_methods = method_names.select { |method_name| !value.respond_to?(method_name) }
+      expected_methods.map! { |method_name| "`#{method_name}`" }
+
+      return if expected_methods.empty?
+
+      methods = expected_methods.size == 1 ? 'method' : 'methods'
+
+      "must respond to the #{methods}: #{expected_methods.join(', ')}"
+    end
+
+    def instance_of(expected, value)
+      types = Array(expected)
+
+      return if types.any? { |type| value.instance_of?(type) }
+
+      "must be an instance of #{types.map { |klass| klass.name }.join(', ')}"
+    end
+
+    def array_with(expected, value)
+      return if value.kind_of?(::Array) && !value.empty? && (value - Kind.of!(::Array, expected)).empty?
+
+      "must be an array with #{expected.join(', ')}"
+    end
+
+    def array_of(expected, value)
+      types = Array(expected)
+
+      return if value.kind_of?(::Array) && !value.empty? && value.all? { |val| types.any? { |type| type === val } }
+
+      "must be an array of #{types.map { |klass| klass.name }.join(', ')}"
+    end
+end

data/lib/kind/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kind
-  VERSION = '4.1.0'
+  VERSION = '5.4.0'
 end

metadata

@@ -1,16 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: kind
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 5.4.0
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-02-22 00:00:00.000000000 Z
+date: 2021-03-25 00:00:00.000000000 Z
 dependencies: []
-description: A simple type system (at runtime) for Ruby - free of dependencies.
+description: A development toolkit for Ruby with several small/cohesive abstractions
+  (monads, enums, business logic, data validation...) to empower your development
+  workflow - It's totally free of dependencies.
 email:
 - rodrigo.serradura@gmail.com
 executables: []
@@ -31,60 +33,90 @@ files:
 - bin/setup
 - kind.gemspec
 - lib/kind.rb
-- lib/kind/active_model/kind_validator.rb
+- lib/kind/__lib__/action_steps.rb
+- lib/kind/__lib__/attributes.rb
+- lib/kind/__lib__/kind.rb
+- lib/kind/__lib__/of.rb
+- lib/kind/__lib__/strict.rb
+- lib/kind/__lib__/undefined.rb
+- lib/kind/action.rb
 - lib/kind/active_model/validation.rb
-- lib/kind/core.rb
-- lib/kind/core/deprecation.rb
-- lib/kind/core/kind.rb
-- lib/kind/core/undefined.rb
-- lib/kind/core/wrong_number_of_args.rb
-- lib/kind/deprecations/built_in_type_checkers.rb
-- lib/kind/deprecations/checker.rb
-- lib/kind/deprecations/checker/factory.rb
-- lib/kind/deprecations/checker/protocol.rb
-- lib/kind/deprecations/is.rb
-- lib/kind/deprecations/of.rb
-- lib/kind/deprecations/types.rb
+- lib/kind/basic.rb
+- lib/kind/basic/error.rb
+- lib/kind/basic/undefined.rb
 - lib/kind/dig.rb
+- lib/kind/either.rb
+- lib/kind/either/left.rb
+- lib/kind/either/methods.rb
+- lib/kind/either/monad.rb
+- lib/kind/either/monad/wrapper.rb
+- lib/kind/either/right.rb
 - lib/kind/empty.rb
-- lib/kind/error.rb
+- lib/kind/empty/constant.rb
+- lib/kind/enum.rb
+- lib/kind/enum/item.rb
+- lib/kind/enum/methods.rb
+- lib/kind/function.rb
+- lib/kind/functional.rb
+- lib/kind/functional/action.rb
+- lib/kind/functional/steps.rb
+- lib/kind/immutable_attributes.rb
+- lib/kind/immutable_attributes/initializer.rb
+- lib/kind/immutable_attributes/reader.rb
 - lib/kind/maybe.rb
+- lib/kind/maybe/methods.rb
+- lib/kind/maybe/monad.rb
+- lib/kind/maybe/monad/wrapper.rb
 - lib/kind/maybe/none.rb
-- lib/kind/maybe/result.rb
 - lib/kind/maybe/some.rb
 - lib/kind/maybe/typed.rb
-- lib/kind/maybe/wrappable.rb
+- lib/kind/maybe/wrapper.rb
+- lib/kind/monad.rb
+- lib/kind/monads.rb
+- lib/kind/objects.rb
+- lib/kind/objects/basic_object.rb
+- lib/kind/objects/modules.rb
+- lib/kind/objects/modules/core/array.rb
+- lib/kind/objects/modules/core/class.rb
+- lib/kind/objects/modules/core/comparable.rb
+- lib/kind/objects/modules/core/enumerable.rb
+- lib/kind/objects/modules/core/enumerator.rb
+- lib/kind/objects/modules/core/file.rb
+- lib/kind/objects/modules/core/float.rb
+- lib/kind/objects/modules/core/hash.rb
+- lib/kind/objects/modules/core/integer.rb
+- lib/kind/objects/modules/core/io.rb
+- lib/kind/objects/modules/core/method.rb
+- lib/kind/objects/modules/core/module.rb
+- lib/kind/objects/modules/core/numeric.rb
+- lib/kind/objects/modules/core/proc.rb
+- lib/kind/objects/modules/core/queue.rb
+- lib/kind/objects/modules/core/range.rb
+- lib/kind/objects/modules/core/regexp.rb
+- lib/kind/objects/modules/core/string.rb
+- lib/kind/objects/modules/core/struct.rb
+- lib/kind/objects/modules/core/symbol.rb
+- lib/kind/objects/modules/core/time.rb
+- lib/kind/objects/modules/custom/boolean.rb
+- lib/kind/objects/modules/custom/callable.rb
+- lib/kind/objects/modules/custom/lambda.rb
+- lib/kind/objects/modules/stdlib/open_struct.rb
+- lib/kind/objects/modules/stdlib/set.rb
+- lib/kind/objects/nil.rb
+- lib/kind/objects/not_nil.rb
+- lib/kind/objects/object.rb
+- lib/kind/objects/respond_to.rb
+- lib/kind/objects/union_type.rb
 - lib/kind/presence.rb
+- lib/kind/result.rb
+- lib/kind/result/abstract.rb
+- lib/kind/result/failure.rb
+- lib/kind/result/methods.rb
+- lib/kind/result/monad.rb
+- lib/kind/result/monad/wrapper.rb
+- lib/kind/result/success.rb
+- lib/kind/strict/disabled.rb
 - lib/kind/try.rb
-- lib/kind/type_checker.rb
-- lib/kind/type_checkers.rb
-- lib/kind/type_checkers/core/array.rb
-- lib/kind/type_checkers/core/class.rb
-- lib/kind/type_checkers/core/comparable.rb
-- lib/kind/type_checkers/core/enumerable.rb
-- lib/kind/type_checkers/core/enumerator.rb
-- lib/kind/type_checkers/core/file.rb
-- lib/kind/type_checkers/core/float.rb
-- lib/kind/type_checkers/core/hash.rb
-- lib/kind/type_checkers/core/integer.rb
-- lib/kind/type_checkers/core/io.rb
-- lib/kind/type_checkers/core/method.rb
-- lib/kind/type_checkers/core/module.rb
-- lib/kind/type_checkers/core/numeric.rb
-- lib/kind/type_checkers/core/proc.rb
-- lib/kind/type_checkers/core/queue.rb
-- lib/kind/type_checkers/core/range.rb
-- lib/kind/type_checkers/core/regexp.rb
-- lib/kind/type_checkers/core/string.rb
-- lib/kind/type_checkers/core/struct.rb
-- lib/kind/type_checkers/core/symbol.rb
-- lib/kind/type_checkers/core/time.rb
-- lib/kind/type_checkers/custom/boolean.rb
-- lib/kind/type_checkers/custom/callable.rb
-- lib/kind/type_checkers/custom/lambda.rb
-- lib/kind/type_checkers/stdlib/open_struct.rb
-- lib/kind/type_checkers/stdlib/set.rb
-- lib/kind/undefined.rb
 - lib/kind/validator.rb
 - lib/kind/version.rb
 - test.sh
@@ -102,15 +134,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.2.0
+      version: 2.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.11
 signing_key: 
 specification_version: 4
-summary: A simple type system (at runtime) for Ruby.
+summary: A development toolkit for Ruby with several small/cohesive abstractions to
+  empower your development workflow.
 test_files: []

data/lib/kind/active_model/kind_validator.rb

@@ -1,103 +0,0 @@
-# frozen_string_literal: true
-
-class KindValidator < ActiveModel::EachValidator
-  def validate_each(record, attribute, value)
-    return if options[:allow_nil] && value.nil?
-
-    return unless error = call_validation_for(attribute, value)
-
-    raise Kind::Error.new("#{attribute} #{error}") if options[:strict]
-
-    record.errors.add(attribute, error)
-  end
-
-  private
-
-    def call_validation_for(attribute, value)
-      expected = options[:with] || options[:in]
-
-      return validate_with_default_strategy(expected, value) if expected
-
-      return kind_of(expected, value) if expected = options[:of]
-      return kind_is(expected, value) if expected = options[:is]
-      return respond_to(expected, value) if expected = options[:respond_to]
-      return instance_of(expected, value) if expected = options[:instance_of]
-      return array_with(expected, value) if expected = options[:array_with]
-      return array_of(expected, value) if expected = options[:array_of]
-
-      raise Kind::Validator::InvalidDefinition.new(attribute)
-    end
-
-    def validate_with_default_strategy(expected, value)
-      send(Kind::Validator.default_strategy, expected, value)
-    end
-
-    def kind_of(expected, value)
-      types = Array(expected)
-
-      return if types.any? { |type| type === value }
-
-      "must be a kind of: #{types.map { |type| type.name }.join(', ')}"
-    end
-
-    CLASS_OR_MODULE = 'Class/Module'.freeze
-
-    def kind_is(expected, value)
-      return kind_is_not(expected, value) unless expected.kind_of?(::Array)
-
-      result = expected.map { |kind| kind_is_not(kind, value) }.tap(&:compact!)
-
-      result.empty? || result.size < expected.size ? nil : result.join(', ')
-    end
-
-    def kind_is_not(expected, value)
-      case expected
-      when ::Class
-        return if expected == Kind::Class[value] || value < expected
-
-        "must be the class or a subclass of `#{expected.name}`"
-      when ::Module
-        return if value.kind_of?(Class) && value <= expected
-        return if expected == Kind.of_module_or_class(value) || value.kind_of?(expected)
-
-        "must include the `#{expected.name}` module"
-      else
-        raise Kind::Error.new(CLASS_OR_MODULE, expected)
-      end
-    end
-
-    def respond_to(expected, value)
-      method_names = Array(expected)
-
-      expected_methods = method_names.select { |method_name| !value.respond_to?(method_name) }
-      expected_methods.map! { |method_name| "`#{method_name}`" }
-
-      return if expected_methods.empty?
-
-      methods = expected_methods.size == 1 ? 'method' : 'methods'
-
-      "must respond to the #{methods}: #{expected_methods.join(', ')}"
-    end
-
-    def instance_of(expected, value)
-      types = Array(expected)
-
-      return if types.any? { |type| value.instance_of?(type) }
-
-      "must be an instance of: #{types.map { |klass| klass.name }.join(', ')}"
-    end
-
-    def array_with(expected, value)
-      return if value.kind_of?(::Array) && !value.empty? && (value - Kind::Array[expected]).empty?
-
-      "must be an array with: #{expected.join(', ')}"
-    end
-
-    def array_of(expected, value)
-      types = Array(expected)
-
-      return if value.kind_of?(::Array) && !value.empty? && value.all? { |value| types.any? { |type| value.kind_of?(type) } }
-
-      "must be an array of: #{types.map { |klass| klass.name }.join(', ')}"
-    end
-end

data/lib/kind/core.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  module Core
-    require 'kind/core/wrong_number_of_args'
-    require 'kind/core/deprecation'
-    require 'kind/core/kind'
-    require 'kind/core/undefined'
-  end
-end

data/lib/kind/core/deprecation.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  module DEPRECATION # :nodoc: all
-    WARN_IS_DISABLED = String(ENV['DISABLE_KIND_DEPRECATION']).strip == 't'
-
-    module DevNull
-      def self.warn(_)
-      end
-    end
-
-    OUTPUT = WARN_IS_DISABLED ? DevNull : ::Kernel
-
-    def self.warn(message)
-      OUTPUT.warn("[DEPRECATION] #{message}" % { version: 'version 5.0' })
-    end
-
-    def self.warn_method_replacement(old_method, new_method)
-      self.warn "`#{old_method}` is deprecated, it will be removed in %{version}. " \
-        "Please use `#{new_method}` instead."
-    end
-
-    def self.warn_removal(name)
-      self.warn "`#{name}` is deprecated, it will be removed in %{version}."
-    end
-
-    private_constant :DevNull, :OUTPUT
-  end
-end