vector_number 0.6.1 → 0.7.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vector_number
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Alexander Bulancov
@@ -9,16 +9,12 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: |
-  VectorNumber provides a Numeric-like experience for doing arithmetics on heterogeneous objects, with more advanced operations based on real vector spaces available when needed.
+description: 'A Numeric-like vector space implementation for Ruby. Perform arithmetic
+  on heterogeneous objects, calculate norms and dot products, get hash-like access
+  to components, and seamlessly interoperate with core numbers. Zero dependencies,
+  pure Ruby.
 
-  Features:
-  * Add and subtract (almost) any object, with no setup or declaration.
-  * Multiply and divide vectors by any real number to create 1.35 of an array and -2 of a string. What does that mean? Only you know!
-  * Use vectors instead of inbuilt numbers in most situtations with no difference in behavior. Or, use familiar methods from numerics with sane semantics!
-  * Enumerate vectors in a hash-like fashion, or transform to an array or hash as needed.
-  * Enjoy a mix of vector-, complex- and polynomial-like behavior at appropriate times.
-  * No dependencies, no extensions. It just works!
+  '
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -29,13 +25,15 @@ files:
 - lib/vector_number/comparing.rb
 - lib/vector_number/converting.rb
 - lib/vector_number/enumerating.rb
-- lib/vector_number/math_converting.rb
 - lib/vector_number/mathing.rb
-- lib/vector_number/numeric_refinements.rb
 - lib/vector_number/querying.rb
+- lib/vector_number/rounding.rb
+- lib/vector_number/similarity.rb
 - lib/vector_number/special_unit.rb
 - lib/vector_number/stringifying.rb
+- lib/vector_number/vectoring.rb
 - lib/vector_number/version.rb
+- sig/manifest.yaml
 - sig/vector_number.rbs
 homepage: https://github.com/trinistr/vector_number
 licenses:
@@ -43,9 +41,9 @@ licenses:
 metadata:
   homepage_uri: https://github.com/trinistr/vector_number
   bug_tracker_uri: https://github.com/trinistr/vector_number/issues
-  documentation_uri: https://rubydoc.info/gems/vector_number/0.6.1
-  source_code_uri: https://github.com/trinistr/vector_number/tree/v0.6.1
-  changelog_uri: https://github.com/trinistr/vector_number/blob/v0.6.1/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/vector_number/0.7.0
+  source_code_uri: https://github.com/trinistr/vector_number/tree/v0.7.0
+  changelog_uri: https://github.com/trinistr/vector_number/blob/v0.7.0/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options:
 - "--main"
@@ -65,5 +63,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Add, subtract and do math with any objects
+summary: Do full linear algebra on any Ruby objects
 test_files: []

data/lib/vector_number/numeric_refinements.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-class VectorNumber
-  # Refinements of Numeric classes and Kernel to better work with VectorNumber and similar classes.
-  #
-  # These do not depend on +VectorNumber+ and can technically be used separately.
-  # Currently includes:
-  # - refinement for +Complex#<=>+ to work with classes implementing +<=>+;
-  # - refinement for +Kernel#BigDecimal+ to work with classes implementing +to_d+.
-  #
-  # @note Refinements won't work on Ruby 3.0.
-  #
-  # @example activating refinements
-  #   require "vector_number/numeric_refinements"
-  #   using VectorNumber::NumericRefinements
-  #
-  # @since 0.2.0
-  module NumericRefinements
-    # CommutativeShuttle refinement works only on 3.1, so it almost never actually runs.
-    # There are tests for the correct behavior, however, so it's fine.
-    # :nocov:
-
-    # Refinement module to provide a +#<=>+ method that can work backwards.
-    #
-    # @note Currently only applies to Complex on *3.1*,
-    #   as other numeric classes rely on +#coerce+.
-    # @example without refinements
-    #   VectorNumber[2] <=> Complex(1, 0) #=> 1
-    #   Complex(1, 0) <=> VectorNumber[2] #=> nil
-    # @example with refinements
-    #   require "vector_number/numeric_refinements"
-    #   using VectorNumber::NumericRefinements
-    #   VectorNumber[2] <=> Complex(1, 0) #=> 1
-    #   Complex(1, 0) <=> VectorNumber[2] #=> -1
-    #
-    # @since 0.2.1
-    module CommutativeShuttle
-      # Commutative +#<=>+.
-      # Tries to call +other <=> self+ if +self <=> other+ returns +nil+.
-      def <=>(other)
-        comparison = super
-        return comparison if comparison || !other.respond_to?(:<=>)
-
-        comparison = other <=> self
-        -comparison if comparison
-      end
-    end
-
-    if (Complex(1, 0) <=> VectorNumber[1]).nil?
-      refine(Complex) do
-        import_methods CommutativeShuttle
-      rescue
-        warn "Numeric refinements are not available on Ruby < 3.1"
-      end
-    end
-    # :nocov:
-
-    # Refinement module to change Kernel#BigDecimal so it works with +#to_d+.
-    #
-    # @note `BigDecimal` needs to be defined for this refinement to activate.
-    # @example without refinements
-    #   BigDecimal(VectorNumber[2]) # can't convert VectorNumber into BigDecimal (TypeError)
-    # @example with refinements
-    #   require "vector_number/numeric_refinements"
-    #   using VectorNumber::NumericRefinements
-    #   BigDecimal(VectorNumber[2]) #=> 0.2e1
-    #
-    # @since 0.2.1
-    module BigDecimalToD
-      # BigDecimal() that first tries to use #to_d.
-      # @param value [Object]
-      # @param exception [Boolean]
-      # @overload BigDecimal(value, exception: true)
-      # @overload BigDecimal(value, ndigits, exception: true)
-      #   @param ndigits [Integer]
-      # @return [BigDecimal, nil]
-      # @raise [TypeError]
-      def BigDecimal(value, ndigits = nil, exception: true) # rubocop:disable Naming/MethodName
-        if value.respond_to?(:to_d)
-          ndigits.nil? ? value.to_d : value.to_d(ndigits)
-        else
-          ndigits.nil? ? super(value, exception: exception) : super
-        end
-      end
-    end
-
-    # :nocov:
-    if defined?(BigDecimal)
-      refine(Kernel) do
-        import_methods BigDecimalToD
-      rescue
-        warn "Numeric refinements are not available on Ruby < 3.1"
-      end
-    end
-    # :nocov:
-  end
-end