foxmath 0.1.0__py3-none-any.whl

foxmath/foxmath.py

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+"""
+FoxMath — Minimalist math & crypto explorer 🦊
+One binary. Clean. Educational. Safe.
+"""
+
+import argparse
+import sys
+import json
+from decimal import Decimal, getcontext
+from pathlib import Path
+
+# ------------------- Math Functions -------------------
+
+def legendre_symbol(a: int, p: int) -> int:
+    """Compute Legendre symbol (a/p)"""
+    if p < 2 or p % 2 == 0:
+        raise ValueError("p must be an odd prime")
+    res = pow(a, (p - 1) // 2, p)
+    return 1 if res == 1 else (-1 if res == p - 1 else 0)
+
+def _arctan_series(inv_n: Decimal, terms: int) -> Decimal:
+    """arctan(1/n) via its Taylor series, evaluated to `terms` terms. `inv_n` is 1/n."""
+    total = Decimal(0)
+    for k in range(terms):
+        sign = Decimal(-1) ** k
+        total += sign * inv_n**(2 * k + 1) / (2 * k + 1)
+    return total
+
+def catalan_pi_approx(terms: int = 100) -> Decimal:
+    """
+    Fast-converging π approximation via the Euler/Hermann Machin-like
+    identity: pi/4 = arctan(1/2) + arctan(1/3).
+    """
+    getcontext().prec = 50
+    s = _arctan_series(Decimal(1) / 2, terms) + _arctan_series(Decimal(1) / 3, terms)
+    return 4 * s
+
+def ec_point_add(x1, y1, x2, y2, a, p):
+    """Simple elliptic curve point addition over finite field y² = x³ + a x + b (mod p)"""
+    if x1 % p == x2 % p and (y1 + y2) % p == 0:
+        raise ValueError(
+            "Result is the point at infinity (P + (-P)); this simplified "
+            "implementation has no way to represent it."
+        )
+    if x1 == x2 and y1 == y2:
+        # Doubling
+        lam = (3 * x1**2 + a) * pow(2 * y1, -1, p) % p
+    else:
+        lam = (y2 - y1) * pow(x2 - x1, -1, p) % p
+    x3 = (lam**2 - x1 - x2) % p
+    y3 = (lam * (x1 - x3) - y1) % p
+    return x3, y3
+
+# ------------------- CLI -------------------
+
+def get_command():
+    """Support symlinks: foxmath-legendre, foxmath-pi, etc."""
+    name = Path(sys.argv[0]).stem.lower()
+    if name.startswith("foxmath-"):
+        return name.split("-", 1)[1]
+    return None
+
+def main():
+    cmd = get_command()
+
+    # Handle --json independently of argparse subparser scoping: a subparser's
+    # own default for a same-named flag silently overwrites whatever the
+    # parent parser already parsed for it, so --json only ever worked in one
+    # position when defined via argparse directly. Strip it out manually
+    # instead, so it works before or after the subcommand.
+    argv = sys.argv[1:]
+    json_output = "--json" in argv
+    argv = [a for a in argv if a != "--json"]
+
+    if cmd:
+        # Symlink invocation (e.g. `foxmath-legendre 2 7`): argparse's
+        # subparsers positional still expects a command-name token next,
+        # so without this it tries to match the first real argument
+        # (e.g. "2") against {legendre,pi,ecadd} and fails. Inject the
+        # detected command so it parses exactly as if typed explicitly.
+        argv = [cmd] + argv
+
+    parser = argparse.ArgumentParser(description="FoxMath — Math & Crypto Explorer 🦊")
+    subparsers = parser.add_subparsers(dest="command", required=not cmd)
+
+    # Legendre
+    leg = subparsers.add_parser("legendre", help="Legendre symbol (a/p)")
+    leg.add_argument("a", type=int, help="Integer a")
+    leg.add_argument("p", type=int, help="Odd prime p")
+
+    # Pi
+    pi_cmd = subparsers.add_parser("pi", help="Catalan-inspired π approximation")
+    pi_cmd.add_argument("--terms", type=int, default=100)
+
+    # Elliptic curve add
+    ec = subparsers.add_parser("ecadd", help="Elliptic curve point addition")
+    ec.add_argument("--x1", type=int, required=True)
+    ec.add_argument("--y1", type=int, required=True)
+    ec.add_argument("--x2", type=int, required=True)
+    ec.add_argument("--y2", type=int, required=True)
+    ec.add_argument("--a", type=int, default=-3, help="Curve parameter a")
+    ec.add_argument("--p", type=int, required=True, help="Prime modulus")
+
+    args = parser.parse_args(argv)
+
+    result = {"tool": "foxmath"}
+
+    try:
+        if cmd == "legendre" or args.command == "legendre":
+            ls = legendre_symbol(args.a, args.p)
+            result.update({"command": "legendre", "a": args.a, "p": args.p, "value": ls})
+            print(f"Legendre ({args.a}/{args.p}) = {ls}")
+
+        elif cmd == "pi" or args.command == "pi":
+            approx = catalan_pi_approx(args.terms)
+            result.update({"command": "pi", "terms": args.terms, "approx": str(approx)})
+            print(f"π ≈ {approx}  ({args.terms} terms)")
+
+        elif cmd == "ecadd" or args.command == "ecadd":
+            x3, y3 = ec_point_add(args.x1, args.y1, args.x2, args.y2, args.a, args.p)
+            result.update({"command": "ecadd", "result": (x3, y3)})
+            print(f"Result point: ({x3}, {y3})")
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if json_output:
+        print(json.dumps(result, indent=2))
+
+if __name__ == "__main__":
+    main()

foxmath-0.1.0.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: foxmath
+Version: 0.1.0
+Summary: Minimalist CLI for math & cryptography exploration 🦊
+Author-email: Abhrankan Chakrabarti <abhrankan@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Abhrankan-Chakrabarti/foxmath
+Project-URL: Repository, https://github.com/Abhrankan-Chakrabarti/foxmath
+Keywords: math,cryptography,cli,number-theory,elliptic-curves
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# FoxMath 🦊
+
+**Minimalist CLI for math & cryptography exploration.**
+
+One binary. Clean output. Zero footguns. Educational by design.
+
+Built with curiosity — for students, tinkerers, and crypto/math enthusiasts.
+
+## Features
+- Legendre symbol
+- Catalan-inspired π approximation
+- Elliptic curve point addition (over finite fields)
+- Symlink-friendly (foxmath-legendre, foxmath-pi, foxmath-ecadd)
+- JSON output mode
+- Coming soon: CRT, continued fractions, challenge mode, more curves
+
+## Installation
+
+```bash
+pip install foxmath
+```
+
+Or from source:
+```bash
+git clone https://github.com/Abhrankan-Chakrabarti/foxmath.git
+cd foxmath
+pip install -e .
+```
+
+## Usage Examples
+
+```bash
+# Basic
+foxmath pi --terms 200
+foxmath legendre 5 17
+
+# Symlinks (optional)
+foxmath-ecadd --x1 1 --y1 2 --x2 3 --y2 4 --p 17
+
+# JSON output
+foxmath pi --terms 100 --json
+```
+
+### Example Output
+```
+π ≈ 3.1415926535897932384626433832795028841971693993751  (200 terms)
+```
+
+## Why FoxMath?
+Because math and cryptography are more fun when you can play with them instantly in the terminal — with the same reliability as FoxPipe and fox-vault.
+
+**Simple. Practical. Reliable.**
+
+## License
+MIT © Abhrankan Chakrabarti
+
+---
+
+**Star if you find it useful!** Issues and PRs welcome.

foxmath-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+foxmath/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+foxmath/foxmath.py,sha256=jUHwCBJ7jKApJzzLwhmv6CBMXdb09cQjapNAtAQS8hs,4951
+foxmath-0.1.0.dist-info/licenses/LICENSE,sha256=KuFxoMq6nEy9Q6D7oDpof2DmGPWg0ztuS3BrnLTwMPY,1078
+foxmath-0.1.0.dist-info/METADATA,sha256=inTpRhGOxuFDBXv8NxIXH9z5zVcAXOpAJmMXkZjZPtA,2023
+foxmath-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+foxmath-0.1.0.dist-info/entry_points.txt,sha256=-L4O5v1cnHMfGnxlxTyBBjBOMl4wVCNUFS7NqSJAEnY,49
+foxmath-0.1.0.dist-info/top_level.txt,sha256=jFrfdE461tQcSDZtoodnhvICZLKw1gLb2DNvFkcuFRg,8
+foxmath-0.1.0.dist-info/RECORD,,

foxmath-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

foxmath-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+foxmath = foxmath.foxmath:main

foxmath-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abhrankan Chakrabarti
+
+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.

foxmath-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+foxmath