pysolvr-client 0.1.0__tar.gz

pysolvr_client-0.1.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: pysolvr-client
+Version: 0.1.0
+Summary: Shared notebook client library for pysolvr businesses
+License: MIT
+Project-URL: Homepage, https://github.com/dAIvdMercer/pysolvr-client
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+
+# pysolvr-client
+
+Shared notebook client library for [pysolvr](https://pysolvr.com) businesses.
+
+Provides API wrapper, HTML display components, and Google Drive integration for Colab notebooks.
+
+## Install
+
+```
+pip install pysolvr-client
+```
+
+## Usage
+
+```python
+from pysolvr_client import ApiClient, Display, DriveManager
+
+client = ApiClient(base_url, api_key)
+ui = Display('#6366F1', '#10B981')
+drive_mgr = DriveManager('my-business', ['outputs', 'reports'])
+```

pysolvr_client-0.1.0/README.md

@@ -0,0 +1,21 @@
+# pysolvr-client
+
+Shared notebook client library for [pysolvr](https://pysolvr.com) businesses.
+
+Provides API wrapper, HTML display components, and Google Drive integration for Colab notebooks.
+
+## Install
+
+```
+pip install pysolvr-client
+```
+
+## Usage
+
+```python
+from pysolvr_client import ApiClient, Display, DriveManager
+
+client = ApiClient(base_url, api_key)
+ui = Display('#6366F1', '#10B981')
+drive_mgr = DriveManager('my-business', ['outputs', 'reports'])
+```

pysolvr_client-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pysolvr-client"
+version = "0.1.0"
+description = "Shared notebook client library for pysolvr businesses"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+dependencies = ["requests>=2.28"]
+
+[project.urls]
+Homepage = "https://github.com/dAIvdMercer/pysolvr-client"

pysolvr_client-0.1.0/pysolvr_client/__init__.py

@@ -0,0 +1,4 @@
+"""pysolvr_client - Shared notebook client library for all pysolvr businesses."""
+from .api import ApiClient
+from .display import Display
+from .drive import DriveManager

pysolvr_client-0.1.0/pysolvr_client/api.py

@@ -0,0 +1,82 @@
+"""API wrapper with auth, retries, and styled error/result handling."""
+import requests
+import time
+from IPython.display import display, HTML, clear_output
+
+
+class ApiClient:
+    def __init__(self, base_url: str, api_key: str):
+        self.base_url = base_url.rstrip("/")
+        self.headers = {"X-Api-Key": api_key, "Content-Type": "application/json"}
+
+    def call(self, method: str, path: str, payload: dict = None, retries: int = 2) -> dict:
+        """Make an API call with retries. Returns {ok, data, error, status, latency_ms}."""
+        url = f"{self.base_url}/{path.lstrip('/')}"
+        for attempt in range(retries + 1):
+            try:
+                start = time.time()
+                r = requests.request(method, url, headers=self.headers, json=payload, timeout=30)
+                latency_ms = int((time.time() - start) * 1000)
+                if r.status_code in (200, 202):
+                    return {"ok": True, "data": r.json(), "status": r.status_code, "latency_ms": latency_ms}
+                elif r.status_code == 429 and attempt < retries:
+                    time.sleep(2 ** attempt)
+                    continue
+                else:
+                    body = r.json() if r.headers.get("content-type", "").startswith("application/json") else {"message": r.text}
+                    return {"ok": False, "error": body.get("error", body.get("message", "Unknown error")), "status": r.status_code, "latency_ms": latency_ms}
+            except requests.exceptions.Timeout:
+                if attempt < retries:
+                    continue
+                return {"ok": False, "error": "Request timed out. Try again.", "status": 0, "latency_ms": 0}
+            except Exception as e:
+                return {"ok": False, "error": str(e), "status": 0, "latency_ms": 0}
+
+    def run_async(self, endpoint: str, body: dict, timeout: int = 120, poll_interval: int = 2) -> dict:
+        """Submit async job, poll with spinner, return result.
+
+        Returns {ok, data, error, status, latency_ms} — same shape as call().
+        Pre-flight rejections (400/402/403/429) return instantly.
+        """
+        resp = self.call("POST", endpoint, payload=body)
+
+        # Pre-flight rejection — no job created, return error immediately
+        if not resp["ok"]:
+            return resp
+
+        job_id = resp["data"].get("job_id")
+        if not job_id:
+            # Synchronous response (endpoint didn't use async pattern)
+            return resp
+
+        # Poll with spinner
+        start = time.time()
+        display(HTML('<div style="padding:8px;color:#888;">Working...</div>'))
+        while (time.time() - start) < timeout:
+            time.sleep(poll_interval)
+            poll = self.call("GET", f"/jobs/{job_id}")
+
+            if not poll["ok"]:
+                clear_output(wait=True)
+                return poll
+
+            status = poll["data"].get("status")
+            if status == "complete":
+                clear_output(wait=True)
+                elapsed_ms = int((time.time() - start) * 1000)
+                return {"ok": True, "data": poll["data"]["result"], "status": 200, "latency_ms": elapsed_ms}
+            elif status == "failed":
+                clear_output(wait=True)
+                return {"ok": False, "error": poll["data"].get("error", "Job failed"), "status": 500, "latency_ms": 0}
+
+        clear_output(wait=True)
+        return {"ok": False, "error": f"Timeout after {timeout}s (job_id: {job_id})", "status": 0, "latency_ms": 0}
+
+    def health_check(self) -> bool:
+        """Check API connectivity."""
+        result = self.call("GET", "/health")
+        return result["ok"] and result.get("data", {}).get("status") == "ok"
+
+    def get_usage(self) -> dict:
+        """Get usage data."""
+        return self.call("GET", "/usage")

pysolvr_client-0.1.0/pysolvr_client/display.py

@@ -0,0 +1,155 @@
+"""HTML rendering for notebook outputs - cards, tables, tabs, progress, errors."""
+from IPython.display import HTML, display, clear_output
+
+
+class Display:
+    def __init__(self, primary_color: str = "#6366F1", accent_color: str = "#10B981"):
+        self.primary = primary_color
+        self.accent = accent_color
+        self._styles = f"""
+        <style>
+        .pysolvr-card {{ background: #334155; border-radius: 8px; padding: 20px; margin: 8px 0; border: 1px solid #475569; font-family: Inter, system-ui, sans-serif; color: #f1f5f9; }}
+        .pysolvr-card h3 {{ margin: 0 0 12px 0; font-size: 16px; font-weight: 500; }}
+        .pysolvr-header {{ background: linear-gradient(135deg, {primary_color}22, {accent_color}22); border: 1px solid {primary_color}44; border-radius: 12px; padding: 24px; text-align: center; font-family: Inter, system-ui, sans-serif; color: #f1f5f9; }}
+        .pysolvr-header h1 {{ margin: 0; font-size: 28px; font-weight: 300; }}
+        .pysolvr-header p {{ margin: 8px 0 0; color: #94a3b8; font-size: 14px; }}
+        .pysolvr-badge {{ display: inline-block; padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: 500; }}
+        .pysolvr-success {{ background: #10b98122; color: #10b981; }}
+        .pysolvr-warning {{ background: #f59e0b22; color: #f59e0b; }}
+        .pysolvr-error {{ background: #ef444422; color: #ef4444; }}
+        .pysolvr-table {{ width: 100%; border-collapse: collapse; font-size: 13px; }}
+        .pysolvr-table th {{ text-align: left; padding: 8px 12px; border-bottom: 1px solid #475569; color: #94a3b8; font-weight: 500; }}
+        .pysolvr-table td {{ padding: 8px 12px; border-bottom: 1px solid #47556944; }}
+        .pysolvr-bar {{ height: 8px; border-radius: 4px; background: #1e293b; overflow: hidden; }}
+        .pysolvr-bar-fill {{ height: 100%; border-radius: 4px; transition: width 0.3s; }}
+        .pysolvr-tabs {{ display: flex; gap: 0; border-bottom: 1px solid #475569; margin-bottom: 16px; }}
+        .pysolvr-tab {{ padding: 8px 16px; cursor: pointer; color: #94a3b8; font-size: 13px; border-bottom: 2px solid transparent; }}
+        .pysolvr-tab.active {{ color: #f1f5f9; border-bottom-color: {primary_color}; }}
+        .pysolvr-tab-content {{ display: none; }}
+        .pysolvr-tab-content.active {{ display: block; }}
+        .pysolvr-cost {{ display: inline-flex; align-items: center; gap: 4px; font-size: 11px; color: #94a3b8; background: #1e293b; padding: 2px 8px; border-radius: 4px; }}
+        </style>
+        """
+
+    def header(self, name: str, tagline: str, version: str):
+        """Render business branding header."""
+        html = f"""{self._styles}
+        <div class="pysolvr-header">
+            <h1>{name}</h1>
+            <p>{tagline}</p>
+            <p style="margin-top:12px"><span class="pysolvr-badge" style="background:{self.primary}22;color:{self.primary}">v{version}</span></p>
+        </div>"""
+        display(HTML(html))
+
+    def card(self, title: str, content: str, status: str = None, actions: list = None):
+        """Render a styled result card."""
+        status_html = ""
+        if status == "success":
+            status_html = '<span class="pysolvr-badge pysolvr-success">Success</span>'
+        elif status == "warning":
+            status_html = '<span class="pysolvr-badge pysolvr-warning">Warning</span>'
+        elif status == "error":
+            status_html = '<span class="pysolvr-badge pysolvr-error">Error</span>'
+
+        actions_html = ""
+        if actions:
+            actions_html = '<div style="margin-top:12px;display:flex;gap:8px">' + "".join(
+                f'<span style="font-size:12px;color:{self.primary};cursor:pointer">{a}</span>' for a in actions
+            ) + "</div>"
+
+        html = f"""{self._styles}
+        <div class="pysolvr-card">
+            <h3>{title} {status_html}</h3>
+            <div style="font-size:14px;line-height:1.6">{content}</div>
+            {actions_html}
+        </div>"""
+        display(HTML(html))
+
+    def table(self, data: list, columns: list = None):
+        """Render a styled table from list of dicts."""
+        if not data:
+            self.card("No data", "Nothing to display yet.")
+            return
+        if not columns:
+            columns = list(data[0].keys())
+        header = "".join(f"<th>{c}</th>" for c in columns)
+        rows = "".join(
+            "<tr>" + "".join(f"<td>{row.get(c, '')}</td>" for c in columns) + "</tr>"
+            for row in data
+        )
+        html = f"""{self._styles}
+        <div class="pysolvr-card">
+            <table class="pysolvr-table"><thead><tr>{header}</tr></thead><tbody>{rows}</tbody></table>
+        </div>"""
+        display(HTML(html))
+
+    def progress(self, message: str = "Working..."):
+        """Show a progress spinner (call clear_output() then result when done)."""
+        html = f"""{self._styles}
+        <div class="pysolvr-card" style="text-align:center">
+            <div style="display:inline-block;width:20px;height:20px;border:2px solid #475569;border-top-color:{self.primary};border-radius:50%;animation:spin 0.8s linear infinite"></div>
+            <p style="margin:8px 0 0;color:#94a3b8;font-size:13px">{message}</p>
+        </div>
+        <style>@keyframes spin{{from{{transform:rotate(0deg)}}to{{transform:rotate(360deg)}}}}</style>"""
+        display(HTML(html))
+
+    def error(self, message: str, suggestion: str = None):
+        """Render a friendly error card."""
+        suggestion_html = f'<p style="margin-top:8px;font-size:12px;color:#94a3b8">Suggestion: {suggestion}</p>' if suggestion else ""
+        html = f"""{self._styles}
+        <div class="pysolvr-card" style="border-color:#ef444444">
+            <h3><span class="pysolvr-badge pysolvr-error">Error</span></h3>
+            <p style="font-size:14px">{message}</p>
+            {suggestion_html}
+        </div>"""
+        display(HTML(html))
+
+    def success(self, message: str, details: str = None):
+        """Render a success card."""
+        details_html = f'<p style="margin-top:8px;font-size:12px;color:#94a3b8">{details}</p>' if details else ""
+        html = f"""{self._styles}
+        <div class="pysolvr-card" style="border-color:#10b98144">
+            <h3><span class="pysolvr-badge pysolvr-success">Done</span></h3>
+            <p style="font-size:14px">{message}</p>
+            {details_html}
+        </div>"""
+        display(HTML(html))
+
+    def usage_bar(self, spent: float, limit: float, label: str = "Monthly usage"):
+        """Render a usage progress bar."""
+        pct = min((spent / limit) * 100, 100) if limit > 0 else 0
+        color = self.accent if pct < 80 else ("#f59e0b" if pct < 95 else "#ef4444")
+        html = f"""{self._styles}
+        <div class="pysolvr-card">
+            <h3>{label}</h3>
+            <div style="display:flex;justify-content:space-between;font-size:12px;color:#94a3b8;margin-bottom:6px">
+                <span>${spent:.2f} used</span><span>${limit:.2f} limit</span>
+            </div>
+            <div class="pysolvr-bar"><div class="pysolvr-bar-fill" style="width:{pct}%;background:{color}"></div></div>
+            <p style="margin-top:6px;font-size:11px;color:#94a3b8">${limit-spent:.2f} remaining ({100-pct:.0f}%)</p>
+        </div>"""
+        display(HTML(html))
+
+    def cost_badge(self, tokens: int, cost_usd: float):
+        """Render an inline cost badge."""
+        html = f'<span class="pysolvr-cost">{tokens:,} tokens | ${cost_usd:.4f}</span>'
+        display(HTML(self._styles + html))
+
+    def tabs(self, tab_dict: dict):
+        """Render tabbed content. tab_dict = {label: html_content}."""
+        import uuid
+        uid = uuid.uuid4().hex[:8]
+        tab_headers = ""
+        tab_bodies = ""
+        for i, (label, content) in enumerate(tab_dict.items()):
+            active = " active" if i == 0 else ""
+            tab_headers += f'<div class="pysolvr-tab{active}" onclick="document.querySelectorAll(\\'.pysolvr-tab-{uid}\\').forEach(e=>e.classList.remove(\\'active\\'));document.querySelectorAll(\\'.pysolvr-tc-{uid}\\').forEach(e=>e.classList.remove(\\'active\\'));this.classList.add(\\'active\\');document.getElementById(\\'tc-{uid}-{i}\\').classList.add(\\'active\\')">{label}</div>'
+            tab_bodies += f'<div id="tc-{uid}-{i}" class="pysolvr-tc-{uid} pysolvr-tab-content{active}">{content}</div>'
+        # Fix class on tabs for JS targeting
+        tab_headers = tab_headers.replace('class="pysolvr-tab', f'class="pysolvr-tab pysolvr-tab-{uid}')
+        html = f"""{self._styles}
+        <div class="pysolvr-card">
+            <div class="pysolvr-tabs">{tab_headers}</div>
+            {tab_bodies}
+        </div>"""
+        display(HTML(html))

pysolvr_client-0.1.0/pysolvr_client/drive.py

@@ -0,0 +1,69 @@
+"""GDrive operations + .meta.json provenance tracking."""
+import json
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+
+
+DRIVE_ROOT = "/content/drive/My Drive"
+
+
+class DriveManager:
+    def __init__(self, slug: str, folders: list = None):
+        self.slug = slug
+        self.root = Path(DRIVE_ROOT) / "pysolvr" / slug
+        self.folders = folders or []
+
+    def ensure_folders(self):
+        """Create the pysolvr/{slug}/{folders} structure in GDrive."""
+        self.root.mkdir(parents=True, exist_ok=True)
+        for folder in self.folders:
+            (self.root / folder).mkdir(parents=True, exist_ok=True)
+        return str(self.root)
+
+    def save(self, folder: str, filename: str, content: str, meta: dict = None) -> str:
+        """Save a file + .meta.json companion. Returns the file path."""
+        path = self.root / folder / filename
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(content, encoding="utf-8")
+
+        if meta:
+            meta_path = path.with_suffix(path.suffix + ".meta.json")
+            meta["timestamp"] = datetime.now(tz=timezone.utc).isoformat()
+            meta["business_slug"] = self.slug
+            meta_path.write_text(json.dumps(meta, indent=2, default=str), encoding="utf-8")
+
+        return str(path)
+
+    def load(self, folder: str, filename: str) -> tuple:
+        """Load a file + its .meta.json. Returns (content, meta_dict)."""
+        path = self.root / folder / filename
+        if not path.exists():
+            return None, None
+        content = path.read_text(encoding="utf-8")
+        meta_path = path.with_suffix(path.suffix + ".meta.json")
+        meta = json.loads(meta_path.read_text(encoding="utf-8")) if meta_path.exists() else {}
+        return content, meta
+
+    def list_files(self, folder: str) -> list:
+        """List files in a folder with metadata summaries."""
+        folder_path = self.root / folder
+        if not folder_path.exists():
+            return []
+        results = []
+        for f in sorted(folder_path.iterdir()):
+            if f.is_file() and not f.name.endswith(".meta.json"):
+                meta_path = f.with_suffix(f.suffix + ".meta.json")
+                meta = json.loads(meta_path.read_text(encoding="utf-8")) if meta_path.exists() else {}
+                results.append({
+                    "name": f.name,
+                    "path": str(f),
+                    "modified": datetime.fromtimestamp(f.stat().st_mtime).isoformat(),
+                    "meta": meta,
+                })
+        return results
+
+    def get_history(self, folder: str) -> list:
+        """Get provenance history from .meta.json files (for resumability)."""
+        files = self.list_files(folder)
+        return [{"file": f["name"], **f["meta"]} for f in files if f["meta"]]

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

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: pysolvr-client
+Version: 0.1.0
+Summary: Shared notebook client library for pysolvr businesses
+License: MIT
+Project-URL: Homepage, https://github.com/dAIvdMercer/pysolvr-client
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+
+# pysolvr-client
+
+Shared notebook client library for [pysolvr](https://pysolvr.com) businesses.
+
+Provides API wrapper, HTML display components, and Google Drive integration for Colab notebooks.
+
+## Install
+
+```
+pip install pysolvr-client
+```
+
+## Usage
+
+```python
+from pysolvr_client import ApiClient, Display, DriveManager
+
+client = ApiClient(base_url, api_key)
+ui = Display('#6366F1', '#10B981')
+drive_mgr = DriveManager('my-business', ['outputs', 'reports'])
+```

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

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+pysolvr_client/__init__.py
+pysolvr_client/api.py
+pysolvr_client/display.py
+pysolvr_client/drive.py
+pysolvr_client.egg-info/PKG-INFO
+pysolvr_client.egg-info/SOURCES.txt
+pysolvr_client.egg-info/dependency_links.txt
+pysolvr_client.egg-info/requires.txt
+pysolvr_client.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+pysolvr_client

pysolvr_client-0.1.0/setup.cfg

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