bad-decisions-client 1.0.1__tar.gz

bad_decisions_client-1.0.1/.gitignore

@@ -0,0 +1,28 @@
+# Python environments and caches
+.venv/
+.pypi-venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+
+# Build and package artifacts
+dist/
+build/
+*.egg-info/
+client/dist/
+client/build/
+client/*.egg-info/
+exports/
+
+# Local configuration and secrets
+.env
+.env.*
+*.env
+!.env.example
+*.pem
+*.key
+
+# Editor and operating-system metadata
+.DS_Store
+.vscode/
+.idea/

bad_decisions_client-1.0.1/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: bad-decisions-client
+Version: 1.0.1
+Summary: Cross-platform terminal client for Bad Decisions services
+Project-URL: Homepage, https://github.com/BytesAndCoffee/cards-against-coffee
+Project-URL: Documentation, https://github.com/BytesAndCoffee/cards-against-coffee#readme
+Author: Bad Decisions contributors
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Bad Decisions terminal client
+
+`bad-decisions-client` is a dependency-free terminal client for a Bad
+Decisions service. It contains no card corpus and runs on Linux, macOS, and
+Windows.
+
+```bash
+python -m pip install bad-decisions-client
+regret health
+regret deal
+regret deal --packs base,maha
+regret --list-packs
+```
+
+The default endpoint is `https://bytes.coffee/bad-decisions`. Use `--api-url`
+for another compatible deployment. Connection and API failures return a
+non-zero exit status.
+
+## Release
+
+Build and validate before uploading a new immutable PyPI version:
+
+```bash
+cd client
+python -m build
+twine check dist/*
+```

bad_decisions_client-1.0.1/README.md

@@ -0,0 +1,27 @@
+# Bad Decisions terminal client
+
+`bad-decisions-client` is a dependency-free terminal client for a Bad
+Decisions service. It contains no card corpus and runs on Linux, macOS, and
+Windows.
+
+```bash
+python -m pip install bad-decisions-client
+regret health
+regret deal
+regret deal --packs base,maha
+regret --list-packs
+```
+
+The default endpoint is `https://bytes.coffee/bad-decisions`. Use `--api-url`
+for another compatible deployment. Connection and API failures return a
+non-zero exit status.
+
+## Release
+
+Build and validate before uploading a new immutable PyPI version:
+
+```bash
+cd client
+python -m build
+twine check dist/*
+```

bad_decisions_client-1.0.1/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling==1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bad-decisions-client"
+version = "1.0.1"
+description = "Cross-platform terminal client for Bad Decisions services"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Bad Decisions contributors" }]
+classifiers = ["Development Status :: 3 - Alpha", "Environment :: Console", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only"]
+
+[project.scripts]
+regret = "bad_decisions_client.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/BytesAndCoffee/cards-against-coffee"
+Documentation = "https://github.com/BytesAndCoffee/cards-against-coffee#readme"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/bad_decisions_client"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]

bad_decisions_client-1.0.1/src/bad_decisions_client/__init__.py

@@ -0,0 +1,3 @@
+"""Dependency-free, cross-platform client for Bad Decisions services."""
+
+__version__ = "1.0.1"

bad_decisions_client-1.0.1/src/bad_decisions_client/cli.py

@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from typing import Any, Sequence
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+from . import __version__
+
+DEFAULT_API_URL = "https://bytes.coffee/bad-decisions"
+
+
+def parser() -> argparse.ArgumentParser:
+    result = argparse.ArgumentParser(description="Deal a hand from a Bad Decisions service.")
+    result.add_argument("--api-url", default=DEFAULT_API_URL, help="API base URL (default: %(default)s)")
+    result.add_argument("--packs", help="comma-separated packs for both colors")
+    result.add_argument("--black-packs", help="comma-separated black-card packs")
+    result.add_argument("--white-packs", help="comma-separated white-card packs")
+    result.add_argument("--list-packs", action="store_true", help="list API pack metadata")
+    result.add_argument("--health", action="store_true", help="check API health")
+    result.add_argument("--json", action="store_true", help="print the complete JSON response")
+    result.add_argument("--timeout", type=float, default=10.0, help="request timeout in seconds (default: %(default)s)")
+    return result
+
+
+def _base_url(value: str) -> str:
+    url = value.strip().rstrip("/")
+    if not url.startswith(("http://", "https://")):
+        raise ValueError("--api-url must start with http:// or https://")
+    return url
+
+
+def _get_json(url: str, *, timeout: float) -> Any:
+    request = Request(url, headers={"Accept": "application/json", "User-Agent": f"bad-decisions-client/{__version__}"})
+    try:
+        with urlopen(request, timeout=timeout) as response:
+            return json.loads(response.read().decode("utf-8"))
+    except HTTPError as exc:
+        try:
+            payload = json.loads(exc.read().decode("utf-8"))
+            error = payload.get("error", {})
+            message = error.get("message", f"HTTP {exc.code}")
+            code = error.get("code")
+            raise RuntimeError(f"{code}: {message}" if code else message) from exc
+        except (UnicodeDecodeError, json.JSONDecodeError):
+            raise RuntimeError(f"HTTP {exc.code}: {exc.reason}") from exc
+    except (URLError, TimeoutError) as exc:
+        raise RuntimeError(f"Cannot reach API: {exc.reason if isinstance(exc, URLError) else exc}") from exc
+
+
+def _print_packs(packs: list[dict[str, Any]]) -> None:
+    for pack in packs:
+        counts = pack.get("counts", {})
+        print(f"{pack['id']}\t{pack['name']}\tblack={counts.get('black', 0)}\twhite={counts.get('white', 0)}")
+
+
+def run(argv: Sequence[str] | None = None) -> int:
+    values = list(sys.argv[1:] if argv is None else argv)
+    if values and values[0] == "health":
+        values[0] = "--health"
+    elif values and values[0] == "deal":
+        values.pop(0)
+    args = parser().parse_args(values)
+    if args.timeout <= 0:
+        parser().error("--timeout must be greater than zero")
+    if args.list_packs and args.health:
+        parser().error("--list-packs and --health cannot be combined")
+    try:
+        base = _base_url(args.api_url)
+        if args.health:
+            payload = _get_json(f"{base}/healthz", timeout=args.timeout)
+            print(json.dumps(payload, ensure_ascii=False, indent=2) if args.json else payload["status"])
+            return 0
+        if args.list_packs:
+            payload = _get_json(f"{base}/v1/packs", timeout=args.timeout)
+            if args.json:
+                print(json.dumps(payload, ensure_ascii=False, indent=2))
+            else:
+                _print_packs(payload)
+            return 0
+        params = {key: value for key, value in {"packs": args.packs, "black_packs": args.black_packs, "white_packs": args.white_packs}.items() if value is not None}
+        query = f"?{urlencode(params)}" if params else ""
+        payload = _get_json(f"{base}/v1/round{query}", timeout=args.timeout)
+        print(json.dumps(payload, ensure_ascii=False, indent=2) if args.json else payload["result"])
+        return 0
+    except (RuntimeError, ValueError, KeyError) as exc:
+        print(f"regret: {exc}", file=sys.stderr)
+        return 1
+
+
+def main() -> int:
+    return run()
+
+
+def legacy_main() -> int:
+    return run()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

bad_decisions_client-1.0.1/tests/test_cli.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+from unittest.mock import patch
+
+from bad_decisions_client import cli
+
+
+class Response:
+    def __init__(self, payload: str):
+        self.payload = payload
+
+    def read(self) -> bytes:
+        return self.payload.encode("utf-8")
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_args):
+        return False
+
+
+def test_round_prints_only_result(capsys):
+    with patch("bad_decisions_client.cli.urlopen", return_value=Response('{"result":"A completed round"}')) as request:
+        assert cli.run(["--packs", "maha"]) == 0
+    assert capsys.readouterr().out == "A completed round\n"
+    assert request.call_args.args[0].full_url.endswith("/v1/round?packs=maha")
+
+
+def test_list_packs(capsys):
+    payload = '[{"id":"maha","name":"MAHA Pack","counts":{"black":27,"white":52}}]'
+    with patch("bad_decisions_client.cli.urlopen", return_value=Response(payload)):
+        assert cli.run(["--list-packs"]) == 0
+    assert capsys.readouterr().out == "maha\tMAHA Pack\tblack=27\twhite=52\n"
+
+
+def test_json_and_validation(capsys):
+    with patch("bad_decisions_client.cli.urlopen", return_value=Response('{"status":"ok"}')):
+        assert cli.run(["--health", "--json"]) == 0
+    assert '"status": "ok"' in capsys.readouterr().out
+    assert cli.run(["--api-url", "ftp://bad"]) == 1
+    assert "must start" in capsys.readouterr().err