extendvcc-cli 0.1.0__py3-none-any.whl

extendvcc/__init__.py

@@ -0,0 +1,46 @@
+"""extendvcc — unofficial Extend virtual card client."""
+
+from extendvcc.cards import (
+    activate_credit_card,
+    cancel_card,
+    close_card,
+    create_card,
+    create_cards_bulk,
+    enroll_credit_card,
+    get_card,
+    list_cards,
+    list_credit_cards,
+    list_issuers,
+    reconcile,
+    reveal_card,
+    update_card,
+    usage,
+)
+from extendvcc.models import CardStatus, CreditCard, Issuer, Recurrence, VirtualCard
+
+__all__ = [
+    # models
+    "CardStatus",
+    "CreditCard",
+    "Issuer",
+    "Recurrence",
+    "VirtualCard",
+    # reads
+    "get_card",
+    "list_cards",
+    "list_credit_cards",
+    "list_issuers",
+    "usage",
+    # mutations
+    "cancel_card",
+    "close_card",
+    "create_card",
+    "create_cards_bulk",
+    "reconcile",
+    "update_card",
+    # reveal
+    "reveal_card",
+    # enroll
+    "activate_credit_card",
+    "enroll_credit_card",
+]

extendvcc/_exit_codes.py

@@ -0,0 +1,24 @@
+"""Stable process exit codes for the extendvcc CLI.
+
+These integers are part of the CLI's contract: scripts and CI pipelines can
+branch on them. Map exceptions to codes in ``cli.main`` — do not invent new
+codes ad hoc.
+
+| Code | Name               | Meaning                                              |
+|------|--------------------|------------------------------------------------------|
+| 0    | EXIT_OK            | Success.                                             |
+| 1    | EXIT_ERROR         | Generic failure (library error, aborted confirm).   |
+| 2    | EXIT_USAGE         | CLI input/usage error (bad flags, validation).      |
+| 3    | EXIT_AUTH_REQUIRED | Authentication needed or failed (login/OTP/session).|
+| 4    | EXIT_DISABLED      | Kill switch / account-risk: automation disabled.    |
+| 5    | EXIT_API_ERROR     | Extend API returned an error response.              |
+"""
+
+from __future__ import annotations
+
+EXIT_OK = 0
+EXIT_ERROR = 1
+EXIT_USAGE = 2
+EXIT_AUTH_REQUIRED = 3
+EXIT_DISABLED = 4
+EXIT_API_ERROR = 5

extendvcc/_jsonl.py

@@ -0,0 +1,35 @@
+"""Vendored JSONL append helper."""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+
+def append_jsonl(path: Path, rows: list[dict], *, fsync: bool = False) -> None:
+    if not rows:
+        return
+    path.parent.mkdir(parents=True, exist_ok=True)
+    # Create the file owner-only (0600) regardless of umask. The ledger stores
+    # card ids/names/last4 — no PAN/CVC — but on shared machines a world-readable
+    # first write would still leak that local audit trail. Existing files are
+    # opened append-only and never have their mode altered.
+    is_new = not path.exists()
+    fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_APPEND, 0o600)
+    try:
+        if is_new:
+            # O_CREAT's mode is masked by umask; force 0600 so umask cannot widen it.
+            os.chmod(path, 0o600)
+        f = os.fdopen(fd, "a", encoding="utf-8")
+    except BaseException:
+        # os.fdopen/os.chmod failing leaves the raw fd open — close it before raising.
+        os.close(fd)
+        raise
+    with f:
+        for row in rows:
+            f.write(json.dumps(row, sort_keys=True, ensure_ascii=False))
+            f.write("\n")
+        if fsync:
+            f.flush()
+            os.fsync(f.fileno())

extendvcc/_paths.py

@@ -0,0 +1,28 @@
+"""Lazy path resolution with CLI override, env var, and default fallback."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+_state_dir_override = None
+_ledger_path_override = None
+
+
+def configure(*, state_dir=None, ledger_path=None):
+    global _state_dir_override, _ledger_path_override
+    _state_dir_override = Path(state_dir) if state_dir else None
+    _ledger_path_override = Path(ledger_path) if ledger_path else None
+
+
+def state_dir() -> Path:
+    return _state_dir_override or Path(os.environ.get("EXTENDVCC_STATE_DIR") or (Path.home() / ".config" / "extendvcc"))
+
+
+def ledger_path() -> Path:
+    if _ledger_path_override:
+        return _ledger_path_override
+    env = os.environ.get("EXTENDVCC_LEDGER_PATH")
+    if env:
+        return Path(env)
+    return Path.home() / ".local" / "share" / "extendvcc" / "cards.jsonl"