shieldauth-key 0.1.0__tar.gz

shieldauth_key-0.1.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: shieldauth-key
+Version: 0.1.0
+Summary: License key protection for Python apps — one line of code
+License: MIT
+Project-URL: Homepage, https://shieldauth.pages.dev
+Project-URL: Source, https://github.com/shieldauth/shieldauth-python
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+
+# shieldauth
+
+License key protection for Python apps — one line of code.
+
+## Install
+
+```bash
+pip install shieldauth
+```
+
+## Usage
+
+```python
+import shieldauth
+shieldauth.verify("sk_live_xxxx")
+
+# Your app code here — only runs if license is valid
+print("Welcome!")
+```
+
+On first run, the user is prompted for their license key. It's saved locally so they're never asked again.
+
+## Links
+
+- Dashboard: https://shieldauth.pages.dev
+- Docs: https://shieldauth.pages.dev/docs

shieldauth_key-0.1.0/README.md

@@ -0,0 +1,26 @@
+# shieldauth
+
+License key protection for Python apps — one line of code.
+
+## Install
+
+```bash
+pip install shieldauth
+```
+
+## Usage
+
+```python
+import shieldauth
+shieldauth.verify("sk_live_xxxx")
+
+# Your app code here — only runs if license is valid
+print("Welcome!")
+```
+
+On first run, the user is prompted for their license key. It's saved locally so they're never asked again.
+
+## Links
+
+- Dashboard: https://shieldauth.pages.dev
+- Docs: https://shieldauth.pages.dev/docs

shieldauth_key-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "shieldauth-key"
+version = "0.1.0"
+description = "License key protection for Python apps — one line of code"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+dependencies = ["requests>=2.28"]
+
+[project.urls]
+Homepage = "https://shieldauth.pages.dev"
+Source = "https://github.com/shieldauth/shieldauth-python"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["shieldauth*"]

shieldauth_key-0.1.0/setup.cfg

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

shieldauth_key-0.1.0/shieldauth/__init__.py

@@ -0,0 +1,4 @@
+from ._verify import verify
+
+__all__ = ["verify"]
+__version__ = "0.1.0"

shieldauth_key-0.1.0/shieldauth/_hwid.py

@@ -0,0 +1,8 @@
+import hashlib
+import socket
+import uuid
+
+
+def get() -> str:
+    raw = f"{uuid.getnode()}:{socket.gethostname()}"
+    return hashlib.sha256(raw.encode()).hexdigest()[:32]

shieldauth_key-0.1.0/shieldauth/_prompt.py

@@ -0,0 +1,37 @@
+def ask_for_key(app_name: str) -> str:
+    """Prompt the user for a license key.
+    Uses a tkinter GUI dialog if available (works inside compiled EXEs),
+    falls back to terminal input.
+    """
+    try:
+        import tkinter as tk
+        from tkinter import simpledialog
+
+        root = tk.Tk()
+        root.withdraw()
+        root.lift()
+        root.attributes("-topmost", True)
+
+        key = simpledialog.askstring(
+            title=f"{app_name} — License",
+            prompt=f"Enter your {app_name} license key:",
+            parent=root,
+        )
+        root.destroy()
+
+        if key is None:
+            # User closed the dialog
+            print("License key required. Exiting.")
+            raise SystemExit(1)
+
+        return key.strip()
+
+    except ImportError:
+        # tkinter not available — use terminal
+        pass
+
+    key = input(f"Enter your {app_name} license key: ").strip()
+    if not key:
+        print("License key required. Exiting.")
+        raise SystemExit(1)
+    return key

shieldauth_key-0.1.0/shieldauth/_store.py

@@ -0,0 +1,42 @@
+import json
+import os
+from pathlib import Path
+from typing import Optional
+
+
+def _path() -> Path:
+    return Path.home() / ".shieldauth" / "keys.json"
+
+
+def load(app_secret: str) -> Optional[dict]:
+    p = _path()
+    if not p.exists():
+        return None
+    try:
+        data = json.loads(p.read_text())
+        return data.get(app_secret)
+    except Exception:
+        return None
+
+
+def save(app_secret: str, entry: dict) -> None:
+    p = _path()
+    p.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        data = json.loads(p.read_text()) if p.exists() else {}
+    except Exception:
+        data = {}
+    data[app_secret] = entry
+    p.write_text(json.dumps(data, indent=2))
+
+
+def clear(app_secret: str) -> None:
+    p = _path()
+    if not p.exists():
+        return
+    try:
+        data = json.loads(p.read_text())
+        data.pop(app_secret, None)
+        p.write_text(json.dumps(data, indent=2))
+    except Exception:
+        pass

shieldauth_key-0.1.0/shieldauth/_verify.py

@@ -0,0 +1,123 @@
+from datetime import datetime, timezone, timedelta
+from typing import Optional
+
+import requests
+
+from . import _hwid, _store, _prompt
+
+API_BASE = "https://shieldauth.pages.dev/api/v1"
+OFFLINE_GRACE_DAYS = 7
+
+
+def _post(endpoint: str, payload: dict, timeout: int = 8) -> Optional[dict]:
+    try:
+        r = requests.post(f"{API_BASE}/{endpoint}", json=payload, timeout=timeout)
+        return r.json()
+    except Exception:
+        return None
+
+
+def verify(app_secret: str) -> None:
+    hwid = _hwid.get()
+    stored = _store.load(app_secret)
+
+    # ── Case 1: No saved key — need to prompt ────────────────────────────────
+    if not stored:
+        # Fetch app_name first (key=None)
+        res = _post("validate", {"app_secret": app_secret, "hwid": hwid})
+        if res is None:
+            print("Unable to reach ShieldAuth servers and no cached key found. Exiting.")
+            raise SystemExit(1)
+
+        app_name = res.get("app_name", "ShieldAuth")
+
+        if "error" in res and res["error"] == "invalid_app_secret":
+            # Developer misconfigured — show a generic error
+            print("Invalid application configuration. Exiting.")
+            raise SystemExit(1)
+
+        key = _prompt.ask_for_key(app_name)
+        _activate(app_secret, key, hwid, app_name)
+        return
+
+    # ── Case 2: Saved key — validate silently ────────────────────────────────
+    key = stored["key"]
+    app_name = stored.get("app_name", "ShieldAuth")
+
+    res = _post("validate", {"app_secret": app_secret, "key": key, "hwid": hwid})
+
+    if res is None:
+        # Network error — allow offline grace period
+        last_seen_str = stored.get("last_seen")
+        if last_seen_str:
+            last_seen = datetime.fromisoformat(last_seen_str)
+            if datetime.now(timezone.utc) - last_seen < timedelta(days=OFFLINE_GRACE_DAYS):
+                return  # within grace period, allow through
+        print("Unable to verify license. Check your internet connection. Exiting.")
+        raise SystemExit(1)
+
+    if res.get("valid"):
+        # Update last_seen in local store
+        _store.save(app_secret, {
+            **stored,
+            "last_seen": datetime.now(timezone.utc).isoformat(),
+        })
+        return
+
+    error = res.get("error", "")
+
+    if error == "hwid_mismatch":
+        print(
+            f"\n[{app_name}] This license key is registered to a different device.\n"
+            "To transfer it, visit: https://shieldauth.pages.dev/reset\n"
+        )
+        raise SystemExit(1)
+
+    if error in ("paused", "banned"):
+        print(f"\n[{app_name}] Your license has been {error}. Contact support.")
+        raise SystemExit(1)
+
+    if error == "expired":
+        print(f"\n[{app_name}] Your license has expired. Please renew.")
+        raise SystemExit(1)
+
+    # Key no longer valid — clear cache and re-prompt
+    _store.clear(app_secret)
+    print(f"\n[{app_name}] License key is no longer valid.")
+    key = _prompt.ask_for_key(app_name)
+    _activate(app_secret, key, hwid, app_name)
+
+
+def _activate(app_secret: str, key: str, hwid: str, app_name: str) -> None:
+    res = _post("validate", {"app_secret": app_secret, "key": key, "hwid": hwid})
+
+    if res is None:
+        print("Unable to reach ShieldAuth servers. Exiting.")
+        raise SystemExit(1)
+
+    if res.get("valid"):
+        _store.save(app_secret, {
+            "key": key,
+            "app_name": res.get("app_name", app_name),
+            "last_seen": datetime.now(timezone.utc).isoformat(),
+        })
+        return
+
+    error = res.get("error", "")
+    app_name = res.get("app_name", app_name)
+
+    if error == "hwid_mismatch":
+        print(
+            f"\n[{app_name}] This key is already activated on another device.\n"
+            "Visit https://shieldauth.pages.dev/reset to transfer it.\n"
+        )
+    elif error == "key_not_found":
+        print(f"\n[{app_name}] Invalid license key. Please check and try again.")
+    elif error in ("paused", "banned"):
+        print(f"\n[{app_name}] This license key has been {error}.")
+    elif error == "expired":
+        print(f"\n[{app_name}] This license key has expired.")
+    else:
+        print(f"\n[{app_name}] License verification failed: {error}")
+
+    raise SystemExit(1)

shieldauth_key-0.1.0/shieldauth_key.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: shieldauth-key
+Version: 0.1.0
+Summary: License key protection for Python apps — one line of code
+License: MIT
+Project-URL: Homepage, https://shieldauth.pages.dev
+Project-URL: Source, https://github.com/shieldauth/shieldauth-python
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+
+# shieldauth
+
+License key protection for Python apps — one line of code.
+
+## Install
+
+```bash
+pip install shieldauth
+```
+
+## Usage
+
+```python
+import shieldauth
+shieldauth.verify("sk_live_xxxx")
+
+# Your app code here — only runs if license is valid
+print("Welcome!")
+```
+
+On first run, the user is prompted for their license key. It's saved locally so they're never asked again.
+
+## Links
+
+- Dashboard: https://shieldauth.pages.dev
+- Docs: https://shieldauth.pages.dev/docs

shieldauth_key-0.1.0/shieldauth_key.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+shieldauth/__init__.py
+shieldauth/_hwid.py
+shieldauth/_prompt.py
+shieldauth/_store.py
+shieldauth/_verify.py
+shieldauth_key.egg-info/PKG-INFO
+shieldauth_key.egg-info/SOURCES.txt
+shieldauth_key.egg-info/dependency_links.txt
+shieldauth_key.egg-info/requires.txt
+shieldauth_key.egg-info/top_level.txt

shieldauth_key-0.1.0/shieldauth_key.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

shieldauth_key-0.1.0/shieldauth_key.egg-info/requires.txt

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

shieldauth_key-0.1.0/shieldauth_key.egg-info/top_level.txt

@@ -0,0 +1 @@
+shieldauth