klozeo 0.1.0__tar.gz

klozeo-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: klozeo
+Version: 0.1.0
+Summary: Official Python SDK for the Klozeo Lead Management API
+Project-URL: Homepage, https://klozeo.com
+Project-URL: Documentation, https://docs.klozeo.com
+Project-URL: Repository, https://github.com/lbframe/sdk-python
+Project-URL: Bug Tracker, https://github.com/lbframe/sdk-python/issues
+Author-email: Klozeo <hello@klozeo.com>
+License: MIT
+Keywords: api,crm,klozeo,leads,sdk
+Classifier: Development Status :: 4 - Beta
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Description-Content-Type: text/markdown
+
+# Klozeo Python SDK
+
+Official Python client for the [Klozeo](https://klozeo.com) Lead Management API.
+
+## Installation
+
+```bash
+pip install klozeo
+```
+
+Requires Python 3.10+.
+
+## Quick Start
+
+```python
+from klozeo import Klozeo, Lead
+
+client = Klozeo("sk_live_your_api_key")
+
+# Create a lead
+resp = client.create(Lead(
+    name="Acme Corporation",
+    source="website",
+    city="San Francisco",
+    email="contact@acme.com",
+    rating=4.5,
+    tags=["enterprise", "saas"],
+))
+print(f"Created: {resp.id}")
+
+# List with filters
+from klozeo import city, rating, SortField, SortOrder
+
+result = client.list(
+    city().eq("Berlin"),
+    rating().gte(4.0),
+    sort_by=SortField.RATING,
+    sort_order=SortOrder.DESC,
+    limit=20,
+)
+for lead in result.leads:
+    print(f"{lead.name} — score: {lead.score}")
+
+# Paginate automatically
+for lead in client.iterate(city().eq("Berlin")):
+    print(lead.name)
+```
+
+## Async Client
+
+```python
+import asyncio
+from klozeo import AsyncKlozeo, Lead
+
+async def main():
+    async with AsyncKlozeo("sk_live_your_api_key") as client:
+        resp = await client.create(Lead(name="Acme", source="website"))
+        async for lead in client.iterate(city().eq("Berlin")):
+            print(lead.name)
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from klozeo import NotFoundError, RateLimitedError, ForbiddenError, KlozeoError
+
+try:
+    lead = client.get("cl_nonexistent")
+except NotFoundError:
+    print("Lead not found")
+except RateLimitedError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except ForbiddenError:
+    print("Leads limit reached — upgrade your plan")
+except KlozeoError as e:
+    print(f"HTTP {e.status_code}: {e.message}")
+```
+
+## Links
+
+- Documentation: https://docs.klozeo.com
+- API Reference: https://docs.klozeo.com/api/leads
+- PyPI: https://pypi.org/project/klozeo

klozeo-0.1.0/README.md

@@ -0,0 +1,85 @@
+# Klozeo Python SDK
+
+Official Python client for the [Klozeo](https://klozeo.com) Lead Management API.
+
+## Installation
+
+```bash
+pip install klozeo
+```
+
+Requires Python 3.10+.
+
+## Quick Start
+
+```python
+from klozeo import Klozeo, Lead
+
+client = Klozeo("sk_live_your_api_key")
+
+# Create a lead
+resp = client.create(Lead(
+    name="Acme Corporation",
+    source="website",
+    city="San Francisco",
+    email="contact@acme.com",
+    rating=4.5,
+    tags=["enterprise", "saas"],
+))
+print(f"Created: {resp.id}")
+
+# List with filters
+from klozeo import city, rating, SortField, SortOrder
+
+result = client.list(
+    city().eq("Berlin"),
+    rating().gte(4.0),
+    sort_by=SortField.RATING,
+    sort_order=SortOrder.DESC,
+    limit=20,
+)
+for lead in result.leads:
+    print(f"{lead.name} — score: {lead.score}")
+
+# Paginate automatically
+for lead in client.iterate(city().eq("Berlin")):
+    print(lead.name)
+```
+
+## Async Client
+
+```python
+import asyncio
+from klozeo import AsyncKlozeo, Lead
+
+async def main():
+    async with AsyncKlozeo("sk_live_your_api_key") as client:
+        resp = await client.create(Lead(name="Acme", source="website"))
+        async for lead in client.iterate(city().eq("Berlin")):
+            print(lead.name)
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from klozeo import NotFoundError, RateLimitedError, ForbiddenError, KlozeoError
+
+try:
+    lead = client.get("cl_nonexistent")
+except NotFoundError:
+    print("Lead not found")
+except RateLimitedError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except ForbiddenError:
+    print("Leads limit reached — upgrade your plan")
+except KlozeoError as e:
+    print(f"HTTP {e.status_code}: {e.message}")
+```
+
+## Links
+
+- Documentation: https://docs.klozeo.com
+- API Reference: https://docs.klozeo.com/api/leads
+- PyPI: https://pypi.org/project/klozeo

klozeo-0.1.0/klozeo/__init__.py

@@ -0,0 +1,159 @@
+"""Klozeo Python SDK.
+
+Official Python client for the Klozeo Lead Management API.
+
+Quick start::
+
+    from klozeo import Klozeo, Lead
+
+    client = Klozeo("sk_live_your_api_key")
+
+    # Create a lead
+    resp = client.create(Lead(name="Acme Corporation", source="website"))
+    print(f"Created: {resp.id}")
+
+    # List with filters
+    from klozeo import city, rating, SortField, SortOrder
+
+    result = client.list(
+        city().eq("Berlin"),
+        rating().gte(4.0),
+        sort_by=SortField.RATING,
+        sort_order=SortOrder.DESC,
+        limit=20,
+    )
+
+    # Iterate all pages automatically
+    for lead in client.iterate(city().eq("Berlin")):
+        print(lead.name)
+
+Async client::
+
+    import asyncio
+    from klozeo import AsyncKlozeo, Lead
+
+    async def main():
+        async with AsyncKlozeo("sk_live_your_api_key") as client:
+            resp = await client.create(Lead(name="Acme", source="website"))
+
+    asyncio.run(main())
+"""
+
+from ._async_client import AsyncKlozeo
+from ._client import Klozeo
+from ._errors import (
+    BadRequestError,
+    ForbiddenError,
+    KlozeoError,
+    NotFoundError,
+    RateLimitedError,
+    UnauthorizedError,
+    ValidationError,
+)
+from ._filters import (
+    Filter,
+    attr,
+    attr_sort_field,
+    category,
+    city,
+    country,
+    email,
+    location,
+    name,
+    or_,
+    phone,
+    rating,
+    review_count,
+    source,
+    state,
+    tags,
+    website,
+)
+from ._models import (
+    Attribute,
+    BatchCreateResult,
+    BatchCreatedItem,
+    BatchError,
+    BatchResult,
+    BatchResultItem,
+    CreateResponse,
+    ExportFormat,
+    Lead,
+    ListOptions,
+    ListResult,
+    Note,
+    ScoringRule,
+    ScoringRuleInput,
+    SortField,
+    SortOrder,
+    UpdateLeadInput,
+    Webhook,
+    WebhookInput,
+    bool_attr,
+    list_attr,
+    number_attr,
+    object_attr,
+    text_attr,
+)
+
+__all__ = [
+    # Clients
+    "Klozeo",
+    "AsyncKlozeo",
+    # Models
+    "Lead",
+    "UpdateLeadInput",
+    "Note",
+    "Attribute",
+    "ScoringRule",
+    "ScoringRuleInput",
+    "Webhook",
+    "WebhookInput",
+    "CreateResponse",
+    "ListResult",
+    "BatchResult",
+    "BatchCreateResult",
+    "BatchCreatedItem",
+    "BatchError",
+    "BatchResultItem",
+    # Enums
+    "ExportFormat",
+    "SortField",
+    "SortOrder",
+    # Query builder
+    "ListOptions",
+    "Filter",
+    # Filter factory functions
+    "city",
+    "name",
+    "country",
+    "state",
+    "category",
+    "source",
+    "email",
+    "phone",
+    "website",
+    "rating",
+    "review_count",
+    "tags",
+    "location",
+    "attr",
+    "or_",
+    "attr_sort_field",
+    # Attribute helpers
+    "text_attr",
+    "number_attr",
+    "bool_attr",
+    "list_attr",
+    "object_attr",
+    # Errors
+    "KlozeoError",
+    "NotFoundError",
+    "UnauthorizedError",
+    "ForbiddenError",
+    "RateLimitedError",
+    "BadRequestError",
+    "ValidationError",
+]
+
+__version__ = "0.1.0"