vector_number 0.2.5 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8fc99d66449b0cbc1ac4f2871e540ff921dee5d291b487221193edaefca1b2f
-  data.tar.gz: 38f15f406bff5348debb50b5468bf416e2fd3bca4be69257e3b59b99fbebd6ed
+  metadata.gz: 60948b232b4ab095c808a54d3ba32748893db4c660a2ab553ad216d677906814
+  data.tar.gz: b3ff8e996c8617c7c6a5c0592f18480d78cd5f7c520ab47194ae965eb21406a5
 SHA512:
-  metadata.gz: 23f819566a189655bcefaa7d22005e7de4e7349ad99718497e13faf97a748d6c9c63788146379473d28caed9bc7063a13787074f0c87241a1a36859a30a126a7
-  data.tar.gz: 33c4ce966c7ce9d3d1a486acd6119af50d9458c8048e2a6f07348625bb50bcb11d1db50c8dbee75ba81be996afe53bcb25af2b356ab9be0e1a6689a67d3a14dd
+  metadata.gz: d40eb5b5c6de69bd5db2579e9f6eb9f872abd67b68b49983c7d5c23d4a2726fbbaad128819631baf8e21e094d77986a4c69d53bcc408e2f838faffed9875c2bc
+  data.tar.gz: 4656e1b5a136191bede67f3c3203b3a43110e4c9700328b61d3802abfca3805ff39d7718d774a70eb0e0c20ea0a9e687fbdf6ce19594171148998b95ffcda9bd

data/CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Next]
+## [v0.2.6] — 2025-04-30
+
+**Added**
+- Add `#div`, `#%` (aliased as `#modulo`), `#divmod` and `#remainder` methods.
+- Add `#quo` alias to `#/`.
+
+**Fixed**
+- `#/`, `#fdiv` as well as new division methods now properly check for division by zero.
+   VectorNumber does not support this as not all Numeric classes do.
+
 ## [v0.2.5] — 2025-02-26
 
 Technical update after release to rubygems.org.
@@ -22,7 +32,7 @@ README was updated to reflect this change.
 - Make `VectorNumber.new` accept options when initializing from a VectorNumber
    instead of only copying. Options will be merged.
 - Remove `Initializing` module, move its methods to the actual class.
-- Updated development gem versions.
+- Update development gems' versions.
 
 **Fixed**
 - `#dup` and `#clone` now behave exactly like Numeric versions, preventing unfreezing.

data/lib/vector_number/math_converting.rb

@@ -3,10 +3,10 @@
 class VectorNumber
   # Various mathematical operations that are also conversions.
   module MathConverting
-    # Return the absolute value of a vector, i.e. its length.
+    # Return the absolute value of the vector, i.e. its length.
     # @return [Float]
     def abs
-      Math.sqrt(coefficients.reduce(0.0) { |result, coefficient| result + coefficient.abs2 })
+      Math.sqrt(coefficients.sum(&:abs2)) # rubocop:disable Naming/VariableNumber
     end
 
     alias magnitude abs

data/lib/vector_number/mathing.rb

@@ -64,12 +64,13 @@ class VectorNumber
     end
 
     # Divide all coefficients by a real number, returning new vector.
-    # This effectively multiplies magnitude by reciprocal of the specified factor.
+    # This effectively multiplies magnitude by reciprocal of +other+.
     # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
     # @return [VectorNumber]
     # @raise [RangeError] if +other+ is not a number or is not a real number
+    # @raise [ZeroDivisionError] if +other+ is zero
     def /(other)
-      raise RangeError, "can't divide #{self} by #{other}" unless real_number?(other)
+      check_divisibility(other)
 
       other = other.real
       # Prevent integer division, but without loss of accuracy.
@@ -78,16 +79,87 @@ class VectorNumber
       new { _1 / other }
     end
 
+    alias quo /
+
     # Divide all coefficients by a real number using +fdiv+, returning new vector
     # with Float coefficients.
     # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
     # @return [VectorNumber]
     # @raise [RangeError] if +other+ is not a number or is not a real number
+    # @raise [ZeroDivisionError] if +other+ is zero
     def fdiv(other)
-      raise RangeError, "can't divide #{self} by #{other}" unless real_number?(other)
+      check_divisibility(other)
 
       other = other.real
       new { _1.fdiv(other) }
     end
+
+    # Divide all coefficients by +other+, rounding results with {#floor}.
+    # This is requal to +(self / other).floor+.
+    # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
+    # @return [VectorNumber]
+    # @raise [RangeError] if +other+ is not a number or is not a real number
+    # @raise [ZeroDivisionError] if +other+ is zero
+    # @see #divmod
+    # @see #%
+    def div(other)
+      check_divisibility(other)
+
+      other = other.real
+      new { _1.div(other) }
+    end
+
+    # Return the modulus of dividing self by +other+ as a vector.
+    # This is equal to +self - other * (self/other).floor+.
+    # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
+    # @return [VectorNumber]
+    # @raise [RangeError] if +other+ is not a number or is not a real number
+    # @raise [ZeroDivisionError] if +other+ is zero
+    # @see #divmod
+    # @see #div
+    # @see #remainder for alternative
+    # @see Numeric#% for examples
+    def %(other)
+      check_divisibility(other)
+
+      other = other.real
+      new { _1 % other }
+    end
+
+    alias modulo %
+
+    # Return the quotient and modulus of dividing self by +other+.
+    # There is no performance benefit compared to calling {#div} and {#%} separately.
+    # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
+    # @return [Array(VectorNumber, VectorNumber)]
+    # @raise [RangeError] if +other+ is not a number or is not a real number
+    # @raise [ZeroDivisionError] if +other+ is zero
+    # @see #div
+    # @see #%
+    def divmod(other)
+      [div(other), modulo(other)]
+    end
+
+    # Return the remainder of dividing self by +other+ as a vector.
+    # This is equal to +self - other * (self/other).truncate+.
+    # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
+    # @return [VectorNumber]
+    # @raise [RangeError] if +other+ is not a number or is not a real number
+    # @raise [ZeroDivisionError] if +other+ is zero
+    # @see #% for alternative
+    # @see Numeric#remainder for examples
+    def remainder(other)
+      check_divisibility(other)
+
+      other = other.real
+      new { _1.remainder(other) }
+    end
+
+    private
+
+    def check_divisibility(other)
+      raise RangeError, "can't divide #{self} by #{other}", caller unless real_number?(other)
+      raise ZeroDivisionError, "divided by 0", caller if other.zero?
+    end
   end
 end

data/lib/vector_number/querying.rb

@@ -65,14 +65,14 @@ class VectorNumber
       !zero? && all? { |_u, c| c.negative? }
     end
 
-    # Always returns +false+.
+    # Always returns +false+, as vectors are never real numbers.
     # @see #numeric?
     # @return [false]
     def real?
       false
     end
 
-    # Always returns +false+.
+    # Always returns +false+, as vectors are not +Integer+s.
     # @return [false]
     def integer?
       false

data/lib/vector_number/stringifying.rb

@@ -48,7 +48,7 @@ class VectorNumber
     # @raise [ArgumentError] if +mult+ is not in {MULT_STRINGS}'s keys
     def value_to_s(unit, coefficient, mult:)
       if !mult.is_a?(String) && !MULT_STRINGS.key?(mult)
-        raise ArgumentError, "unknown key :#{mult}", caller
+        raise ArgumentError, "unknown key #{mult.inspect}", caller
       end
 
       case unit

data/lib/vector_number/version.rb

@@ -2,5 +2,5 @@
 
 class VectorNumber # rubocop:disable Style/StaticClass
   # @return [String]
-  VERSION = "0.2.5"
+  VERSION = "0.2.6"
 end

data/sig/vector_number.rbs

@@ -1,3 +1,19 @@
+type vector_type = VectorNumber
+type real_number = Integer | Float | Rational | BigDecimal
+
+type in_value_type = untyped
+type unit_type = untyped
+type coefficient_type = real_number
+
+type list[T] = Array[T]
+
+type plain_vector_type = Hash[unit_type, coefficient_type]
+type units_list_type = list[unit_type]
+type coefficients_list_type = list[coefficient_type]
+type each_value_type = [unit_type, coefficient_type]
+
+type options_type = Hash[Symbol, untyped]
+
 interface _BaseMethods
   def size: -> Integer
   def options: -> options_type
@@ -82,8 +98,22 @@ class VectorNumber
     def *: (real_number | vector_type) -> vector_type
 
     def /: (real_number | vector_type) -> vector_type
+    alias quo /
 
     def fdiv: (real_number | vector_type) -> vector_type
+
+    def div: (real_number | vector_type) -> vector_type
+
+    def %: (real_number | vector_type) -> vector_type
+    alias modulo %
+
+    def divmod: (real_number | vector_type) -> [vector_type, vector_type]
+
+    def remainder: (real_number | vector_type) -> vector_type
+
+    private
+
+    def check_divisibility: (real_number | vector_type) -> void
   end
 
   # Various mathematical operations that are also conversions.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: vector_number
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.6
 platform: ruby
 authors:
 - Alexandr Bulancov
 bindir: exe
 cert_chain: []
-date: 2025-02-25 00:00:00.000000000 Z
+date: 2025-04-30 00:00:00.000000000 Z
 dependencies: []
 executables: []
 extensions: []
@@ -27,7 +27,6 @@ files:
 - lib/vector_number/querying.rb
 - lib/vector_number/stringifying.rb
 - lib/vector_number/version.rb
-- sig/definitions.rbs
 - sig/vector_number.rbs
 homepage: https://github.com/trinistr/vector_number
 licenses:

data/sig/definitions.rbs

@@ -1,15 +0,0 @@
-type vector_type = VectorNumber
-type real_number = Integer | Float | Rational | BigDecimal
-
-type in_value_type = untyped
-type unit_type = untyped
-type coefficient_type = real_number
-
-type list[T] = Array[T]
-
-type plain_vector_type = Hash[unit_type, coefficient_type]
-type units_list_type = list[unit_type]
-type coefficients_list_type = list[coefficient_type]
-type each_value_type = [unit_type, coefficient_type]
-
-type options_type = Hash[Symbol, untyped]