signbuddy 1.0.0__tar.gz

signbuddy-1.0.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: signbuddy
+Version: 1.0.0
+Summary: CLI for verifying SignBuddy-signed PDF documents
+Author: SignBuddy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# SignBuddy CLI
+
+Verify whether a PDF was signed and recorded through [SignBuddy](https://signbuddy.eu).
+
+## Install
+
+```bash
+pip install signbuddy
+```
+
+Or from local source:
+
+```bash
+git clone <your-repo-url>
+cd signbuddy
+pip install .
+```
+
+## Usage
+
+No setup required — the CLI talks to the SignBuddy API out of the box.
+
+```bash
+signbuddy --verify AGR-1234567890 /path/to/document.pdf
+```
+
+The contract number is printed on the signed document (format `AGR-` followed by 10 digits).
+
+### Exit codes
+
+| Code | Meaning                                  |
+| ---- | ---------------------------------------- |
+| `0`  | Document verified                        |
+| `1`  | Document not verified                    |
+| `2`  | Invalid input (file missing / not a PDF) |
+| `3`  | Could not reach the API / API error      |
+
+## Options
+
+| Option               | Description                          |
+| -------------------- | ------------------------------------ |
+| `--timeout <secs>`   | HTTP timeout in seconds (default 30) |
+| `--version`          | Print the CLI version                |
+| `-h`, `--help`       | Show help                            |

signbuddy-1.0.0/README.md

@@ -0,0 +1,44 @@
+# SignBuddy CLI
+
+Verify whether a PDF was signed and recorded through [SignBuddy](https://signbuddy.eu).
+
+## Install
+
+```bash
+pip install signbuddy
+```
+
+Or from local source:
+
+```bash
+git clone <your-repo-url>
+cd signbuddy
+pip install .
+```
+
+## Usage
+
+No setup required — the CLI talks to the SignBuddy API out of the box.
+
+```bash
+signbuddy --verify AGR-1234567890 /path/to/document.pdf
+```
+
+The contract number is printed on the signed document (format `AGR-` followed by 10 digits).
+
+### Exit codes
+
+| Code | Meaning                                  |
+| ---- | ---------------------------------------- |
+| `0`  | Document verified                        |
+| `1`  | Document not verified                    |
+| `2`  | Invalid input (file missing / not a PDF) |
+| `3`  | Could not reach the API / API error      |
+
+## Options
+
+| Option               | Description                          |
+| -------------------- | ------------------------------------ |
+| `--timeout <secs>`   | HTTP timeout in seconds (default 30) |
+| `--version`          | Print the CLI version                |
+| `-h`, `--help`       | Show help                            |

signbuddy-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "signbuddy"
+version = "1.0.0"
+description = "CLI for verifying SignBuddy-signed PDF documents"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+  { name = "SignBuddy" }
+]
+dependencies = [
+  "requests>=2.31.0",
+]
+
+[project.scripts]
+signbuddy = "signbuddy.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

signbuddy-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

signbuddy-1.0.0/src/signbuddy/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "1.0.0"

signbuddy-1.0.0/src/signbuddy/__main__.py

@@ -0,0 +1,5 @@
+from signbuddy.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

signbuddy-1.0.0/src/signbuddy/cli.py

@@ -0,0 +1,138 @@
+import argparse
+import json
+from pathlib import Path
+
+import requests
+
+from signbuddy import __version__
+
+API_BASE_URL = "https://api.signbuddy.eu"
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="signbuddy",
+        description="Verify whether a PDF was signed and recorded through SignBuddy.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    parser.add_argument(
+        "--timeout",
+        type=float,
+        default=30.0,
+        help="HTTP timeout in seconds. Default: 30",
+    )
+    parser.add_argument(
+        "--verify",
+        nargs=2,
+        metavar=("CONTRACT_NUMBER", "FILEPATH"),
+        help="Verify a PDF by contract number and file path.",
+    )
+    return parser
+
+
+def main() -> int:
+    parser = build_parser()
+    args = parser.parse_args()
+
+    if not args.verify:
+        parser.error("the following argument is required: --verify")
+
+    contract_number, file_path = args.verify
+    pdf_path = Path(file_path).expanduser().resolve()
+
+    if not pdf_path.exists():
+        print(f"Error: file not found: {pdf_path}")
+        return 2
+    if not pdf_path.is_file():
+        print(f"Error: not a file: {pdf_path}")
+        return 2
+    if pdf_path.suffix.lower() != ".pdf":
+        print(f"Error: expected a PDF file, got: {pdf_path.name}")
+        return 2
+
+    verify_url = f"{API_BASE_URL}/api/v1/verify"
+
+    try:
+        with pdf_path.open("rb") as handle:
+            response = requests.post(
+                verify_url,
+                data={"contract_number": contract_number},
+                files={"pdf_file": (pdf_path.name, handle, "application/pdf")},
+                timeout=args.timeout,
+            )
+    except requests.RequestException as exc:
+        print(f"Error: failed to reach SignBuddy API at {verify_url}")
+        print(f"Detail: {exc}")
+        return 3
+
+    try:
+        payload = response.json()
+    except json.JSONDecodeError:
+        print(f"Error: SignBuddy API returned non-JSON response (HTTP {response.status_code})")
+        return 3
+
+    if response.status_code >= 400:
+        print(f"Error: SignBuddy API returned HTTP {response.status_code}")
+        detail = payload.get("detail")
+        if detail:
+            print(f"Detail: {detail}")
+        else:
+            print(json.dumps(payload, indent=2))
+        return 3
+
+    _print_result(payload, pdf_path)
+    return 0 if payload.get("verified") else 1
+
+
+def _print_result(payload: dict, pdf_path: Path) -> None:
+    verified = bool(payload.get("verified"))
+    found = bool(payload.get("found"))
+
+    print(f"File: {pdf_path}")
+    print(f"Contract Number: {payload.get('contract_number') or 'N/A'}")
+    print(f"Verified: {'YES' if verified else 'NO'}")
+    print(f"Found in SignBuddy: {'YES' if found else 'NO'}")
+
+    if payload.get("contract_title"):
+        print(f"Contract Title: {payload['contract_title']}")
+
+    if payload.get("message"):
+        print(f"Message: {payload['message']}")
+
+    if payload.get("hash_mismatch"):
+        print("Hash Mismatch: YES (uploaded file does not match the recorded document)")
+
+    if payload.get("pdf_hash"):
+        print(f"Stored Hash: {payload['pdf_hash']}")
+    if payload.get("searched_hash"):
+        print(f"Uploaded Hash: {payload['searched_hash']}")
+    if payload.get("expected_hash"):
+        print(f"Expected Hash: {payload['expected_hash']}")
+
+    if payload.get("rekor_status"):
+        print(f"Rekor: {payload['rekor_status']}")
+    if payload.get("log_index") is not None:
+        print(f"Rekor Log Index: {payload['log_index']}")
+    if payload.get("entry_uuid"):
+        print(f"Rekor Entry UUID: {payload['entry_uuid']}")
+    if payload.get("integrated_time_formatted"):
+        print(f"Rekor Integrated Time: {payload['integrated_time_formatted']}")
+    if payload.get("ots_status"):
+        print(f"OpenTimestamps: {payload['ots_status']}")
+    if payload.get("bitcoin_block_height") is not None:
+        print(f"Bitcoin Block Height: {payload['bitcoin_block_height']}")
+    if payload.get("bitcoin_confirmed_at"):
+        print(f"Bitcoin Confirmed At: {payload['bitcoin_confirmed_at']}")
+
+    signers = payload.get("signers") or []
+    if signers:
+        print("Signers:")
+        for signer in signers:
+            name = signer.get("name") or "Unknown"
+            email = signer.get("email") or "N/A"
+            signed_at = signer.get("signed_at") or "N/A"
+            print(f"  - {name} <{email}> signed_at={signed_at}")

signbuddy-1.0.0/src/signbuddy.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: signbuddy
+Version: 1.0.0
+Summary: CLI for verifying SignBuddy-signed PDF documents
+Author: SignBuddy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# SignBuddy CLI
+
+Verify whether a PDF was signed and recorded through [SignBuddy](https://signbuddy.eu).
+
+## Install
+
+```bash
+pip install signbuddy
+```
+
+Or from local source:
+
+```bash
+git clone <your-repo-url>
+cd signbuddy
+pip install .
+```
+
+## Usage
+
+No setup required — the CLI talks to the SignBuddy API out of the box.
+
+```bash
+signbuddy --verify AGR-1234567890 /path/to/document.pdf
+```
+
+The contract number is printed on the signed document (format `AGR-` followed by 10 digits).
+
+### Exit codes
+
+| Code | Meaning                                  |
+| ---- | ---------------------------------------- |
+| `0`  | Document verified                        |
+| `1`  | Document not verified                    |
+| `2`  | Invalid input (file missing / not a PDF) |
+| `3`  | Could not reach the API / API error      |
+
+## Options
+
+| Option               | Description                          |
+| -------------------- | ------------------------------------ |
+| `--timeout <secs>`   | HTTP timeout in seconds (default 30) |
+| `--version`          | Print the CLI version                |
+| `-h`, `--help`       | Show help                            |

signbuddy-1.0.0/src/signbuddy.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/signbuddy/__init__.py
+src/signbuddy/__main__.py
+src/signbuddy/cli.py
+src/signbuddy.egg-info/PKG-INFO
+src/signbuddy.egg-info/SOURCES.txt
+src/signbuddy.egg-info/dependency_links.txt
+src/signbuddy.egg-info/entry_points.txt
+src/signbuddy.egg-info/requires.txt
+src/signbuddy.egg-info/top_level.txt

signbuddy-1.0.0/src/signbuddy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

signbuddy-1.0.0/src/signbuddy.egg-info/entry_points.txt

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

signbuddy-1.0.0/src/signbuddy.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.31.0

signbuddy-1.0.0/src/signbuddy.egg-info/top_level.txt

@@ -0,0 +1 @@
+signbuddy