shivanshu-sdk 1.0.0__tar.gz

shivanshu_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: shivanshu-sdk
+Version: 1.0.0
+Summary: Official Python SDK for Shivanshu Tiwari Portfolio APIs, project intelligence, and autonomous agent evaluation
+Home-page: https://github.com/SHT4BHARAT/NoIntroNeeded
+Author: Shivanshu Tiwari
+Author-email: Shivanshu Tiwari <sht4bharat@gmail.com>
+License: MIT
+Project-URL: Homepage, https://shivanshutiwari.in
+Project-URL: Documentation, https://shivanshutiwari.in/developers/sdk
+Project-URL: Repository, https://github.com/SHT4BHARAT/NoIntroNeeded
+Keywords: shivanshutiwari,sdk,api-client,ai-agents,mcp,portfolio
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Shivanshu Tiwari Python SDK (`shivanshu-sdk`)
+
+Official Python client library for integrating with **Shivanshu Tiwari Portfolio APIs**, project catalogs, asynchronous background jobs, Model Context Protocol (MCP), and sandbox testing.
+
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/shivanshu-sdk/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-brightgreen.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+pip install shivanshu-sdk
+```
+
+*Note: The SDK relies solely on the Python standard library with zero external dependencies.*
+
+## Quick Start
+
+```python
+from shivanshu import ShivanshuClient
+
+# Initialize client (uses https://shivanshutiwari.in by default)
+client = ShivanshuClient()
+
+# 1. Query engineering projects
+res = client.list_projects(domain="ai-agents")
+print(f"Total projects: {len(res['data'])}")
+for proj in res["data"]:
+    print(f"- {proj['title']} ({proj['slug']})")
+
+# 2. Inspect project architecture and technical tradeoffs
+project = client.get_project("agentic-honey-pot")
+print("Architecture:", project.get("architecture", {}).get("summary"))
+
+# 3. Test sandbox environment
+sandbox = client.ping_sandbox()
+print("Sandbox status:", sandbox)
+
+# 4. Generate ephemeral sandbox key
+key_data = client.generate_key()
+print("Test API key:", key_data["apiKey"])
+```
+
+## Features
+
+- **Zero Dependencies:** Pure Python 3.9+ using standard `urllib` and `json`.
+- **Project Intelligence:** Query 19 engineering projects, architecture diagrams, and honest limitation disclosures.
+- **Batch Processing:** Run multi-step operations in an atomic batch.
+- **Async Polling:** Built-in `wait_for_job(job_id)` helper.
+- **AI Agent Friendly:** Built for ingestion by autonomous agents, LangChain tools, and AutoGen systems.
+
+## API Reference
+
+- `client.list_projects(limit=20, cursor=None, domain=None)`
+- `client.get_project(slug)`
+- `client.compare_projects(slug_a, slug_b)`
+- `client.generate_key()`
+- `client.ping_sandbox()`
+- `client.sandbox_contact(name, email, message)`
+- `client.run_batch(operations)`
+- `client.create_job(task, payload=None)`
+- `client.get_job(job_id)`
+- `client.wait_for_job(job_id, poll_interval=1.0, timeout=30.0)`
+- `client.submit_contact(name, email, message, idempotency_key=None)`
+- `client.get_docs(path="llms.txt")`
+
+## Links
+
+- **Developer Portal:** [https://shivanshutiwari.in/developers](https://shivanshutiwari.in/developers)
+- **CLI Tool:** [https://shivanshutiwari.in/developers/cli](https://shivanshutiwari.in/developers/cli)
+- **OpenAPI Spec:** [https://shivanshutiwari.in/openapi.json](https://shivanshutiwari.in/openapi.json)

shivanshu_sdk-1.0.0/README.md

@@ -0,0 +1,71 @@
+# Shivanshu Tiwari Python SDK (`shivanshu-sdk`)
+
+Official Python client library for integrating with **Shivanshu Tiwari Portfolio APIs**, project catalogs, asynchronous background jobs, Model Context Protocol (MCP), and sandbox testing.
+
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/shivanshu-sdk/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-brightgreen.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+pip install shivanshu-sdk
+```
+
+*Note: The SDK relies solely on the Python standard library with zero external dependencies.*
+
+## Quick Start
+
+```python
+from shivanshu import ShivanshuClient
+
+# Initialize client (uses https://shivanshutiwari.in by default)
+client = ShivanshuClient()
+
+# 1. Query engineering projects
+res = client.list_projects(domain="ai-agents")
+print(f"Total projects: {len(res['data'])}")
+for proj in res["data"]:
+    print(f"- {proj['title']} ({proj['slug']})")
+
+# 2. Inspect project architecture and technical tradeoffs
+project = client.get_project("agentic-honey-pot")
+print("Architecture:", project.get("architecture", {}).get("summary"))
+
+# 3. Test sandbox environment
+sandbox = client.ping_sandbox()
+print("Sandbox status:", sandbox)
+
+# 4. Generate ephemeral sandbox key
+key_data = client.generate_key()
+print("Test API key:", key_data["apiKey"])
+```
+
+## Features
+
+- **Zero Dependencies:** Pure Python 3.9+ using standard `urllib` and `json`.
+- **Project Intelligence:** Query 19 engineering projects, architecture diagrams, and honest limitation disclosures.
+- **Batch Processing:** Run multi-step operations in an atomic batch.
+- **Async Polling:** Built-in `wait_for_job(job_id)` helper.
+- **AI Agent Friendly:** Built for ingestion by autonomous agents, LangChain tools, and AutoGen systems.
+
+## API Reference
+
+- `client.list_projects(limit=20, cursor=None, domain=None)`
+- `client.get_project(slug)`
+- `client.compare_projects(slug_a, slug_b)`
+- `client.generate_key()`
+- `client.ping_sandbox()`
+- `client.sandbox_contact(name, email, message)`
+- `client.run_batch(operations)`
+- `client.create_job(task, payload=None)`
+- `client.get_job(job_id)`
+- `client.wait_for_job(job_id, poll_interval=1.0, timeout=30.0)`
+- `client.submit_contact(name, email, message, idempotency_key=None)`
+- `client.get_docs(path="llms.txt")`
+
+## Links
+
+- **Developer Portal:** [https://shivanshutiwari.in/developers](https://shivanshutiwari.in/developers)
+- **CLI Tool:** [https://shivanshutiwari.in/developers/cli](https://shivanshutiwari.in/developers/cli)
+- **OpenAPI Spec:** [https://shivanshutiwari.in/openapi.json](https://shivanshutiwari.in/openapi.json)

shivanshu_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "shivanshu-sdk"
+version = "1.0.0"
+description = "Official Python SDK for Shivanshu Tiwari Portfolio APIs, project intelligence, and autonomous agent evaluation"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "Shivanshu Tiwari", email = "sht4bharat@gmail.com" }
+]
+keywords = ["shivanshutiwari", "sdk", "api-client", "ai-agents", "mcp", "portfolio"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Libraries :: Python Modules"
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://shivanshutiwari.in"
+Documentation = "https://shivanshutiwari.in/developers/sdk"
+Repository = "https://github.com/SHT4BHARAT/NoIntroNeeded"

shivanshu_sdk-1.0.0/setup.cfg

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

shivanshu_sdk-1.0.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="shivanshu-sdk",
+    version="1.0.0",
+    packages=find_packages(),
+    description="Official Python SDK for Shivanshu Tiwari Portfolio APIs, project intelligence, and autonomous agent evaluation",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="Shivanshu Tiwari",
+    author_email="sht4bharat@gmail.com",
+    url="https://github.com/SHT4BHARAT/NoIntroNeeded",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.9",
+)

shivanshu_sdk-1.0.0/shivanshu/__init__.py

@@ -0,0 +1,8 @@
+"""
+Shivanshu Tiwari Official Python SDK
+"""
+
+from .client import ShivanshuClient, ShivanshuAPIError
+
+__version__ = "1.0.0"
+__all__ = ["ShivanshuClient", "ShivanshuAPIError"]

shivanshu_sdk-1.0.0/shivanshu/client.py

@@ -0,0 +1,182 @@
+"""
+Official Python Client for Shivanshu Tiwari Portfolio APIs
+"""
+
+import json
+import time
+import urllib.parse
+import urllib.request
+import urllib.error
+from typing import Any, Dict, List, Optional, Union
+
+
+class ShivanshuAPIError(Exception):
+    """Exception raised for errors in the Shivanshu Tiwari API."""
+
+    def __init__(self, message: str, status: int, body: Any = None):
+        super().__init__(f"[{status}] {message}")
+        self.status = status
+        self.body = body
+
+
+class ShivanshuClient:
+    """Official Python Client for shivanshutiwari.in APIs and services."""
+
+    def __init__(
+        self,
+        base_url: str = "https://shivanshutiwari.in",
+        api_key: Optional[str] = None,
+        timeout: float = 10.0,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.api_key = api_key
+        self.timeout = timeout
+
+    def _request(
+        self,
+        endpoint: str,
+        method: str = "GET",
+        params: Optional[Dict[str, Any]] = None,
+        data: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, str]] = None,
+    ) -> Any:
+        url = f"{self.base_url}/{endpoint.lstrip('/')}"
+        if params:
+            query = urllib.parse.urlencode({k: v for k, v in params.items() if v is not None})
+            if query:
+                url = f"{url}?{query}"
+
+        req_headers = {
+            "Accept": "application/json",
+            "User-Agent": "shivanshu-python-sdk/1.0.0",
+        }
+        if self.api_key:
+            req_headers["Authorization"] = f"Bearer {self.api_key}"
+        if headers:
+            req_headers.update(headers)
+
+        body_bytes = None
+        if data is not None:
+            body_bytes = json.dumps(data).encode("utf-8")
+            req_headers["Content-Type"] = "application/json"
+
+        req = urllib.request.Request(url, data=body_bytes, headers=req_headers, method=method)
+
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as response:
+                content = response.read().decode("utf-8")
+                content_type = response.headers.get("Content-Type", "")
+                if "application/json" in content_type:
+                    return json.loads(content)
+                return content
+        except urllib.error.HTTPError as exc:
+            err_content = exc.read().decode("utf-8")
+            try:
+                err_body = json.loads(err_content)
+            except Exception:
+                err_body = err_content
+            raise ShivanshuAPIError(
+                f"Request to {endpoint} failed", status=exc.code, body=err_body
+            ) from exc
+        except urllib.error.URLError as exc:
+            raise ShivanshuAPIError(f"Connection failed to {url}: {exc.reason}", status=0) from exc
+
+    # Projects
+    def list_projects(
+        self,
+        limit: int = 20,
+        cursor: Optional[str] = None,
+        domain: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """List engineering projects with optional pagination and domain filtering."""
+        return self._request(
+            "/api/v1/projects",
+            params={"limit": limit, "cursor": cursor, "domain": domain},
+        )
+
+    def get_project(self, slug: str) -> Dict[str, Any]:
+        """Retrieve detailed architecture, decisions, and outcomes for a single project slug."""
+        return self._request(f"/api/v1/projects/{urllib.parse.quote(slug)}")
+
+    def compare_projects(self, slug_a: str, slug_b: str) -> Dict[str, Any]:
+        """Compare two projects side-by-side."""
+        proj_a = self.get_project(slug_a)
+        proj_b = self.get_project(slug_b)
+        return {"project_a": proj_a, "project_b": proj_b}
+
+    # Keys & Sandbox
+    def generate_key(self) -> Dict[str, Any]:
+        """Generate an ephemeral self-serve test API key valid for 24 hours."""
+        return self._request("/api/v1/keys", method="POST")
+
+    def ping_sandbox(self) -> Dict[str, Any]:
+        """Verify connectivity to the sandbox testing environment."""
+        return self._request("/api/v1/sandbox/ping")
+
+    def sandbox_contact(self, name: str, email: str, message: str) -> Dict[str, Any]:
+        """Submit a sandbox test contact message without triggering live alerts."""
+        return self._request(
+            "/api/v1/sandbox/contact",
+            method="POST",
+            data={"name": name, "email": email, "message": message},
+        )
+
+    # Batch & Jobs
+    def run_batch(self, operations: List[Dict[str, Any]]) -> Dict[str, Any]:
+        """Execute multiple API operations in an atomic batch."""
+        return self._request(
+            "/api/v1/batch",
+            method="POST",
+            data={"operations": operations},
+        )
+
+    def create_job(self, task: str, payload: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """Dispatch an asynchronous long-running task."""
+        return self._request(
+            "/api/v1/jobs",
+            method="POST",
+            data={"task": task, "payload": payload or {}},
+        )
+
+    def get_job(self, job_id: str) -> Dict[str, Any]:
+        """Poll the status of an asynchronous background job."""
+        return self._request(f"/api/v1/jobs/{urllib.parse.quote(job_id)}")
+
+    def wait_for_job(
+        self, job_id: str, poll_interval: float = 1.0, timeout: float = 30.0
+    ) -> Dict[str, Any]:
+        """Helper to poll a background job until completion or timeout."""
+        start_time = time.time()
+        while time.time() - start_time < timeout:
+            job = self.get_job(job_id)
+            if job.get("status") in ("completed", "failed"):
+                return job
+            time.sleep(poll_interval)
+        raise TimeoutError(f"Job {job_id} exceeded timeout of {timeout} seconds")
+
+    # Contact
+    def submit_contact(
+        self,
+        name: str,
+        email: str,
+        message: str,
+        idempotency_key: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Submit an inquiry with idempotency protection."""
+        headers = {}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        return self._request(
+            "/api/v1/contact",
+            method="POST",
+            data={"name": name, "email": email, "message": message},
+            headers=headers,
+        )
+
+    # Docs & MCP
+    def get_docs(self, path: str = "llms.txt") -> str:
+        """Fetch raw markdown twin or curated LLM index."""
+        url = f"{self.base_url}/{path.lstrip('/')}"
+        req = urllib.request.Request(url, headers={"Accept": "text/markdown, text/plain, */*"})
+        with urllib.request.urlopen(req, timeout=self.timeout) as response:
+            return response.read().decode("utf-8")

shivanshu_sdk-1.0.0/shivanshu_sdk.egg-info/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: shivanshu-sdk
+Version: 1.0.0
+Summary: Official Python SDK for Shivanshu Tiwari Portfolio APIs, project intelligence, and autonomous agent evaluation
+Home-page: https://github.com/SHT4BHARAT/NoIntroNeeded
+Author: Shivanshu Tiwari
+Author-email: Shivanshu Tiwari <sht4bharat@gmail.com>
+License: MIT
+Project-URL: Homepage, https://shivanshutiwari.in
+Project-URL: Documentation, https://shivanshutiwari.in/developers/sdk
+Project-URL: Repository, https://github.com/SHT4BHARAT/NoIntroNeeded
+Keywords: shivanshutiwari,sdk,api-client,ai-agents,mcp,portfolio
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Shivanshu Tiwari Python SDK (`shivanshu-sdk`)
+
+Official Python client library for integrating with **Shivanshu Tiwari Portfolio APIs**, project catalogs, asynchronous background jobs, Model Context Protocol (MCP), and sandbox testing.
+
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/shivanshu-sdk/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-brightgreen.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+pip install shivanshu-sdk
+```
+
+*Note: The SDK relies solely on the Python standard library with zero external dependencies.*
+
+## Quick Start
+
+```python
+from shivanshu import ShivanshuClient
+
+# Initialize client (uses https://shivanshutiwari.in by default)
+client = ShivanshuClient()
+
+# 1. Query engineering projects
+res = client.list_projects(domain="ai-agents")
+print(f"Total projects: {len(res['data'])}")
+for proj in res["data"]:
+    print(f"- {proj['title']} ({proj['slug']})")
+
+# 2. Inspect project architecture and technical tradeoffs
+project = client.get_project("agentic-honey-pot")
+print("Architecture:", project.get("architecture", {}).get("summary"))
+
+# 3. Test sandbox environment
+sandbox = client.ping_sandbox()
+print("Sandbox status:", sandbox)
+
+# 4. Generate ephemeral sandbox key
+key_data = client.generate_key()
+print("Test API key:", key_data["apiKey"])
+```
+
+## Features
+
+- **Zero Dependencies:** Pure Python 3.9+ using standard `urllib` and `json`.
+- **Project Intelligence:** Query 19 engineering projects, architecture diagrams, and honest limitation disclosures.
+- **Batch Processing:** Run multi-step operations in an atomic batch.
+- **Async Polling:** Built-in `wait_for_job(job_id)` helper.
+- **AI Agent Friendly:** Built for ingestion by autonomous agents, LangChain tools, and AutoGen systems.
+
+## API Reference
+
+- `client.list_projects(limit=20, cursor=None, domain=None)`
+- `client.get_project(slug)`
+- `client.compare_projects(slug_a, slug_b)`
+- `client.generate_key()`
+- `client.ping_sandbox()`
+- `client.sandbox_contact(name, email, message)`
+- `client.run_batch(operations)`
+- `client.create_job(task, payload=None)`
+- `client.get_job(job_id)`
+- `client.wait_for_job(job_id, poll_interval=1.0, timeout=30.0)`
+- `client.submit_contact(name, email, message, idempotency_key=None)`
+- `client.get_docs(path="llms.txt")`
+
+## Links
+
+- **Developer Portal:** [https://shivanshutiwari.in/developers](https://shivanshutiwari.in/developers)
+- **CLI Tool:** [https://shivanshutiwari.in/developers/cli](https://shivanshutiwari.in/developers/cli)
+- **OpenAPI Spec:** [https://shivanshutiwari.in/openapi.json](https://shivanshutiwari.in/openapi.json)

shivanshu_sdk-1.0.0/shivanshu_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+setup.py
+shivanshu/__init__.py
+shivanshu/client.py
+shivanshu_sdk.egg-info/PKG-INFO
+shivanshu_sdk.egg-info/SOURCES.txt
+shivanshu_sdk.egg-info/dependency_links.txt
+shivanshu_sdk.egg-info/top_level.txt

shivanshu_sdk-1.0.0/shivanshu_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

shivanshu_sdk-1.0.0/shivanshu_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+shivanshu