vclient 0.2.0__tar.gz

vclient-0.2.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: vclient
+Version: 0.2.0
+Summary: Auto-discover API schemas and generate type-safe clients in 6 languages
+Home-page: https://github.com/yc-trails/dynamic-api-adapter
+Author: Dynamic API Adapter
+Author-email: Dynamic API Adapter <dev@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yc-trails/dynamic-api-adapter
+Project-URL: Repository, https://github.com/yc-trails/dynamic-api-adapter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: aiohttp>=3.9.5
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: click>=8.1.7
+Requires-Dist: jinja2>=3.1.2
+Requires-Dist: jsonschema>=4.21.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.4; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pyinstaller>=6.0.0; extra == "dev"
+Requires-Dist: wheel>=0.42.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# vclient — Auto-Generate API Clients
+
+Auto-discover OpenAPI endpoints and generate **type-safe client libraries in 6 languages** instantly.
+
+## Features
+
+✨ **Single Command:** 
+```bash
+vclient infer https://api.example.com
+```
+
+Generates:
+- 🐍 **Python** (httpx + Pydantic models)
+- 📘 **TypeScript** (Fetch API + Zod validation)
+- 🐹 **Go** (net/http)
+- 🦀 **Rust** (reqwest + serde)
+- ☕ **Java** (HttpClient)
+- 💎 **Ruby** (Faraday)
+
+## How It Works
+
+1. **Discover** — Probe API endpoints and extract OpenAPI specs
+2. **Infer** — Analyze responses → infer complete JSON schemas
+3. **Cache** — Store schemas, detect drift on next run
+4. **Generate** — Produce idiomatic clients for all 6 languages
+
+## Installation
+
+```bash
+# via PyPI
+pip install vclient
+
+# via Homebrew (after setup)
+brew install yc-trails/vclient/vclient
+```
+
+## Quick Start
+
+```bash
+# Infer schema from live API
+vclient infer https://be.vyonica.com --max-endpoints 25 \
+  --gen-python --gen-typescript --gen-go --gen-rust --gen-java --gen-ruby
+
+# Generates: schema.json + client.py + client.ts + client.go + client.rs + Client.java + client.rb
+```
+
+## Generate from Existing Schema
+
+```bash
+vclient codegen schema.json \
+  --python client.py \
+  --typescript client.ts \
+  --go client.go \
+  --rust client.rs \
+  --java Client.java \
+  --ruby client.rb
+```
+
+## Architecture
+
+```
+vclient/
+├── src/
+│   ├── cli.py           # Command-line interface
+│   ├── sampler.py       # Endpoint discovery + HTTP sampling
+│   ├── inferrer.py      # Schema inference from responses
+│   ├── codegen.py       # 6-language code generation
+│   └── cache.py         # SQLite schema caching + drift detection
+├── tests/               # 55+ unit tests
+├── test-clients/        # Generated examples (153 Vyonica endpoints)
+└── Formula/vclient.rb   # Homebrew formula
+```
+
+## Testing
+
+All generators tested on real-world APIs:
+
+```bash
+# Run test suite
+pytest tests/ -v
+
+# Test with Vyonica API (153 endpoints)
+vclient infer https://be.vyonica.com --no-cache
+```
+
+## What's Next
+
+- [ ] Windows binary (Windows Subsystem for Linux compatible)
+- [ ] Kotlin support (JVM ecosystem)
+- [ ] GraphQL support
+- [ ] API documentation generation
+
+---
+
+**Made for:** AI agents, SaaS integrators, enterprises calling legacy APIs without OpenAPI specs.

vclient-0.2.0/README.md

@@ -0,0 +1,95 @@
+# vclient — Auto-Generate API Clients
+
+Auto-discover OpenAPI endpoints and generate **type-safe client libraries in 6 languages** instantly.
+
+## Features
+
+✨ **Single Command:** 
+```bash
+vclient infer https://api.example.com
+```
+
+Generates:
+- 🐍 **Python** (httpx + Pydantic models)
+- 📘 **TypeScript** (Fetch API + Zod validation)
+- 🐹 **Go** (net/http)
+- 🦀 **Rust** (reqwest + serde)
+- ☕ **Java** (HttpClient)
+- 💎 **Ruby** (Faraday)
+
+## How It Works
+
+1. **Discover** — Probe API endpoints and extract OpenAPI specs
+2. **Infer** — Analyze responses → infer complete JSON schemas
+3. **Cache** — Store schemas, detect drift on next run
+4. **Generate** — Produce idiomatic clients for all 6 languages
+
+## Installation
+
+```bash
+# via PyPI
+pip install vclient
+
+# via Homebrew (after setup)
+brew install yc-trails/vclient/vclient
+```
+
+## Quick Start
+
+```bash
+# Infer schema from live API
+vclient infer https://be.vyonica.com --max-endpoints 25 \
+  --gen-python --gen-typescript --gen-go --gen-rust --gen-java --gen-ruby
+
+# Generates: schema.json + client.py + client.ts + client.go + client.rs + Client.java + client.rb
+```
+
+## Generate from Existing Schema
+
+```bash
+vclient codegen schema.json \
+  --python client.py \
+  --typescript client.ts \
+  --go client.go \
+  --rust client.rs \
+  --java Client.java \
+  --ruby client.rb
+```
+
+## Architecture
+
+```
+vclient/
+├── src/
+│   ├── cli.py           # Command-line interface
+│   ├── sampler.py       # Endpoint discovery + HTTP sampling
+│   ├── inferrer.py      # Schema inference from responses
+│   ├── codegen.py       # 6-language code generation
+│   └── cache.py         # SQLite schema caching + drift detection
+├── tests/               # 55+ unit tests
+├── test-clients/        # Generated examples (153 Vyonica endpoints)
+└── Formula/vclient.rb   # Homebrew formula
+```
+
+## Testing
+
+All generators tested on real-world APIs:
+
+```bash
+# Run test suite
+pytest tests/ -v
+
+# Test with Vyonica API (153 endpoints)
+vclient infer https://be.vyonica.com --no-cache
+```
+
+## What's Next
+
+- [ ] Windows binary (Windows Subsystem for Linux compatible)
+- [ ] Kotlin support (JVM ecosystem)
+- [ ] GraphQL support
+- [ ] API documentation generation
+
+---
+
+**Made for:** AI agents, SaaS integrators, enterprises calling legacy APIs without OpenAPI specs.

vclient-0.2.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=65", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vclient"
+version = "0.2.0"
+description = "Auto-discover API schemas and generate type-safe clients in 6 languages"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    {name = "Dynamic API Adapter", email = "dev@example.com"}
+]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "httpx>=0.27.0",
+    "aiohttp>=3.9.5",
+    "pydantic>=2.7.0",
+    "click>=8.1.7",
+    "jinja2>=3.1.2",
+    "jsonschema>=4.21.1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.4",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+    "pyinstaller>=6.0.0",
+    "wheel>=0.42.0",
+]
+
+[project.scripts]
+vclient = "src.cli:cli"
+
+[project.urls]
+Homepage = "https://github.com/yc-trails/dynamic-api-adapter"
+Repository = "https://github.com/yc-trails/dynamic-api-adapter"
+
+[tool.setuptools]
+packages = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.pyinstaller]
+# PyInstaller configuration
+hidden_imports = ["jinja2"]

vclient-0.2.0/setup.cfg

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

vclient-0.2.0/setup.py

@@ -0,0 +1,48 @@
+"""Setup configuration for Dynamic API Adapter."""
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="vclient",
+    version="0.2.0",
+    description="Auto-discover API schemas and generate type-safe clients in 6 languages",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="Dynamic API Adapter",
+    url="https://github.com/yc-trails/dynamic-api-adapter",
+    packages=find_packages(),
+    python_requires=">=3.10",
+    install_requires=[
+        "httpx>=0.27.0",
+        "aiohttp>=3.9.5",
+        "pydantic>=2.7.0",
+        "click>=8.1.7",
+        "jinja2>=3.1.2",
+        "jsonschema>=4.21.1",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=7.4.4",
+            "pytest-asyncio>=0.23.0",
+            "pytest-cov>=4.1.0",
+            "pyinstaller>=6.0.0",
+            "wheel>=0.42.0",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "vclient=src.cli:cli",
+        ],
+    },
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+)

vclient-0.2.0/src/__init__.py

@@ -0,0 +1,15 @@
+"""Dynamic API Adapter - Auto-discover and adapt to API schemas."""
+
+from .inferrer import SchemaInferrer, infer_property_schema, infer_object_schema
+from .sampler import EndpointSampler
+from .codegen import ClientGenerator
+
+__all__ = [
+    "SchemaInferrer",
+    "EndpointSampler",
+    "ClientGenerator",
+    "infer_property_schema",
+    "infer_object_schema",
+]
+
+__version__ = "0.1.0"

vclient-0.2.0/src/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point for vclient CLI when run as a module or executable."""
+from src.cli import cli
+
+if __name__ == "__main__":
+    cli()

vclient-0.2.0/src/cache.py

@@ -0,0 +1,159 @@
+"""SQLite-based schema caching."""
+import sqlite3
+import json
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+DEFAULT_DB_PATH = Path.home() / ".api-adapter" / "cache.db"
+
+
+class SchemaCache:
+    """Persistent schema cache using SQLite."""
+
+    def __init__(self, db_path: str | Path | None = None) -> None:
+        self.db_path = Path(db_path) if db_path else DEFAULT_DB_PATH
+        self._conn: sqlite3.Connection | None = None
+
+    def __enter__(self) -> "SchemaCache":
+        self.connect()
+        return self
+
+    def __exit__(self, *args) -> None:
+        self.close()
+
+    def connect(self) -> None:
+        """Open connection and initialize schema."""
+        self.db_path.parent.mkdir(parents=True, exist_ok=True)
+        self._conn = sqlite3.connect(str(self.db_path))
+        self._conn.row_factory = sqlite3.Row
+        self._init_schema()
+
+    def close(self) -> None:
+        """Commit and close connection."""
+        if self._conn:
+            self._conn.commit()
+            self._conn.close()
+            self._conn = None
+
+    def _init_schema(self) -> None:
+        """Create tables if they don't exist."""
+        if not self._conn:
+            raise RuntimeError("Not connected to database")
+
+        cursor = self._conn.cursor()
+
+        cursor.execute("""
+            CREATE TABLE IF NOT EXISTS schema_snapshots (
+                id          INTEGER PRIMARY KEY AUTOINCREMENT,
+                base_url    TEXT NOT NULL,
+                captured_at TEXT NOT NULL,
+                schema_json TEXT NOT NULL
+            )
+        """)
+
+        cursor.execute("""
+            CREATE INDEX IF NOT EXISTS idx_snapshots_url
+            ON schema_snapshots(base_url)
+        """)
+
+        cursor.execute("""
+            CREATE TABLE IF NOT EXISTS drift_events (
+                id              INTEGER PRIMARY KEY AUTOINCREMENT,
+                base_url        TEXT NOT NULL,
+                detected_at     TEXT NOT NULL,
+                old_snapshot_id INTEGER NOT NULL REFERENCES schema_snapshots(id),
+                new_snapshot_id INTEGER NOT NULL REFERENCES schema_snapshots(id),
+                similarity      REAL NOT NULL,
+                diff_json       TEXT NOT NULL
+            )
+        """)
+
+        self._conn.commit()
+
+    def save_snapshot(self, base_url: str, schema: Dict[str, Any]) -> int:
+        """Save schema snapshot and return row id."""
+        if not self._conn:
+            raise RuntimeError("Not connected to database")
+
+        cursor = self._conn.cursor()
+        now = datetime.now(timezone.utc).isoformat()
+        schema_json = json.dumps(schema, default=str)
+
+        cursor.execute(
+            "INSERT INTO schema_snapshots (base_url, captured_at, schema_json) VALUES (?, ?, ?)",
+            (base_url, now, schema_json)
+        )
+        self._conn.commit()
+        return cursor.lastrowid
+
+    def latest_snapshot(self, base_url: str) -> Optional[Dict[str, Any]]:
+        """Get most recent snapshot for base_url."""
+        if not self._conn:
+            raise RuntimeError("Not connected to database")
+
+        cursor = self._conn.cursor()
+        cursor.execute(
+            "SELECT schema_json FROM schema_snapshots WHERE base_url=? ORDER BY captured_at DESC LIMIT 1",
+            (base_url,)
+        )
+        row = cursor.fetchone()
+        if row:
+            return json.loads(row[0])
+        return None
+
+    def all_snapshots(self, base_url: str) -> list[Dict[str, Any]]:
+        """Get all snapshots for base_url ordered by captured_at DESC."""
+        if not self._conn:
+            raise RuntimeError("Not connected to database")
+
+        cursor = self._conn.cursor()
+        cursor.execute(
+            "SELECT schema_json FROM schema_snapshots WHERE base_url=? ORDER BY captured_at DESC",
+            (base_url,)
+        )
+        return [json.loads(row[0]) for row in cursor.fetchall()]
+
+    def save_drift_event(
+        self,
+        base_url: str,
+        old_id: int,
+        new_id: int,
+        similarity: float,
+        diff: Dict[str, Any],
+    ) -> int:
+        """Save drift event and return row id."""
+        if not self._conn:
+            raise RuntimeError("Not connected to database")
+
+        cursor = self._conn.cursor()
+        now = datetime.now(timezone.utc).isoformat()
+        diff_json = json.dumps(diff, default=str)
+
+        cursor.execute(
+            "INSERT INTO drift_events (base_url, detected_at, old_snapshot_id, new_snapshot_id, similarity, diff_json) "
+            "VALUES (?, ?, ?, ?, ?, ?)",
+            (base_url, now, old_id, new_id, similarity, diff_json)
+        )
+        self._conn.commit()
+        return cursor.lastrowid
+
+    def drift_history(self, base_url: str) -> list[Dict[str, Any]]:
+        """Get all drift events for base_url ordered by detected_at DESC."""
+        if not self._conn:
+            raise RuntimeError("Not connected to database")
+
+        cursor = self._conn.cursor()
+        cursor.execute(
+            "SELECT id, detected_at, similarity, diff_json FROM drift_events WHERE base_url=? ORDER BY detected_at DESC",
+            (base_url,)
+        )
+        results = []
+        for row in cursor.fetchall():
+            results.append({
+                "id": row[0],
+                "detected_at": row[1],
+                "similarity": row[2],
+                "diff": json.loads(row[3])
+            })
+        return results