Calculator Library

A Python calculator library providing stateless arithmetic, power/root, modulo, rounding, and logarithmic/exponential operations.

Features

16 math calculator functions:

• Two-operand operations: add, subtract, multiply, divide, power, nth_root, modulo, floor_divide
• Single-operand operations: sqrt, absolute, floor, ceil, log10, ln, exp
• Rounding: round_number (with configurable decimal places)

AI Disclaimer

This project includes code and documentation created with the assistance of AI tools. For details on usage, limits, and review practices, please see the AI Disclaimer.

Prerequisites

• Python 3.14+
• pip

Installation

1. Install using pip

pip install calculator-lib-rubens

2. Confirm the installed version matches the latest GitHub release at calculator-lib/releases

pip show calculator-lib-rubens

Uninstall

pip uninstall calculator-lib-rubens
pip cache purge

Quick Start

from calculator_lib import Calculator

calc = Calculator()

calc.add(2, 3)  # 5
calc.subtract(10, 4)  # 6
calc.multiply(3, 4)  # 12
calc.divide(10, 2)  # 5.0

API Reference

Core Arithmetic

Power & Roots

Modulo & Integer Math

Absolute & Rounding

Logarithmic & Exponential

Usage Examples

import math
from calculator_lib import Calculator

calc = Calculator()

# Power & Roots
calc.power(2, 3)  # 8
calc.sqrt(16)  # 4.0
calc.nth_root(27, 3)  # 3.0

# Modulo & Rounding
calc.modulo(10, 3)  # 1
calc.floor_divide(7, 2)  # 3
calc.round_number(3.14159, 2)  # 3.14
calc.floor(3.7)  # 3.0
calc.ceil(3.2)  # 4.0

# Logarithmic & Exponential
calc.log10(100)  # 2.0
calc.ln(math.e)  # 1.0
calc.exp(1)  # 2.718281828459045

Error Handling

All methods validate their inputs and raise ValueError with descriptive messages for invalid operations:

from calculator_lib import Calculator

calc = Calculator()

calc.divide(10, 0)  # ValueError: Cannot divide by zero
calc.sqrt(-1)  # ValueError: Cannot take square root of a negative number
calc.log10(0)  # ValueError: Cannot take logarithm of a non-positive number
calc.nth_root(-4, 2)  # ValueError: Cannot take even root of a negative number
calc.modulo(10, 0)  # ValueError: Cannot modulo by zero

Documentation

• Development Setup
• PyCharm
• Release Process

License

This project is licensed under the MIT License.

Author: Rubens Gomes