notation 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09bbac1adce0c9a99319b9acbf60c52debeba9cc14b7eb7b6bfc6a2b5eb9878b'
-  data.tar.gz: e6495aece79cbc99129e56884a2a06eb1194d5b28ed498e7fa52441c5f291c46
+  metadata.gz: 36a4c918f1fa1b18facae1b46a6ce84f350434f6beeff794d6f759068762f0ac
+  data.tar.gz: 8b7fdbb5388cf332e791189fc399f192ea2ea47999eac90ecaf0a87186374480
 SHA512:
-  metadata.gz: 935d9d65981d2087654981d7688aaf56a7b06839bce8f0a731a8b1b5c56fe80b6ed1e176872aaf0a398d35b836bd81e02d58ec6e90d63c585abc0a49c8e265ba
-  data.tar.gz: 4f2d8396ed4db4acdae2b39235559c50f202cb5b3adc4e325f22a618d4b87744fac9ebde228596b60fa54742bcac31a39a11305c108af951bdcc61fb39909565
+  metadata.gz: 6d47b34b3651a4652d061b8fdb000440863f4e8c5b8b18808c466eb21ff673565311961a1dbce73f4a156283bf9d626b0a3bb6391a6ca93f861cc9b7fd273187
+  data.tar.gz: e0ba3d661748fded3a500f466f46ccc2f1786106926695b3c351435884393d900327aec1b1f832f36193223b6ad77627c909d9cf384dd7dd15544a474ea16734

data/CHANGES.md

@@ -1,3 +1,21 @@
+## 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/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/README.md

@@ -1,17 +1,43 @@
+[![Ruby](https://github.com/djberg96/notation/actions/workflows/ruby.yml/badge.svg)](https://github.com/djberg96/notation/actions/workflows/ruby.yml)
+
 ## Description
 Unicode methods for Ruby.
 
 ## Installation
 `gem install notation`
 
+## Installing the Trusted Cert
+
+`gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/notation/main/certs/djberg96_pub.pem)`
+
 ## 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
@@ -29,6 +55,6 @@ All Rights Reserved
 
 ## License
 Apache-2.0
-	
+
 ## Author
 Daniel Berger

data/Rakefile

@@ -2,13 +2,13 @@ require 'rake'
 require 'rake/clean'
 require 'rspec/core/rake_task'
 
-CLEAN.include("**/*.gem", "**/*.rbc")
+CLEAN.include("**/*.gem", "**/*.rbc", "**/*.lock")
 
 namespace :gem do
   desc 'Build the notation gem'
   task :create => [:clean] do
     require 'rubygems/package'
-    spec = eval(IO.read('notation.gemspec'))
+    spec = Gem::Specification.load('notation.gemspec')
     spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
     Gem::Package.build(spec)
   end

data/lib/notation.rb

@@ -1,10 +1,9 @@
-# encoding: utf-8
-
-# Run with -Ku if using Ruby 1.8.
+# frozen_string_literal: true
 
+# Extend the core Kernel module
 module Kernel
   # Version of the notation library
-  NOTATION_VERSION = '0.2.1'.freeze
+  NOTATION_VERSION = '0.3.0'
 
   # Make lambda a true lambda
   #
@@ -14,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
@@ -36,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.1'
+  spec.version    = '0.3.0'
   spec.author     = 'Daniel J. Berger'
   spec.email      = 'djberg96@gmail.com'
   spec.license    = 'Apache-2.0'
@@ -13,6 +13,7 @@ Gem::Specification.new do |spec|
   spec.cert_chain = Dir['certs/*']
 
   spec.add_development_dependency('rake')
+  spec.add_development_dependency('rspec', '~> 3.9')
 
   spec.description = <<-EOF
     The notation library provides unicode symbols that you can use as
@@ -20,11 +21,14 @@ Gem::Specification.new do |spec|
   EOF
 
   spec.metadata = {
-    'homepage_uri'      => 'https://github.com/djberg96/notation',
-    'bug_tracker_uri'   => 'https://github.com/djberg96/notation/issues',
-    'changelog_uri'     => 'https://github.com/djberg96/notation/blob/master/CHANGES.md',
-    'documentation_uri' => 'https://github.com/djberg96/notation/wiki',
-    'source_code_uri'   => 'https://github.com/djberg96/notation',
-    'wiki_uri'          => 'https://github.com/djberg96/notation/wiki'
+    'homepage_uri'          => 'https://github.com/djberg96/notation',
+    'bug_tracker_uri'       => 'https://github.com/djberg96/notation/issues',
+    'changelog_uri'         => 'https://github.com/djberg96/notation/blob/πρῶτον/CHANGES.md',
+    'documentation_uri'     => 'https://github.com/djberg96/notation/wiki',
+    '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',
+    'funding_uri'           => 'https://github.com/sponsors/djberg96'
   }
 end

data/spec/notation_spec.rb

@@ -1,4 +1,5 @@
-# encoding: utf-8
+# frozen_string_literal: true
+
 ################################################################
 # notation_spec.rb
 #
@@ -8,28 +9,113 @@
 require 'rspec'
 require 'notation'
 
-RSpec.describe "Notation" do
-  example "version" do
-    expect(Kernel::NOTATION_VERSION).to eq('0.2.1')
+RSpec.describe 'Notation' do
+  example 'version' do
+    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)
+    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)
+    expect(∏([2, 3, 4])).to eq(24)
   end
 
-  example "square_root" do
+  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
+  example 'lambda' do
     expect(λ{ 'hello' }.call).to eq('hello')
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: notation
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -35,7 +35,7 @@ cert_chain:
   ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
   WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
   -----END CERTIFICATE-----
-date: 2021-02-20 00:00:00.000000000 Z
+date: 2025-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -51,6 +51,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
 description: |2
       The notation library provides unicode symbols that you can use as
       methods instead of using standard method names.
@@ -60,6 +74,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGES.md
+- Gemfile
 - LICENSE
 - MANIFEST.md
 - README.md
@@ -74,10 +89,13 @@ licenses:
 metadata:
   homepage_uri: https://github.com/djberg96/notation
   bug_tracker_uri: https://github.com/djberg96/notation/issues
-  changelog_uri: https://github.com/djberg96/notation/blob/master/CHANGES.md
+  changelog_uri: https://github.com/djberg96/notation/blob/πρῶτον/CHANGES.md
   documentation_uri: https://github.com/djberg96/notation/wiki
   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
+  funding_uri: https://github.com/sponsors/djberg96
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -93,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Unicode symbols that can be used as methods.