pijush-calculator 0.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cb842ad15f15e9cbcf01a2c7bc8ab7ce6177793384f13098ae8e312a2c2e0895
+  data.tar.gz: 9c9a0af3577cc92f1d8d4b24071b72b41ce3e9d1a418847f4ed5500c7910a4c1
+SHA512:
+  metadata.gz: 12d77661668cab7c1b8483d427e7a6c27b94a54e973c5bd567920b783958c34ea3268e212bb61e6e88019b8969d661e6eab8445731aae00c3d29bcc664fa525e
+  data.tar.gz: 6f58d957986e3278b82c4ef97315cf587d14d91f3d1431e45d36ae113001ff29a16fb2343f682a8f64c2712bc400b6e96e5ebe87a37debe7e4e1d7f1f6cb5acc

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pijush Chakraborty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,83 @@
+# pijush-calculator
+
+Advanced, dependency-free Ruby numerical engine for calculator, scientific-math, statistics, and reusable application tooling.
+
+## Engine capabilities
+
+- Basic arithmetic: add, subtract, multiply, divide, modulo, power, percentage
+- Utilities: absolute, min/max, average/mean, sum, product, clamp, reciprocal, square, cube
+- Roots: square root and cube root
+- Number theory: factorial, GCD, LCM, combinations, permutations
+- Trigonometry: sine, cosine, tangent, secant, cosecant, cotangent
+- Inverse trigonometry with optional degree output
+- Hyperbolic sine, cosine, tangent
+- Logarithms and exponentials
+- Multi-value hypotenuse calculation
+- Statistics: median, population variance, standard deviation, range
+- Approximate equality helper with configurable tolerance
+- Explicit domain and zero-division validation
+- Ruby 3.0+
+- Zero runtime dependencies
+
+## Installation
+
+```bash
+gem install pijush-calculator
+```
+
+GitHub Packages:
+
+```bash
+gem install pijush-calculator --source https://rubygems.pkg.github.com/TEJAS-MK2
+```
+
+## Usage
+
+```ruby
+require "pijush_calculator"
+
+PijushCalculator.add(2, 3)              # 5
+PijushCalculator.square_root(144)       # 12.0
+PijushCalculator.factorial(6)           # 720
+PijushCalculator.median(9, 2, 7, 4, 5) # 5
+PijushCalculator.sine(90, true)         # 1.0
+```
+
+## API
+
+| Group | Methods |
+|---|---|
+| Arithmetic | `add`, `subtract`, `multiply`, `divide`, `modulo`, `power`, `percentage` |
+| Utilities | `absolute`, `minimum`, `maximum`, `average`, `mean`, `sum`, `product`, `clamp`, `reciprocal` |
+| Roots | `square_root`, `cube_root`, `square`, `cube` |
+| Number theory | `factorial`, `gcd`, `lcm`, `combinations`, `permutations` |
+| Trigonometry | `sine`, `cosine`, `tangent`, `secant`, `cosecant`, `cotangent` |
+| Inverse trig | `arcsine`, `arccosine`, `arctangent` |
+| Scientific | `logarithm`, `natural_log`, `exponential`, `hypot` |
+| Statistics | `median`, `variance`, `standard_deviation`, `range` |
+
+## Development
+
+```bash
+gem build pijush-calculator.gemspec
+gem test
+```
+
+## Publishing
+
+Releases are handled through GitHub Actions. Published versions are immutable; every release requires a new version. Credentials must never be committed.
+
+## Package information
+
+| Property | Value |
+|---|---|
+| Gem | `pijush-calculator` |
+| RubyGems | `https://rubygems.org/gems/pijush-calculator` |
+| GitHub Packages | `https://github.com/TEJAS-MK2/Calculator/packages` |
+| Runtime dependencies | None |
+| Supported Ruby | 3.0+ |
+| License | MIT |
+
+## License
+
+MIT

data/lib/pijush_calculator.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module PijushCalculator
+  VERSION = "0.6.0"
+  module_function
+
+  def add(a,b)=a+b
+  def subtract(a,b)=a-b
+  def multiply(a,b)=a*b
+  def divide(a,b);raise ZeroDivisionError,"cannot divide by zero" if b==0;a.to_f/b;end
+  def modulo(a,b);raise ZeroDivisionError,"cannot modulo by zero" if b==0;a%b;end
+  def power(a,b);raise ZeroDivisionError,"cannot raise zero to a negative power" if a==0&&b.to_f<0;a**b;end
+  def percentage(value,percent)=value*percent/100.0
+  def absolute(value)=value.abs
+  def minimum(*values);raise ArgumentError,"minimum requires a value" if values.empty?;values.min;end
+  def maximum(*values);raise ArgumentError,"maximum requires a value" if values.empty?;values.max;end
+  def average(*values);raise ArgumentError,"average requires a value" if values.empty?;values.sum.to_f/values.length;end
+  def mean(*values)=average(*values)
+  def sum(*values)=values.sum
+  def product(*values)=values.reduce(1,:*)
+  def clamp(value,minimum_value,maximum_value);raise ArgumentError,"minimum cannot exceed maximum" if minimum_value>maximum_value;[[value,minimum_value].max,maximum_value].min;end
+  def reciprocal(value);raise ZeroDivisionError,"cannot take reciprocal of zero" if value==0;1.0/value;end
+  def square(value)=value*value
+  def cube(value)=value*value*value
+  def square_root(value);raise ArgumentError,"square root requires a non-negative value" if value<0;Math.sqrt(value);end
+  def cube_root(value)=Math.cbrt(value)
+  def nth_root(value,degree);raise ArgumentError,"root degree cannot be zero" if degree==0;raise ArgumentError,"even root requires a non-negative value" if value<0&&degree.to_i.even?;value<0 ? -((-value)**(1.0/degree)) : value**(1.0/degree);end
+  def factorial(value);n=Integer(value);raise ArgumentError,"factorial requires a non-negative integer" if n<0;(1..n).reduce(1,:*);end
+  def gcd(a,b)=a.to_i.gcd(b.to_i)
+  def lcm(a,b)=a.to_i.lcm(b.to_i)
+  def sine(value,degrees=false)=Math.sin(degrees ? value*Math::PI/180 : value)
+  def cosine(value,degrees=false)=Math.cos(degrees ? value*Math::PI/180 : value)
+  def tangent(value,degrees=false)=Math.tan(degrees ? value*Math::PI/180 : value)
+  def secant(value,degrees=false)=1.0/cosine(value,degrees)
+  def cosecant(value,degrees=false)=1.0/sine(value,degrees)
+  def cotangent(value,degrees=false)=1.0/tangent(value,degrees)
+  def arcsine(value,degrees=false);r=Math.asin(value);degrees ? r*180/Math::PI : r;end
+  def arccosine(value,degrees=false);r=Math.acos(value);degrees ? r*180/Math::PI : r;end
+  def arctangent(value,degrees=false);r=Math.atan(value);degrees ? r*180/Math::PI : r;end
+  def atan2(y,x,degrees=false);r=Math.atan2(y,x);degrees ? r*180/Math::PI : r;end
+  def hyperbolic_sine(value)=Math.sinh(value)
+  def hyperbolic_cosine(value)=Math.cosh(value)
+  def hyperbolic_tangent(value)=Math.tanh(value)
+  def logarithm(value,base=10);raise ArgumentError,"invalid logarithm domain" if value<=0||base<=0||base==1;Math.log(value,base);end
+  def log2(value);raise ArgumentError,"log2 requires a positive value" if value<=0;Math.log(value,2);end
+  def log1p(value);raise ArgumentError,"log1p requires a value greater than -1" if value<=-1;Math.log(1+value);end
+  def expm1(value)=Math.exp(value)-1
+  def natural_log(value);raise ArgumentError,"natural logarithm requires a positive value" if value<=0;Math.log(value);end
+  def exponential(value)=Math.exp(value)
+  def hypot(*values);raise ArgumentError,"hypot requires a value" if values.empty?;Math.hypot(*values);end
+  def combinations(n,r);n=Integer(n);r=Integer(r);raise ArgumentError,"invalid combination range" if n<0||r<0||r>n;(n-r+1..n).reduce(1,:*)/(1..r).reduce(1,:*).to_f;end
+  def permutations(n,r);n=Integer(n);r=Integer(r);raise ArgumentError,"invalid permutation range" if n<0||r<0||r>n;(n-r+1..n).reduce(1,:*);end
+  def median(*values);raise ArgumentError,"median requires a value" if values.empty?;s=values.sort;mid=s.length/2;s.length.odd? ? s[mid] : (s[mid-1]+s[mid]).to_f/2;end
+  def variance(*values);raise ArgumentError,"variance requires a value" if values.empty?;m=average(*values);values.sum{|v|(v-m)**2}.to_f/values.length;end
+  def standard_deviation(*values)=Math.sqrt(variance(*values))
+  def range(*values);raise ArgumentError,"range requires a value" if values.empty?;maximum(*values)-minimum(*values);end
+  def approximately_equal?(a,b,tolerance=1e-9)=((a-b).abs<=tolerance)
+  def finite?(value)=value.respond_to?(:finite?) ? value.finite? : true
+  def round_to(value,digits=0);raise ArgumentError,"digits must be an integer" unless digits.is_a?(Integer);value.round(digits);end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: pijush-calculator
+version: !ruby/object:Gem::Version
+  version: 0.6.0
+platform: ruby
+authors:
+- Pijush Chakraborty
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-12 00:00:00.000000000 Z
+dependencies: []
+description: Dependency-free Ruby arithmetic API for predictable addition, subtraction,
+  multiplication, and division with explicit division-by-zero handling.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/pijush_calculator.rb
+homepage: https://github.com/TEJAS-MK2/Calculator
+licenses:
+- MIT
+metadata:
+  github_repo: https://github.com/TEJAS-MK2/Calculator
+  source_code_uri: https://github.com/TEJAS-MK2/Calculator/tree/main/ruby-gem
+  bug_tracker_uri: https://github.com/TEJAS-MK2/Calculator/issues
+  changelog_uri: https://github.com/TEJAS-MK2/Calculator/releases
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Lightweight Ruby arithmetic engine for reusable calculator operations.
+test_files: []