mcp-abacus 0.1.0__tar.gz

mcp_abacus-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,11 @@
+# GitHub Sponsors / funding configuration.
+# This enables the "Sponsor" button on the repository.
+# Sponsorship tiers (and their perks) are configured in the GitHub Sponsors
+# dashboard, not in this file.
+
+github: [laszlopere]
+
+# Other funding platforms are also supported, e.g.:
+# ko_fi: your_kofi_name
+# liberapay: your_liberapay_name
+# custom: ["https://example.com/donate"]

mcp_abacus-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Report something that doesn't work as expected
+title: ""
+labels: bug
+assignees: ""
+---
+
+**What happened**
+A clear description of the bug.
+
+**What you expected**
+What you expected to happen instead.
+
+**Reproduction**
+A minimal expression, mode, and tool call that triggers it.
+
+**Environment**
+- mcp-abacus version: <!-- the installed version, e.g. `pip show mcp-abacus` / `uv tool list` -->
+- Python version: <!-- `python --version` -->
+- Mode(s): <!-- e.g. floating-point / rational / fixed-point / signed-integer-64 -->
+- OS: <!-- e.g. Ubuntu 24.04 -->
+
+**Logs / output**
+Any relevant error output (please redact secrets).

mcp_abacus-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

mcp_abacus-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an improvement or a new capability
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+**The problem**
+What are you trying to do that's hard or impossible today?
+
+**Proposed solution**
+What you'd like to see — a new mode, operator, function, or behavior change.
+
+**Alternatives considered**
+Other approaches you've thought about, including workarounds with the existing
+modes and expression language.
+
+**Additional context**
+Anything else relevant (the numeric mode, an example expression, links).

mcp_abacus-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+<!-- Thanks for contributing to mcp-abacus! -->
+
+**What this changes**
+A short description of the change and why.
+
+**Related issues**
+Closes #<!-- issue number -->, if applicable.
+
+**Checklist**
+- [ ] `ruff check .` and `ruff format --check .` pass
+- [ ] `mypy` passes
+- [ ] `pytest` passes
+- [ ] Docs/README updated if behavior or tools changed
+- [ ] New modes/operators/functions stay type-faithful and consistent across the numeric regimes where relevant

mcp_abacus-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install the project
+        # Let uv manage a project venv; installing into the runner's system
+        # Python fails under PEP 668 (externally managed).
+        run: uv sync --all-extras --python ${{ matrix.python-version }}
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Format check (ruff)
+        run: uv run ruff format --check .
+
+      - name: Type-check (mypy)
+        run: uv run mypy
+
+      - name: Test (pytest)
+        run: uv run pytest -v

mcp_abacus-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Release
+
+# Publishes to PyPI via Trusted Publishing (OIDC) on a version tag, e.g. v0.2.0.
+# No API tokens are stored: PyPI verifies the GitHub OIDC identity instead.
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Check distributions
+        run: uvx twine check dist/*
+
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # The trusted publisher on PyPI is bound to this environment name.
+    environment: pypi
+    permissions:
+      id-token: write # required for OIDC
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

mcp_abacus-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Byte-compiled / optimized
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# Test / tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Editors
+.idea/
+.vscode/
+*.swp

mcp_abacus-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,56 @@
+# Contributing to mcp-abacus
+
+Thanks for your interest in improving **mcp-abacus**! Contributions of all kinds
+are welcome — bug reports, feature requests, docs, and code.
+
+## Where things live
+
+- Source: [`github.com/laszlopere/mcp-abacus`](https://github.com/laszlopere/mcp-abacus)
+- Issues & feature requests: <https://github.com/laszlopere/mcp-abacus/issues>
+- Package source lives under `src/mcp_abacus/`; tests under `tests/`.
+
+## Development setup
+
+```bash
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+## Checks before opening a PR
+
+The CI runs these on Python 3.10–3.13; please run them locally first:
+
+```bash
+ruff check .            # lint
+ruff format --check .   # formatting
+mypy                    # type-check (src/)
+pytest                  # unit tests (or ./run-tests.sh for a per-failure summary)
+```
+
+## Guidelines
+
+- **Type-faithfulness matters.** Every result must be bit-for-bit what the
+  selected numeric regime (fixed-width int, IEEE-754 float, fixed-point, decimal,
+  rational) actually produces — never an approximation that "looks right."
+- **`Value` is the single chokepoint for type behavior.** Adding a numeric type
+  is a local, two-step change — add its member to the mode enum, then implement
+  that member's branch in each operation in `value.py`. The rest of the engine is
+  generic over the enum and never branches on type itself; keep it that way.
+- Match the surrounding code style — type hints, no stray `type: ignore`.
+- Update the README when you add or change a tool, mode, operator, or function.
+
+## Reporting bugs
+
+Use the issue templates. Please include your mcp-abacus version, Python version,
+the numeric mode(s) involved, and a minimal expression that reproduces the issue.
+
+## License
+
+By contributing, you agree that your contributions are licensed under the
+project's [GNU General Public License v3.0 or later](LICENSE).