poelis-sdk 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

poelis_sdk/_transport.py

@@ -1,19 +1,18 @@
 from __future__ import annotations
 
-"""HTTP transport abstraction for the Poelis SDK.
-
-Provides a thin wrapper around httpx with sensible defaults for timeouts,
-retries, and headers including authentication and optional org scoping.
-"""
-
 from typing import Any, Dict, Mapping, Optional
-
 import time
 import random
 import httpx
 
 from .exceptions import ClientError, HTTPError, NotFoundError, RateLimitError, ServerError, UnauthorizedError
 
+"""HTTP transport abstraction for the Poelis SDK.
+
+Provides a thin wrapper around httpx with sensible defaults for timeouts,
+retries, and headers including authentication and optional org scoping.
+"""
+
 
 class Transport:
     """Synchronous HTTP transport using httpx.Client.

poelis_sdk/browser.py

@@ -1,14 +1,14 @@
 from __future__ import annotations
 
+from typing import Any, Dict, List, Optional
+import re
+
 """GraphQL-backed dot-path browser for Poelis SDK.
 
 Provides lazy, name-based navigation across workspaces → products → items → child items,
 with optional property listing on items. Designed for notebook UX.
 """
 
-from typing import Any, Dict, List, Optional
-import re
-
 
 class _Node:
     def __init__(self, client: Any, level: str, parent: Optional["_Node"], node_id: Optional[str], name: Optional[str]) -> None:

poelis_sdk/client.py

@@ -1,14 +1,7 @@
 from __future__ import annotations
 
-"""Core client for the Poelis Python SDK.
-
-This module exposes the `PoelisClient` which configures base URL, authentication,
-tenant scoping, and provides accessors for resource clients. The initial
-implementation is sync-first and keeps the transport layer swappable for
-future async parity.
-"""
-
 from typing import Optional
+import os
 
 from pydantic import BaseModel, Field, HttpUrl
 from ._transport import Transport
@@ -17,7 +10,14 @@ from .items import ItemsClient
 from .search import SearchClient
 from .workspaces import WorkspacesClient
 from .browser import Browser
-import os
+
+"""Core client for the Poelis Python SDK.
+
+This module exposes the `PoelisClient` which configures base URL, authentication,
+tenant scoping, and provides accessors for resource clients. The initial
+implementation is sync-first and keeps the transport layer swappable for
+future async parity.
+"""
 
 
 class ClientConfig(BaseModel):
@@ -30,7 +30,7 @@ class ClientConfig(BaseModel):
         timeout_seconds: Request timeout in seconds.
     """
 
-    base_url: HttpUrl
+    base_url: HttpUrl = Field(default="https://api.poelis.ai")
     api_key: str = Field(min_length=1)
     org_id: str = Field(min_length=1)
     timeout_seconds: float = 30.0
@@ -44,13 +44,13 @@ class PoelisClient:
     resource accessors to unblock incremental development.
     """
 
-    def __init__(self, base_url: str, api_key: str, org_id: str, timeout_seconds: float = 30.0) -> None:
+    def __init__(self, api_key: str, org_id: str, base_url: str = "https://api.poelis.ai", timeout_seconds: float = 30.0) -> None:
         """Initialize the client with API endpoint and credentials.
 
         Args:
-            base_url: Base URL of the Poelis API.
             api_key: API key for API authentication.
             org_id: Tenant organization id to scope requests.
+            base_url: Base URL of the Poelis API. Defaults to production.
             timeout_seconds: Network timeout in seconds.
         """
 
@@ -81,23 +81,21 @@ class PoelisClient:
         """Construct a client using environment variables.
 
         Expected variables:
-        - POELIS_BASE_URL
+        - POELIS_BASE_URL (optional, defaults to production)
         - POELIS_API_KEY
         - POELIS_ORG_ID
         """
 
-        base_url = os.environ.get("POELIS_BASE_URL")
+        base_url = os.environ.get("POELIS_BASE_URL", "https://api.poelis.ai")
         api_key = os.environ.get("POELIS_API_KEY")
         org_id = os.environ.get("POELIS_ORG_ID")
 
-        if not base_url:
-            raise ValueError("POELIS_BASE_URL must be set")
         if not api_key:
             raise ValueError("POELIS_API_KEY must be set")
         if not org_id:
             raise ValueError("POELIS_ORG_ID must be set")
 
-        return cls(base_url=base_url, api_key=api_key, org_id=org_id)
+        return cls(api_key=api_key, org_id=org_id, base_url=base_url)
 
     @property
     def base_url(self) -> str:

poelis_sdk/exceptions.py

@@ -1,9 +1,9 @@
 from __future__ import annotations
 
-"""SDK exception hierarchy for Poelis."""
-
 from typing import Optional
 
+"""SDK exception hierarchy for Poelis."""
+
 
 class PoelisError(Exception):
     """Base SDK exception."""

poelis_sdk/items.py

@@ -1,11 +1,11 @@
 from __future__ import annotations
 
-"""Items resource client."""
-
 from typing import Generator, Any, Optional, Dict, List
 
 from ._transport import Transport
 
+"""Items resource client."""
+
 
 class ItemsClient:
     """Client for item resources (prototype exposes listing iterator only)."""

poelis_sdk/models.py

@@ -1,11 +1,11 @@
 from __future__ import annotations
 
-"""Pydantic models for SDK resources."""
-
 from typing import Optional
 
 from pydantic import BaseModel, Field
 
+"""Pydantic models for SDK resources."""
+
 
 class Product(BaseModel):
     """Product resource representation."""

poelis_sdk/products.py

@@ -1,12 +1,12 @@
 from __future__ import annotations
 
-"""Products resource client."""
-
 from typing import Generator, Optional, List
 
 from ._transport import Transport
 from .models import PaginatedProducts, Product
 
+"""Products resource client."""
+
 
 class ProductsClient:
     """Client for product resources."""

poelis_sdk/search.py

@@ -1,11 +1,11 @@
 from __future__ import annotations
 
-"""Search resource client using GraphQL endpoints only."""
-
 from typing import Any, Dict, Optional
 
 from ._transport import Transport
 
+"""Search resource client using GraphQL endpoints only."""
+
 
 class SearchClient:
     """Client for /v1/search endpoints (products, items, properties)."""

poelis_sdk/workspaces.py

@@ -1,11 +1,11 @@
 from __future__ import annotations
 
-"""Workspaces GraphQL client."""
-
 from typing import Any, Dict, List, Optional
 
 from ._transport import Transport
 
+"""Workspaces GraphQL client."""
+
 
 class WorkspacesClient:
     """Client for querying workspaces via GraphQL."""

{poelis_sdk-0.1.0.dist-info → poelis_sdk-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: poelis-sdk
-Version: 0.1.0
+Version: 0.1.1
 Summary: Official Python SDK for Poelis
 Project-URL: Homepage, https://poelis.ai
 Project-URL: Source, https://github.com/PoelisTechnologies/poelis-python-sdk
@@ -31,9 +31,9 @@ GraphQL-first Python SDK for Poelis with a focus on great developer experience.
 from poelis_sdk import PoelisClient
 
 client = PoelisClient(
-    base_url="https://api.poelis.ai",   # or your environment
     api_key="poelis_live_A1B2C3...",    # Organization Settings → API Keys
     org_id="tenant_uci_001",            # same section
+    # base_url defaults to https://api.poelis.ai
 )
 
 # Workspaces → Products (GraphQL)
@@ -57,9 +57,11 @@ print(props["total"], len(props["hits"]))
 
 ### Base URL
 
-- Local development: `http://localhost:8000`
-- Staging (example): `https://api.staging.poelis.ai`
-- Production (example): `https://api.poelis.ai`
+The SDK defaults to the production API (`https://api.poelis.ai`). You can override this for different environments:
+
+- Local development: `base_url="http://localhost:8000"`
+- Staging (example): `base_url="https://api.staging.poelis.ai"`
+- Production (default): No need to specify, uses `https://api.poelis.ai`
 
 Confirm the exact URLs for your environments.
 
@@ -74,9 +76,9 @@ Note: Multi-tenancy uses `org_id` for scoping. When using API keys, the SDK sets
 5. You can rotate or revoke keys anytime. Prefer storing as env vars:
 
 ```bash
-export POELIS_BASE_URL=https://api.poelis.ai
 export POELIS_API_KEY=poelis_live_A1B2C3...
 export POELIS_ORG_ID=tenant_uci_001
+# POELIS_BASE_URL is optional - defaults to https://api.poelis.ai
 ```
 
 

poelis_sdk-0.1.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+poelis_sdk/__init__.py,sha256=6pyvKcM6imsuCMm-VIINFNa-hXK9fUmcg86EWshPAlk,126
+poelis_sdk/_transport.py,sha256=0yLpcMbZB7KUmBBG3epwbGi2NwOqt0dwMBYh-Y8o6Pc,5830
+poelis_sdk/browser.py,sha256=zyMoNqFCvKZDV4ZSFVk2N1-HHiq80gzmkGN3uRo1CuM,12409
+poelis_sdk/client.py,sha256=MWgunZ5FsQZIM7CEsOU25MGaL-FUEhp5Ina6gs42gKc,3622
+poelis_sdk/exceptions.py,sha256=qX5kpAr8ozJUOW-CNhmspWVIE-bvUZT_PUnimYuBxNY,1101
+poelis_sdk/items.py,sha256=uFm-fu16QUOsVnlnEDF012zpgvySlN9N0SXMwIWXeOw,2183
+poelis_sdk/models.py,sha256=zKbqHkK2xOdkqWUQlmu-BZ0Zyj8uC2d10PK69f3QUHo,470
+poelis_sdk/products.py,sha256=Byc5XBNruIO-vAGxDom0lRWA3xxD6korMhoajPz83R4,2073
+poelis_sdk/search.py,sha256=YxtjR8AD6tOeVNTVWc8J_l9YkVu2f-EnC_udkMAeFiM,4122
+poelis_sdk/workspaces.py,sha256=LNVt73nqdssNx42_YB_V5Qp35kEdFn9rNBYmEjpM7vk,1518
+poelis_sdk/.github/workflows/sdk-ci.yml,sha256=hWO-igHeTAsxEJGCueteEQnAEi00GWXJJPa8DWgqhHM,750
+poelis_sdk/.github/workflows/sdk-docs.yml,sha256=bS1uUxOKRMA6TWrmzzJHTokyP0Nt0aJwojcLAgLoEhs,1166
+poelis_sdk/.github/workflows/sdk-publish-testpypi.yml,sha256=FBZcfDrtUijs6rcC8WeIimi9SfgoB8Xm5pTNtcztT44,776
+poelis_sdk-0.1.1.dist-info/METADATA,sha256=IfL1IbboumkYTNBTn8DhmimqcD59s9jlFlBG4RoKIz0,3280
+poelis_sdk-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+poelis_sdk-0.1.1.dist-info/licenses/LICENSE,sha256=EEmE_r8wk_pdXB8CWp1LG6sBOl7--hNSS2kV94cI6co,1075
+poelis_sdk-0.1.1.dist-info/RECORD,,

poelis_sdk-0.1.0.dist-info/RECORD

@@ -1,17 +0,0 @@
-poelis_sdk/__init__.py,sha256=6pyvKcM6imsuCMm-VIINFNa-hXK9fUmcg86EWshPAlk,126
-poelis_sdk/_transport.py,sha256=RIyBffRR-9uz2iUb46AcRSR8rtsuyjSjFeY-EZ-BtP8,5831
-poelis_sdk/browser.py,sha256=2LblJveGsFMRXCK45S8hM1j3cWowLYYiR_YR7D6dQn8,12409
-poelis_sdk/client.py,sha256=lNjBZ7vVNsHzsHfkpxKdkP9UYjjBuzutS7tZXVSvtQI,3556
-poelis_sdk/exceptions.py,sha256=O7LJn8ZH1ZpaAx7xk7rnxkp6VgJy8ZbSV7yX6arI2tE,1101
-poelis_sdk/items.py,sha256=uKs9LBMP3en_TkUCkzj53KTfGeSjph5E3mfXeAl_YO0,2183
-poelis_sdk/models.py,sha256=OtGuv8w4n6p6X_Qlm8dE2B2Apq10gqwyPopitLz9A1Q,470
-poelis_sdk/products.py,sha256=qyZz-QnLgXTgxAXuTbnLEjIE_GrobtfVKkyIRSe7hxU,2073
-poelis_sdk/search.py,sha256=FSLkczztSQoYfolMRhUAZ7M4wI8PIeE6Ny0c40LGKng,4122
-poelis_sdk/workspaces.py,sha256=kqxIoFlSdaTWdeARjZgTUs_Gy-GF-tkRZCNKCChNsug,1518
-poelis_sdk/.github/workflows/sdk-ci.yml,sha256=hWO-igHeTAsxEJGCueteEQnAEi00GWXJJPa8DWgqhHM,750
-poelis_sdk/.github/workflows/sdk-docs.yml,sha256=bS1uUxOKRMA6TWrmzzJHTokyP0Nt0aJwojcLAgLoEhs,1166
-poelis_sdk/.github/workflows/sdk-publish-testpypi.yml,sha256=FBZcfDrtUijs6rcC8WeIimi9SfgoB8Xm5pTNtcztT44,776
-poelis_sdk-0.1.0.dist-info/METADATA,sha256=l9QximRzNb7kkKnqYLQjTT5xQo7IaOieH-2PqpU9gmQ,3108
-poelis_sdk-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-poelis_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=EEmE_r8wk_pdXB8CWp1LG6sBOl7--hNSS2kV94cI6co,1075
-poelis_sdk-0.1.0.dist-info/RECORD,,