notation 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e23661f94f5bf2dfef11e26f2af11c958dfb06fe66d5d8dc5fa4332e71dfb80d
-  data.tar.gz: 8a2e6bb2508c0b577d4497df812efe9c3ee1934619eb8466db19048b2a7239a2
+  metadata.gz: 36a4c918f1fa1b18facae1b46a6ce84f350434f6beeff794d6f759068762f0ac
+  data.tar.gz: 8b7fdbb5388cf332e791189fc399f192ea2ea47999eac90ecaf0a87186374480
 SHA512:
-  metadata.gz: 2af0f7a4ea3413d9375687cd6bade35197e4db199b82168de9e5098b2542b32671a080186f88ce491158f056c9a6f9d27fa1ec60ff6b603724c0f96cb826d54c
-  data.tar.gz: e708df538e3b930aff5f316c70773d3d0a1ce90b39548b0f2b4a455859e116a410b419856af93eeb1522b1bb94a2c632945fb055472f1efc9db2ee6415ca26ab
+  metadata.gz: 6d47b34b3651a4652d061b8fdb000440863f4e8c5b8b18808c466eb21ff673565311961a1dbce73f4a156283bf9d626b0a3bb6391a6ca93f861cc9b7fd273187
+  data.tar.gz: e0ba3d661748fded3a500f466f46ccc2f1786106926695b3c351435884393d900327aec1b1f832f36193223b6ad77627c909d9cf384dd7dd15544a474ea16734

data/CHANGES.md

@@ -1,6 +1,20 @@
-## 0.2.2 - 22-Jun-2024
-* Rubocop config and cleanup.
-* Removed some old directives and comments.
+## 0.3.0 - 17-Jul-2025
+* Major expansion of Unicode mathematical notation methods
+* Improved ∑ (sigma) and ∏ (pi) methods to handle both arrays and individual arguments
+* Added ∛ (cube root) method
+* Added ∜ (fourth root) method
+* Added ｜｜ (absolute value) method
+* Added ∞ (infinity) constant
+* Added ！ (factorial) method
+* Added Δ (delta/difference) method
+* Added ≈ (approximately equal) method
+* Added ≠ (not equal) method
+* Added ≤ (less than or equal) method
+* Added ≥ (greater than or equal) method
+* Added ± (plus or minus) method
+* Added ° (degrees to radians) method
+* Added ％ (percentage) method
+* Enhanced documentation and test coverage
 
 ## 0.2.1 - 20-Feb-2021
 * Added metadata to the gemspec.

data/README.md

@@ -13,11 +13,31 @@ Unicode methods for Ruby.
 ## Synopsis
 ```ruby
 require 'notation'
-   
-λ { puts "hello" } # => "Hello"
-∑ [1,2,3]          # => 6
-∏ [2,3,4]          # => 24
-√ 49               # => 7.0
+
+# Lambda notation
+λ { puts "hello" }         # => "Hello"
+
+# Mathematical operations
+∑ [1,2,3]                  # => 6 (sum)
+∏ [2,3,4]                  # => 24 (product)
+√ 49                       # => 7.0 (square root)
+∛ 27                       # => 3.0 (cube root)
+∜ 16                       # => 2.0 (fourth root)
+｜-5｜                      # => 5 (absolute value)
+！ 5                       # => 120 (factorial)
+
+# Comparison operations
+≈ 3.14159, 3.14160, 0.001  # => true (approximately equal)
+≠ 5, 3                     # => true (not equal)
+≤ 5, 10                    # => true (less than or equal)
+≥ 10, 5                    # => true (greater than or equal)
+
+# Utility functions
+Δ 10, 7                    # => 3 (delta/difference)
+± 5, 2                     # => [3, 7] (plus or minus)
+° 180                      # => 3.14159... (degrees to radians)
+％ 50                      # => 0.5 (percentage)
+∞                          # => Float::INFINITY
 ```
 
 ## Author's Notes
@@ -30,11 +50,11 @@ The ability to add unicode methods is limited to method names that have
 no receiver. This is a limitation of the Ruby parser.
 
 ## Copyright
-(C) 2009-2024 Daniel J. Berger
+(C) 2009-2021 Daniel J. Berger
 All Rights Reserved
 
 ## License
 Apache-2.0
-	
+
 ## Author
 Daniel Berger

data/lib/notation.rb

@@ -3,7 +3,7 @@
 # Extend the core Kernel module
 module Kernel
   # Version of the notation library
-  NOTATION_VERSION = '0.2.2'
+  NOTATION_VERSION = '0.3.0'
 
   # Make lambda a true lambda
   #
@@ -13,21 +13,27 @@ module Kernel
   alias λ proc
 
   # Sigma, i.e. the sum of all elements.
+  # Improved to handle arrays and individual arguments
   #
-  # Example:
+  # Examples:
   #   ∑ [1,2,3] => 6
+  #   ∑ 1,2,3   => 6
   #
   def ∑(*args)
-    args.inject(0){ |e, m| m + e }
+    args = args.first if args.length == 1 && args.first.respond_to?(:each)
+    args.inject(0) { |sum, element| sum + element }
   end
 
   # Pi product, i.e. the product of all elements.
+  # Improved to handle arrays and individual arguments
   #
-  # Example:
+  # Examples:
   #   ∏ [2,3,4] => 24
+  #   ∏ 2,3,4   => 24
   #
   def ∏(*args)
-    args.inject(1){ |e, m| m * e }
+    args = args.first if args.length == 1 && args.first.respond_to?(:each)
+    args.inject(1) { |product, element| product * element }
   end
 
   # Square root
@@ -35,7 +41,126 @@ module Kernel
   # Example:
   #   √ 49 => 7.0
   #
-  def √(root)
-    Math.sqrt(root)
+  def √(value)
+    Math.sqrt(value)
+  end
+
+  # Cube root
+  #
+  # Example:
+  #   ∛ 27 => 3.0
+  #
+  def ∛(value)
+    value < 0 ? -((-value) ** (1.0/3)) : value ** (1.0/3)
+  end
+
+  # Fourth root
+  #
+  # Example:
+  #   ∜ 16 => 2.0
+  #
+  def ∜(value)
+    value ** (1.0/4)
+  end
+
+  # Absolute value
+  #
+  # Example:
+  #   ｜-5｜ => 5
+  #
+  def ｜(value)
+    value.abs
+  end
+
+  # Infinity constant
+  #
+  # Example:
+  #   ∞ => Float::INFINITY
+  #
+  def ∞
+    Float::INFINITY
+  end
+
+  # Factorial
+  #
+  # Example:
+  #   ！ 5 => 120
+  #
+  def ！(n)
+    raise ArgumentError, 'Factorial is only defined for non-negative integers' if n < 0
+    return 1 if n == 0 || n == 1
+    (2..n).inject(1) { |result, i| result * i }
+  end
+
+  # Delta (difference between two values)
+  #
+  # Example:
+  #   Δ 10, 7 => 3
+  #
+  def Δ(a, b)
+    (a - b).abs
+  end
+
+  # Approximately equal (within epsilon)
+  #
+  # Example:
+  #   ≈ 3.14159, 3.14160, 0.001 => true
+  #
+  def ≈(a, b, epsilon = 1e-10)
+    (a - b).abs < epsilon
+  end
+
+  # Not equal
+  #
+  # Example:
+  #   ≠ 5, 3 => true
+  #
+  def ≠(a, b)
+    a != b
+  end
+
+  # Less than or equal
+  #
+  # Example:
+  #   ≤ 5, 10 => true
+  #
+  def ≤(a, b)
+    a <= b
+  end
+
+  # Greater than or equal
+  #
+  # Example:
+  #   ≥ 10, 5 => true
+  #
+  def ≥(a, b)
+    a >= b
+  end
+
+  # Plus or minus (returns array with both values)
+  #
+  # Example:
+  #   ± 5, 2 => [3, 7]
+  #
+  def ±(value, delta)
+    [value - delta, value + delta]
+  end
+
+  # Degrees to radians
+  #
+  # Example:
+  #   ° 180 => 3.141592653589793
+  #
+  def °(degrees)
+    degrees * Math::PI / 180
+  end
+
+  # Percentage (divide by 100)
+  #
+  # Example:
+  #   ％ 50 => 0.5
+  #
+  def ％(value)
+    value / 100.0
   end
 end

data/notation.gemspec

@@ -2,7 +2,7 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'notation'
-  spec.version    = '0.2.2'
+  spec.version    = '0.3.0'
   spec.author     = 'Daniel J. Berger'
   spec.email      = 'djberg96@gmail.com'
   spec.license    = 'Apache-2.0'
@@ -28,6 +28,7 @@ Gem::Specification.new do |spec|
     'source_code_uri'       => 'https://github.com/djberg96/notation',
     'wiki_uri'              => 'https://github.com/djberg96/notation/wiki',
     'rubygems_mfa_required' => 'true',
-    'github_repo'           => 'https://github.com/djberg96/notation'
+    'github_repo'           => 'https://github.com/djberg96/notation',
+    'funding_uri'           => 'https://github.com/sponsors/djberg96'
   }
 end

data/spec/notation_spec.rb

@@ -11,23 +11,108 @@ require 'notation'
 
 RSpec.describe 'Notation' do
   example 'version' do
-    expect(Kernel::NOTATION_VERSION).to eq('0.2.2')
+    expect(Kernel::NOTATION_VERSION).to eq('0.3.0')
     expect(Kernel::NOTATION_VERSION).to be_frozen
   end
 
-  example 'sigma' do
+  example 'sigma (sum)' do
     expect(Kernel).to respond_to(:∑)
     expect(∑(1, 2, 3)).to eq(6)
+    expect(∑([1, 2, 3])).to eq(6)
   end
 
-  example 'pi' do
+  example 'pi (product)' do
     expect(Kernel).to respond_to(:∏)
     expect(∏(2, 3, 4)).to eq(24)
+    expect(∏([2, 3, 4])).to eq(24)
   end
 
   example 'square_root' do
     expect(Kernel).to respond_to(:√)
     expect(√(49)).to eq(7.0)
+    expect(√(16)).to eq(4.0)
+  end
+
+  example 'cube_root' do
+    expect(Kernel).to respond_to(:∛)
+    expect(∛(27)).to eq(3.0)
+    expect(∛(-8)).to eq(-2.0)
+  end
+
+  example 'fourth_root' do
+    expect(Kernel).to respond_to(:∜)
+    expect(∜(16)).to eq(2.0)
+    expect(∜(81)).to eq(3.0)
+  end
+
+  example 'absolute_value' do
+    expect(Kernel).to respond_to(:｜)
+    expect(｜(-5)).to eq(5)
+    expect(｜(5)).to eq(5)
+    expect(｜(0)).to eq(0)
+  end
+
+  example 'infinity' do
+    expect(Kernel).to respond_to(:∞)
+    expect(∞).to eq(Float::INFINITY)
+  end
+
+  example 'factorial' do
+    expect(Kernel).to respond_to(:！)
+    expect(！(5)).to eq(120)
+    expect(！(0)).to eq(1)
+    expect(！(1)).to eq(1)
+    expect { ！(-1) }.to raise_error(ArgumentError)
+  end
+
+  example 'delta (difference)' do
+    expect(Kernel).to respond_to(:Δ)
+    expect(Δ(10, 7)).to eq(3)
+    expect(Δ(7, 10)).to eq(3)
+  end
+
+  example 'approximately_equal' do
+    expect(Kernel).to respond_to(:≈)
+    expect(≈(3.14159, 3.14160, 0.001)).to be true
+    expect(≈(3.14159, 3.15159, 0.001)).to be false
+  end
+
+  example 'not_equal' do
+    expect(Kernel).to respond_to(:≠)
+    expect(≠(5, 3)).to be true
+    expect(≠(5, 5)).to be false
+  end
+
+  example 'less_than_or_equal' do
+    expect(Kernel).to respond_to(:≤)
+    expect(≤(5, 10)).to be true
+    expect(≤(5, 5)).to be true
+    expect(≤(10, 5)).to be false
+  end
+
+  example 'greater_than_or_equal' do
+    expect(Kernel).to respond_to(:≥)
+    expect(≥(10, 5)).to be true
+    expect(≥(5, 5)).to be true
+    expect(≥(5, 10)).to be false
+  end
+
+  example 'plus_or_minus' do
+    expect(Kernel).to respond_to(:±)
+    expect(±(5, 2)).to eq([3, 7])
+    expect(±(10, 1)).to eq([9, 11])
+  end
+
+  example 'degrees_to_radians' do
+    expect(Kernel).to respond_to(:°)
+    expect(°(180)).to be_within(0.0001).of(Math::PI)
+    expect(°(90)).to be_within(0.0001).of(Math::PI / 2)
+  end
+
+  example 'percentage' do
+    expect(Kernel).to respond_to(:％)
+    expect(％(50)).to eq(0.5)
+    expect(％(100)).to eq(1.0)
   end
 
   example 'lambda' do

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: notation
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Daniel J. Berger
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -35,7 +35,7 @@ cert_chain:
   ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
   WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
   -----END CERTIFICATE-----
-date: 2024-06-23 00:00:00.000000000 Z
+date: 2025-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -95,7 +95,8 @@ metadata:
   wiki_uri: https://github.com/djberg96/notation/wiki
   rubygems_mfa_required: 'true'
   github_repo: https://github.com/djberg96/notation
-post_install_message: 
+  funding_uri: https://github.com/sponsors/djberg96
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -110,8 +111,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Unicode symbols that can be used as methods.
 test_files: