arcade-math 1.0.4__tar.gz

arcade_math-1.0.4/.gitignore

@@ -0,0 +1,175 @@
+.DS_Store
+credentials.yaml
+docker/credentials.yaml
+
+*.lock
+
+# example data
+examples/data
+scratch
+
+
+docs/source
+
+# From https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

arcade_math-1.0.4/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+files: ^.*/math/.*
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: "v4.4.0"
+    hooks:
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.7
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

arcade_math-1.0.4/.ruff.toml

@@ -0,0 +1,47 @@
+target-version = "py310"
+line-length = 100
+fix = true
+
+[lint]
+select = [
+    # flake8-2020
+    "YTT",
+    # flake8-bandit
+    "S",
+    # flake8-bugbear
+    "B",
+    # flake8-builtins
+    "A",
+    # flake8-comprehensions
+    "C4",
+    # flake8-debugger
+    "T10",
+    # flake8-simplify
+    "SIM",
+    # isort
+    "I",
+    # mccabe
+    "C90",
+    # pycodestyle
+    "E", "W",
+    # pyflakes
+    "F",
+    # pygrep-hooks
+    "PGH",
+    # pyupgrade
+    "UP",
+    # ruff
+    "RUF",
+    # tryceratops
+    "TRY",
+]
+
+[lint.per-file-ignores]
+"*" = ["TRY003", "B904"]
+"**/tests/*" = ["S101", "E501"]
+"**/evals/*" = ["S101", "E501"]
+
+
+[format]
+preview = true
+skip-magic-trailing-comma = false

arcade_math-1.0.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, Arcade AI
+
+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.

arcade_math-1.0.4/Makefile

@@ -0,0 +1,55 @@
+.PHONY: help
+
+help:
+	@echo "🛠️ github Commands:\n"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+.PHONY: install
+install: ## Install the uv environment and install all packages with dependencies
+	@echo "🚀 Creating virtual environment and installing all packages using uv"
+	@uv sync --active --all-extras --no-sources
+	@if [ -f .pre-commit-config.yaml ]; then uv run --no-sources pre-commit install; fi
+	@echo "✅ All packages and dependencies installed via uv"
+
+.PHONY: install-local
+install-local: ## Install the uv environment and install all packages with dependencies with local Arcade sources
+	@echo "🚀 Creating virtual environment and installing all packages using uv"
+	@uv sync --active --all-extras
+	@if [ -f .pre-commit-config.yaml ]; then uv run pre-commit install; fi
+	@echo "✅ All packages and dependencies installed via uv"
+
+.PHONY: build
+build: clean-build ## Build wheel file using poetry
+	@echo "🚀 Creating wheel file"
+	uv build
+
+.PHONY: clean-build
+clean-build: ## clean build artifacts
+	@echo "🗑️ Cleaning dist directory"
+	rm -rf dist
+
+.PHONY: test
+test: ## Test the code with pytest
+	@echo "🚀 Testing code: Running pytest"
+	@uv run --no-sources pytest -W ignore -v --cov --cov-config=pyproject.toml --cov-report=xml
+
+.PHONY: coverage
+coverage: ## Generate coverage report
+	@echo "coverage report"
+	@uv run --no-sources coverage report
+	@echo "Generating coverage report"
+	@uv run --no-sources coverage html
+
+.PHONY: bump-version
+bump-version: ## Bump the version in the pyproject.toml file by a patch version
+	@echo "🚀 Bumping version in pyproject.toml"
+	uv version --no-sources --bump patch
+
+.PHONY: check
+check: ## Run code quality tools.
+	@if [ -f .pre-commit-config.yaml ]; then\
+		echo "🚀 Linting code: Running pre-commit";\
+		uv run --no-sources pre-commit run -a;\
+	fi
+	@echo "🚀 Static type checking: Running mypy"
+	@uv run --no-sources mypy --config-file=pyproject.toml

arcade_math-1.0.4/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: arcade_math
+Version: 1.0.4
+Summary: Arcade.dev LLM tools for doing math
+Author-email: Arcade <dev@arcade.dev>
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: arcade-tdk<3.0.0,>=2.0.0
+Provides-Extra: dev
+Requires-Dist: arcade-ai[evals]<3.0.0,>=2.0.0; extra == 'dev'
+Requires-Dist: arcade-serve<3.0.0,>=2.0.0; extra == 'dev'
+Requires-Dist: mypy<1.6.0,>=1.5.1; extra == 'dev'
+Requires-Dist: pre-commit<3.5.0,>=3.4.0; extra == 'dev'
+Requires-Dist: pytest-asyncio<0.25.0,>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov<4.1.0,>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-mock<3.12.0,>=3.11.1; extra == 'dev'
+Requires-Dist: pytest<8.4.0,>=8.3.0; extra == 'dev'
+Requires-Dist: ruff<0.8.0,>=0.7.4; extra == 'dev'
+Requires-Dist: tox<4.12.0,>=4.11.1; extra == 'dev'

arcade_math-1.0.4/arcade_math/tools/__init__.py

@@ -0,0 +1,65 @@
+from arcade_math.tools.arithmetic import (
+    add,
+    divide,
+    mod,
+    multiply,
+    subtract,
+    sum_list,
+    sum_range,
+)
+from arcade_math.tools.exponents import (
+    log,
+    power,
+)
+from arcade_math.tools.miscellaneous import (
+    abs_val,
+    factorial,
+    sqrt,
+)
+from arcade_math.tools.random import (
+    generate_random_float,
+    generate_random_int,
+)
+from arcade_math.tools.rational import (
+    gcd,
+    lcm,
+)
+from arcade_math.tools.rounding import (
+    ceil,
+    floor,
+    round_num,
+)
+from arcade_math.tools.statistics import (
+    avg,
+    median,
+)
+from arcade_math.tools.trigonometry import (
+    deg_to_rad,
+    rad_to_deg,
+)
+
+__all__ = [
+    "add",
+    "subtract",
+    "multiply",
+    "divide",
+    "sum_list",
+    "sum_range",
+    "mod",
+    "log",
+    "power",
+    "abs_val",
+    "factorial",
+    "sqrt",
+    "generate_random_float",
+    "generate_random_int",
+    "gcd",
+    "lcm",
+    "ceil",
+    "floor",
+    "round_num",
+    "avg",
+    "median",
+    "deg_to_rad",
+    "rad_to_deg",
+]

arcade_math-1.0.4/arcade_math/tools/arithmetic.py

@@ -0,0 +1,97 @@
+import decimal
+from decimal import Decimal
+from typing import Annotated
+
+from arcade_tdk import tool
+
+decimal.getcontext().prec = 100
+
+
+@tool
+def add(
+    a: Annotated[str, "The first number as a string"],
+    b: Annotated[str, "The second number as a string"],
+) -> Annotated[str, "The sum of the two numbers as a string"]:
+    """
+    Add two numbers together
+    """
+    # Use Decimal for arbitrary precision
+    a_decimal = Decimal(a)
+    b_decimal = Decimal(b)
+    return str(a_decimal + b_decimal)
+
+
+@tool
+def subtract(
+    a: Annotated[str, "The first number as a string"],
+    b: Annotated[str, "The second number as a string"],
+) -> Annotated[str, "The difference of the two numbers as a string"]:
+    """
+    Subtract two numbers
+    """
+    # Use Decimal for arbitrary precision
+    a_decimal = Decimal(a)
+    b_decimal = Decimal(b)
+    return str(a_decimal - b_decimal)
+
+
+@tool
+def multiply(
+    a: Annotated[str, "The first number as a string"],
+    b: Annotated[str, "The second number as a string"],
+) -> Annotated[str, "The product of the two numbers as a string"]:
+    """
+    Multiply two numbers together
+    """
+    # Use Decimal for arbitrary precision
+    a_decimal = Decimal(a)
+    b_decimal = Decimal(b)
+    return str(a_decimal * b_decimal)
+
+
+@tool
+def divide(
+    a: Annotated[str, "The first number as a string"],
+    b: Annotated[str, "The second number as a string"],
+) -> Annotated[str, "The quotient of the two numbers as a string"]:
+    """
+    Divide two numbers
+    """
+    # Use Decimal for arbitrary precision
+    a_decimal = Decimal(a)
+    b_decimal = Decimal(b)
+    return str(a_decimal / b_decimal)
+
+
+@tool
+def sum_list(
+    numbers: Annotated[list[str], "The list of numbers as strings"],
+) -> Annotated[str, "The sum of the numbers in the list as a string"]:
+    """
+    Sum all numbers in a list
+    """
+    # Use Decimal for arbitrary precision
+    return str(sum([Decimal(n) for n in numbers]))
+
+
+@tool
+def sum_range(
+    start: Annotated[str, "The start of the range to sum as a string"],
+    end: Annotated[str, "The end of the range to sum as a string"],
+) -> Annotated[str, "The sum of the numbers in the list as a string"]:
+    """
+    Sum all numbers from start through end
+    """
+    return str(sum(list(range(int(start), int(end) + 1))))
+
+
+@tool
+def mod(
+    a: Annotated[str, "The dividend as a string"],
+    b: Annotated[str, "The divisor as a string"],
+) -> Annotated[str, "The remainder after dividing a by b as a string"]:
+    """
+    Calculate the remainder (modulus) of one number divided by another
+    """
+    # Use Decimal for arbitrary precision
+    return str(Decimal(a) % Decimal(b))

arcade_math-1.0.4/arcade_math/tools/exponents.py

@@ -0,0 +1,32 @@
+import decimal
+import math
+from decimal import Decimal
+from typing import Annotated
+
+from arcade_tdk import tool
+
+decimal.getcontext().prec = 100
+
+
+@tool
+def log(
+    a: Annotated[str, "The number to take the logarithm of as a string"],
+    base: Annotated[str, "The logarithmic base as a string"],
+) -> Annotated[str, "The logarithm of the number with the specified base as a string"]:
+    """
+    Calculate the logarithm of a number with a given base
+    """
+    # Use Decimal for arbitrary precision
+    return str(math.log(Decimal(a), Decimal(base)))
+
+
+@tool
+def power(
+    a: Annotated[str, "The base number as a string"],
+    b: Annotated[str, "The exponent as a string"],
+) -> Annotated[str, "The result of raising a to the power of b as a string"]:
+    """
+    Calculate one number raised to the power of another
+    """
+    # Use Decimal for arbitrary precision
+    return str(Decimal(a) ** Decimal(b))

arcade_math-1.0.4/arcade_math/tools/miscellaneous.py

@@ -0,0 +1,42 @@
+import decimal
+import math
+from decimal import Decimal
+from typing import Annotated
+
+from arcade_tdk import tool
+
+decimal.getcontext().prec = 100
+
+
+@tool
+def abs_val(
+    a: Annotated[str, "The number as a string"],
+) -> Annotated[str, "The absolute value of the number as a string"]:
+    """
+    Calculate the absolute value of a number
+    """
+    # Use Decimal for arbitrary precision
+    return str(abs(Decimal(a)))
+
+
+@tool
+def factorial(
+    a: Annotated[str, "The non-negative integer to compute the factorial for as a string"],
+) -> Annotated[str, "The factorial of the number as a string"]:
+    """
+    Compute the factorial of a non-negative integer
+    Returns "1" for "0"
+    """
+    return str(math.factorial(int(a)))
+
+
+@tool
+def sqrt(
+    a: Annotated[str, "The number to square root as a string"],
+) -> Annotated[str, "The square root of the number as a string"]:
+    """
+    Get the square root of a number
+    """
+    # Use Decimal for arbitrary precision
+    a_decimal = Decimal(a)
+    return str(a_decimal.sqrt())

arcade_math-1.0.4/arcade_math/tools/random.py

@@ -0,0 +1,38 @@
+import random
+from typing import Annotated
+
+from arcade_tdk import tool
+
+
+@tool
+def generate_random_int(
+    min_value: Annotated[str, "The minimum value of the random integer as a string"],
+    max_value: Annotated[str, "The maximum value of the random integer as a string"],
+    seed: Annotated[
+        str | None,
+        "The seed for the random number generator as a string."
+        " If None, the current system time is used.",
+    ] = None,
+) -> Annotated[str, "A random integer between min_value and max_value as a string"]:
+    """Generate a random integer between min_value and max_value (inclusive)."""
+    if seed is not None:
+        random.seed(int(seed))
+
+    return str(random.randint(int(min_value), int(max_value)))  # noqa: S311
+
+
+@tool
+def generate_random_float(
+    min_value: Annotated[str, "The minimum value of the random float as a string"],
+    max_value: Annotated[str, "The maximum value of the random float as a string"],
+    seed: Annotated[
+        str | None,
+        "The seed for the random number generator as a string."
+        " If None, the current system time is used.",
+    ] = None,
+) -> Annotated[str, "A random float between min_value and max_value as a string"]:
+    """Generate a random float between min_value and max_value."""
+    if seed is not None:
+        random.seed(int(seed))
+
+    return str(random.uniform(float(min_value), float(max_value)))  # noqa: S311

arcade_math-1.0.4/arcade_math/tools/rational.py

@@ -0,0 +1,30 @@
+import math
+from typing import Annotated
+
+from arcade_tdk import tool
+
+
+@tool
+def gcd(
+    a: Annotated[str, "First integer as a string"],
+    b: Annotated[str, "Second integer as a string"],
+) -> Annotated[str, "The greatest common divisor of a and b as a string"]:
+    """
+    Calculate the greatest common divisor (GCD) of two integers.
+    """
+    return str(math.gcd(int(a), int(b)))
+
+
+@tool
+def lcm(
+    a: Annotated[str, "First integer as a string"],
+    b: Annotated[str, "Second integer as a string"],
+) -> Annotated[str, "The least common multiple of a and b as a string"]:
+    """
+    Calculate the least common multiple (LCM) of two integers.
+    Returns "0" if either integer is 0.
+    """
+    a_int, b_int = int(a), int(b)
+    if a_int == 0 or b_int == 0:
+        return "0"
+    return str(abs(a_int * b_int) // math.gcd(a_int, b_int))

arcade_math-1.0.4/arcade_math/tools/rounding.py

@@ -0,0 +1,47 @@
+import decimal
+import math
+from decimal import Decimal
+from typing import Annotated
+
+from arcade_tdk import tool
+
+decimal.getcontext().prec = 100
+
+
+@tool
+def ceil(
+    a: Annotated[str, "The number to round up as a string"],
+) -> Annotated[str, "The smallest integer greater than or equal to the number as a string"]:
+    """
+    Return the ceiling of a number
+    """
+    # Use Decimal for arbitrary precision
+    return str(math.ceil(Decimal(a)))
+
+
+@tool
+def floor(
+    a: Annotated[str, "The number to round down as a string"],
+) -> Annotated[str, "The largest integer less than or equal to the number as a string"]:
+    """
+    Return the floor of a number
+    """
+    # Use Decimal for arbitrary precision
+    return str(math.floor(Decimal(a)))
+
+
+@tool
+def round_num(
+    value: Annotated[str, "The number to round as a string"],
+    ndigits: Annotated[str, "The number of digits after the decimal point as a string"],
+) -> Annotated[str, "The number rounded to the specified number of digits as a string"]:
+    """
+    Round a number to a specified number of positive digits
+    """
+    ndigits_int = int(ndigits)
+    if ndigits_int >= 0:
+        # Use Decimal for arbitrary precision
+        return str(round(Decimal(value), int(ndigits_int)))
+    # cast value from str -> float -> int here because rounding with negative
+    # decimals is only useful for weird math
+    return str(round(int(float(value)), int(ndigits_int)))