kind 5.0.0 → 5.4.1

data/lib/kind/version.rb

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

metadata

@@ -1,16 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: kind
 version: !ruby/object:Gem::Version
-  version: 5.0.0
+  version: 5.4.1
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-02-23 00:00:00.000000000 Z
+date: 2021-03-26 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,52 +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/kind.rb
-- lib/kind/core/undefined.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/empty/constant.rb
-- lib/kind/error.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
@@ -94,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,8 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  module Core
-    require 'kind/core/kind'
-    require 'kind/core/undefined'
-  end
-end

data/lib/kind/core/kind.rb

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  module KIND
-    def self.null?(value) # :nodoc:
-      value.nil? || Undefined == value
-    end
-
-    def self.of?(kind, values) # :nodoc:
-      of_kind = -> value { kind === value }
-
-      values.empty? ? of_kind : values.all?(&of_kind)
-    end
-
-    def self.of!(kind, value, kind_name = nil) # :nodoc:
-      return value if kind === value
-
-      error!(kind_name || kind.name, value)
-    end
-
-    def self.error!(kind_name, value) # :nodoc:
-      raise Error.new(kind_name, value)
-    end
-
-    def self.of_class?(value) # :nodoc:
-      value.kind_of?(::Class)
-    end
-
-    def self.of_module?(value) # :nodoc:
-      ::Module == value || (value.kind_of?(::Module) && !of_class?(value))
-    end
-
-    def self.of_module_or_class!(value) # :nodoc:
-      of!(::Module, value, 'Module/Class')
-    end
-
-    def self.respond_to!(method_name, value) # :nodoc:
-      return value if value.respond_to?(method_name)
-
-      raise Error.new("expected #{value} to respond to :#{method_name}")
-    end
-
-    def self.is?(expected, value) # :nodoc:
-      is!(of_module_or_class!(expected), value)
-    end
-
-    def self.is!(expected_kind, value) # :nodoc:
-      kind = of_module_or_class!(value)
-
-      if of_class?(kind)
-        kind <= expected_kind || expected_kind == ::Class
-      else
-        kind == expected_kind || kind.kind_of?(expected_kind)
-      end
-    end
-
-    def self.value(kind, arg, default) # :nodoc:
-      kind === arg ? arg : default
-    end
-  end
-end

data/lib/kind/core/undefined.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  UNDEFINED = Object.new.freeze
-
-  private_constant :UNDEFINED
-end

data/lib/kind/error.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  class Error < TypeError
-    def initialize(arg, object = UNDEFINED)
-      if UNDEFINED == object
-        # Will be used when the exception was raised with a message. e.g:
-        # raise Kind::Error, "some message"
-        super(arg)
-      else
-        super("#{object.inspect} expected to be a kind of #{arg}")
-      end
-    end
-  end
-end

data/lib/kind/maybe/result.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  module Maybe
-    class Result
-      attr_reader :value
-
-      Value = ->(arg) { arg.kind_of?(Maybe::Result) ? arg.value : arg } # :nodoc:
-
-      def initialize(arg)
-        @value = Value.(arg)
-      end
-
-      def value_or(method_name = UNDEFINED, &block)
-        raise NotImplementedError
-      end
-
-      def none?
-        raise NotImplementedError
-      end
-
-      def some?; !none?; end
-
-      def map(&fn)
-        raise NotImplementedError
-      end
-
-      alias_method :map!, :map
-      alias_method :then, :map
-      alias_method :then!, :map
-
-      def check(&fn)
-        raise NotImplementedError
-      end
-
-      def try(method_name = UNDEFINED, &block)
-        raise NotImplementedError
-      end
-
-      alias_method :try!, :try
-
-      def dig(*keys)
-        raise NotImplementedError
-      end
-
-      def presence
-        raise NotImplementedError
-      end
-    end
-  end
-end

data/lib/kind/type_checker.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-module Kind
-  module TypeChecker
-    def name
-      kind.name
-    end
-
-    def ===(value)
-      kind === value
-    end
-
-    def [](value)
-      return value if self === value
-
-      KIND.error!(name, value)
-    end
-
-    def or_nil(value)
-      return value if self === value
-    end
-
-    def or_undefined(value)
-      or_nil(value) || Undefined
-    end
-
-    def or(fallback, value = UNDEFINED)
-      return __or_func.(fallback) if UNDEFINED === value
-
-      self === value ? value : fallback
-    end
-
-    def value?(value = UNDEFINED)
-      return self === value if UNDEFINED != value
-
-      @__is_value ||= ->(ck) { ->(value) { ck === value } }.(self)
-    end
-
-    def value(arg, default:)
-      KIND.value(self, arg, self[default])
-    end
-
-    def or_null(value) # :nodoc:
-      KIND.null?(value) ? value : self[value]
-    end
-
-    def maybe(value = UNDEFINED, &block)
-      return __maybe[value] if UNDEFINED != value && !block
-      return __maybe.wrap(&block) if UNDEFINED == value && block
-      return __maybe.wrap(value, &block) if UNDEFINED != value && block
-
-      __maybe
-    end
-
-    alias optional maybe
-
-    private
-
-      def __maybe
-        @__maybe ||= Maybe::Typed.new(self)
-      end
-
-      def __or_func
-        @__or_func ||= ->(tc, fb, value) { tc === value ? value : tc.or_null(fb) }.curry[self]
-      end
-  end
-
-  class TypeChecker::Object # :nodoc: all
-    include TypeChecker
-
-    ResolveKindName = ->(kind, opt) do
-      name = Try.(opt, :[], :name)
-      name || Try.(kind, :name)
-    end
-
-    attr_reader :kind, :name
-
-    def initialize(kind, opt)
-      name = ResolveKindName.(kind, opt)
-
-      @name = KIND.of!(::String, name)
-      @kind = KIND.respond_to!(:===, kind)
-    end
-
-    private_constant :ResolveKindName
-  end
-end