vector_number 0.2.6 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60948b232b4ab095c808a54d3ba32748893db4c660a2ab553ad216d677906814
-  data.tar.gz: b3ff8e996c8617c7c6a5c0592f18480d78cd5f7c520ab47194ae965eb21406a5
+  metadata.gz: c55a93e873d8e98092a5be77940f3f91cf06e90abb973f16d2fc91f0df0276ca
+  data.tar.gz: 446cb27d60ff3b588ffbc6fa49489013d6a2cfc8e6f2b577abc4a40b47587658
 SHA512:
-  metadata.gz: d40eb5b5c6de69bd5db2579e9f6eb9f872abd67b68b49983c7d5c23d4a2726fbbaad128819631baf8e21e094d77986a4c69d53bcc408e2f838faffed9875c2bc
-  data.tar.gz: 4656e1b5a136191bede67f3c3203b3a43110e4c9700328b61d3802abfca3805ff39d7718d774a70eb0e0c20ea0a9e687fbdf6ce19594171148998b95ffcda9bd
+  metadata.gz: 2a069408f786816659721505e8e09d50aeaf891e6dcc85c35d008a161500548e74c3cb0224a8992521c3e9385cb8cabe6c9b565874981c0098d5fb5c081ee65f
+  data.tar.gz: 99c2b90210dfceaeec85f6f8fd897074296c27ba6e9a6cb8ffcd0d407b3f65482b445b721fd5a41139a339d5d54f8ce81f4860dfdffccc0db1909002744fa8fe

data/CHANGELOG.md

@@ -6,6 +6,20 @@ 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.3.0] — 2025-05-12
+
+**Added**
+- Add aliases to other operators:
+   `#neg` for `#-@`, `#add` for `#+`, `#sub` for `#-`, `#mult` for `#*`.
+   `#+@` was already practically aliased by `#dup`.
+
+**Changed**
+- [Breaking] Long-existing but broken options feature is now fixed.
+   When creating new vector through any operation, participating vector's options
+   are copied to the new one. When several vectors are present, only first one matters.
+- Both `#+@` and `#dup` are now aliases of `#itself` instead of full methods.
+- [🚀 CI] Refactor workflows to reduce duplication.
+
 ## [v0.2.6] — 2025-04-30
 
 **Added**
@@ -16,6 +30,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `#/`, `#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.
 
+**Changed**
+- [🚀 CI] Add Ruby 3.4 to CI.
+
 ## [v0.2.5] — 2025-02-26
 
 Technical update after release to rubygems.org.
@@ -27,8 +44,9 @@ README was updated to reflect this change.
 - Add hash-like methods `#[]` and `#unit?` (aliased as `#key?`).
 
 **Changed**
-- [Breaking] Change `positive?` and `negative?` to no longer return `nil`,
-   those cases will now return `false`.
+- [Breaking] Change `positive?` and `negative?` to no longer return `nil`
+   when number is neither strictly positive or negative,
+   these cases will now return `false`.
 - 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.
@@ -49,9 +67,9 @@ README was updated to reflect this change.
 - Add `#ceil`, `#floor` and `#round`.
 
 **Changed**
-- Add ruby 3.1.0, covering the earliest supported version, and ruby-next (3.4) to CI.
-- Add JRuby and TruffleRuby to CI, without full support.
-- Make tests runnable even without available `bigdecimal` gem.
+- [🚀 CI] Add ruby 3.1.0, covering the earliest supported version, and ruby-next (3.4) to CI.
+- [🚀 CI] Add JRuby and TruffleRuby to CI, without full support.
+- [🚀 CI] Make tests runnable even without available `bigdecimal` gem.
 
 **Fixed**
 - `Kernel#BigDecimal` refinement now correctly works without `ndigits` argument.
@@ -59,7 +77,7 @@ README was updated to reflect this change.
 ## [v0.2.1] — 2024-08-24
 
 **Added**
-- Add back `#*` and `#/` for working with real numbers.
+- Add `#*` and `#/` for working with real numbers.
 - Add `#fdiv`, `#truncate`, `#nonnumeric?` and `#integer?`.
 
 **Changed**
@@ -82,3 +100,5 @@ README was updated to reflect this change.
 ## [v0.1.0] — 2024-05-09
 
 - Initial work.
+
+[🚀 CI]: https://github.com/trinistr/vector_number/actions/workflows/CI.yaml

data/README.md

@@ -1,9 +1,6 @@
 # VectorNumber
 
-![CRuby validation](https://github.com/trinistr/vector_number/actions/workflows/cruby.yaml/badge.svg)
-<!--
-![TruffleRuby validation](https://github.com/trinistr/vector_number/actions/workflows/truffleruby.yaml/badge.svg)
--->
+[![CI](https://github.com/trinistr/vector_number/actions/workflows/CI.yaml/badge.svg)](https://github.com/trinistr/vector_number/actions/workflows/CI.yaml)
 
 A library to add together anything: be it a number, string or random Object, it can be added together in an infinite-dimensional vector space, with math operations available on results.
 
@@ -16,7 +13,9 @@ Similar projects:
 
 ## Installation
 
-Install with `gem`:
+VectorNumber does not have any dependencies and does not include extensions.
+
+Install with `gem` (available from 0.2.4):
 ```sh
 gem install vector_number
 ```
@@ -58,9 +57,9 @@ VectorNumber.new([4, "death", "death", 13, nil])
 ## Ruby engine support status
 
 VectorNumber is developed on MRI (CRuby) but should work on other engines too.
-- JRuby: should work, but currently CI does not pass.
 - TruffleRuby: works as expected, but there are differences in core Ruby code, so some tests fail.
-- Other engines: untested, but should work.
+- JRuby: significant problems (at least on CI), but may work.
+- Other engines: untested, but should work, depending on compatibility.
 
 ## Development
 

data/lib/vector_number/mathing.rb

@@ -18,9 +18,7 @@ class VectorNumber
 
     # Return self.
     # @return [VectorNumber]
-    def +@
-      self
-    end
+    alias +@ itself
 
     # Return new vector with negated coefficients.
     # This preserves order of units.
@@ -29,6 +27,8 @@ class VectorNumber
       new(&:-@)
     end
 
+    alias neg -@
+
     # Return new vector as a sum of this and other value.
     # This is analogous to {VectorNumber.[]}.
     # @param other [Object]
@@ -37,6 +37,8 @@ class VectorNumber
       new([self, other])
     end
 
+    alias add +
+
     # Return new vector as a sum of this and negative of the other value.
     # This is analogous to {VectorNumber.[]}, but allows to negate anything.
     # @param other [Object]
@@ -45,6 +47,8 @@ class VectorNumber
       self + new([other], &:-@)
     end
 
+    alias sub -
+
     # Multiply all coefficients by a real number, returning new vector.
     # This effectively multiplies magnitude by the specified factor.
     # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]
@@ -63,6 +67,8 @@ class VectorNumber
       end
     end
 
+    alias mult *
+
     # Divide all coefficients by a real number, returning new vector.
     # This effectively multiplies magnitude by reciprocal of +other+.
     # @param other [Integer, Float, Rational, BigDecimal, VectorNumber]

data/lib/vector_number/stringifying.rb

@@ -36,6 +36,7 @@ class VectorNumber
 
     # @return [String]
     def inspect
+      # TODO: Probably make this independent of options.
       "(#{self})"
     end
 

data/lib/vector_number/version.rb

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

data/lib/vector_number.rb

@@ -54,18 +54,15 @@ class VectorNumber
   # @param values [Array, Hash{Object => Integer, Float, Rational, BigDecimal}, VectorNumber]
   #   values for this number, hashes are treated like plain vector numbers
   # @param options [Hash{Symbol => Object}]
-  #   options for this number, if +values+ is a VectorNumber,
-  #   these will be merged with options from +values.options+
+  #   options for this number, if +values+ is a VectorNumber or contains it,
+  #   these will be merged with options from its +options+
   # @option options [Symbol, String] :mult
   #   text to use between unit and coefficient, see {Stringifying#to_s} for explanation
   # @yieldparam coefficient [Integer, Float, Rational, BigDecimal]
   # @yieldreturn [Integer, Float, Rational, BigDecimal] new coefficient
   # @raise [RangeError] if any pesky non-reals get where they shouldn't
-  def initialize(values = nil, options = {}.freeze, &)
-    # TODO: propagate options properly.
-    #   > (VectorNumber[1, 'a', mult: :invisible] + 2).options
-    #   => {:mult=>:dot}
-    super()
+  def initialize(values = nil, options = nil, &)
+    # @type var options: Hash[Symbol, Symbol]
     initialize_from(values)
     apply_transform(&)
     finalize_contents
@@ -78,9 +75,7 @@ class VectorNumber
   # Return self.
   #
   # @return [VectorNumber]
-  def dup
-    self
-  end
+  alias dup itself
 
   # Return self.
   #
@@ -106,7 +101,7 @@ class VectorNumber
   # @yieldreturn [Integer, Float, Rational, BigDecimal] new coefficient
   # @return [VectorNumber]
   def new(from = self, &)
-    self.class.new(from, &)
+    self.class.new(from, options, &)
   end
 
   # @param value [Object]
@@ -183,15 +178,26 @@ class VectorNumber
       case [options, values]
       in [{} | nil, VectorNumber]
         values.options
+      in [{} | nil, [*, VectorNumber => vector, *]]
+        vector.options
       in Hash, VectorNumber
-        values.options.merge(options).slice(*known_options)
+        merge_options(values.options, options)
+      in Hash, [*, VectorNumber => vector, *]
+        merge_options(vector.options, options)
       in Hash, _ unless options.empty?
-        default_options.merge(options).slice(*known_options)
+        merge_options(default_options, options)
       else
         default_options
       end
   end
 
+  def merge_options(base_options, added_options)
+    # Optimization for the common case of passing options through #new.
+    return base_options if added_options.equal?(base_options)
+
+    base_options.merge(added_options).slice(*known_options)
+  end
+
   # Compact coefficients, calculate size and freeze data.
   # @return [void]
   def finalize_contents

data/sig/vector_number.rbs

@@ -51,7 +51,7 @@ class VectorNumber
   def self.[]: (*unit_type values, **options_type options) -> vector_type
 
   def initialize:
-    (?(units_list_type | plain_vector_type | vector_type)? values, ?options_type options)
+    (?(units_list_type | plain_vector_type | vector_type)? values, ?options_type? options)
     ?{ (coefficient_type coefficient) -> coefficient_type }
     -> void
 
@@ -90,12 +90,16 @@ class VectorNumber
     def +@: () -> self
 
     def -@: () -> vector_type
+    alias neg -@
 
     def +: (in_value_type) -> vector_type
+    alias add +
 
     def -: (in_value_type) -> vector_type
+    alias sub -
 
     def *: (real_number | vector_type) -> vector_type
+    alias mult *
 
     def /: (real_number | vector_type) -> vector_type
     alias quo /
@@ -130,6 +134,8 @@ class VectorNumber
     def ceil: (Integer) -> vector_type
 
     def floor: (Integer) -> vector_type
+
+    def round: (Integer, ?half: (:up | :down | :even)) -> vector_type
   end
 
   # Methods for converting to different number classes.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: vector_number
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.3.0
 platform: ruby
 authors:
 - Alexandr Bulancov
 bindir: exe
 cert_chain: []
-date: 2025-04-30 00:00:00.000000000 Z
+date: 2025-05-12 00:00:00.000000000 Z
 dependencies: []
 executables: []
 extensions: []