commet-sdk 0.1.0__tar.gz

commet_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Commet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

commet_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: commet-sdk
+Version: 0.1.0
+Summary: Commet SDK for Python - Billing and usage tracking for SaaS
+Author: Commet Team
+License-Expression: MIT
+Project-URL: Homepage, https://commet.co
+Project-URL: Repository, https://github.com/commet-labs/commet-python
+Keywords: billing,sdk,payments,invoicing,usage-based-billing,seat-licensing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: respx; extra == "dev"
+Dynamic: license-file
+
+# Commet Python SDK
+
+Billing and usage tracking for SaaS applications.
+
+## Installation
+
+```bash
+pip install commet
+```
+
+## Quick start
+
+```python
+from commet import Commet
+
+commet = Commet(api_key="ck_xxx", environment="production")
+
+# Create a customer
+commet.customers.create(email="user@example.com", external_id="user_123")
+
+# Create a subscription
+commet.subscriptions.create(external_id="user_123", plan_code="pro")
+
+# Track usage
+commet.usage.track(feature="api_calls", external_id="user_123")
+
+# Track AI token usage
+commet.usage.track(
+    feature="ai_generation",
+    external_id="user_123",
+    model="claude-sonnet-4-20250514",
+    input_tokens=1000,
+    output_tokens=500,
+)
+```
+
+## Customer context
+
+Scope all operations to a customer to avoid repeating `external_id`:
+
+```python
+customer = commet.customer("user_123")
+
+customer.usage.track("api_calls")
+customer.features.check("custom_branding")
+customer.seats.add("editor", count=3)
+customer.portal.get_url()
+```
+
+## Webhook verification
+
+```python
+from commet import Webhooks
+
+webhooks = Webhooks()
+
+payload = webhooks.verify_and_parse(
+    raw_body=request_body,
+    signature=request.headers["x-commet-signature"],
+    secret="whsec_xxx",
+)
+
+if payload is None:
+    raise ValueError("Invalid webhook signature")
+
+if payload["event"] == "subscription.activated":
+    # handle activation
+    pass
+```
+
+## Context manager
+
+```python
+with Commet(api_key="ck_xxx") as commet:
+    commet.usage.track(feature="api_calls", external_id="user_123")
+# connection pool is automatically closed
+```
+
+## Environments
+
+The SDK defaults to `sandbox`. Set `environment="production"` for live operations:
+
+```python
+commet = Commet(api_key="ck_xxx", environment="production")
+```
+
+## License
+
+MIT

commet_sdk-0.1.0/README.md

@@ -0,0 +1,89 @@
+# Commet Python SDK
+
+Billing and usage tracking for SaaS applications.
+
+## Installation
+
+```bash
+pip install commet
+```
+
+## Quick start
+
+```python
+from commet import Commet
+
+commet = Commet(api_key="ck_xxx", environment="production")
+
+# Create a customer
+commet.customers.create(email="user@example.com", external_id="user_123")
+
+# Create a subscription
+commet.subscriptions.create(external_id="user_123", plan_code="pro")
+
+# Track usage
+commet.usage.track(feature="api_calls", external_id="user_123")
+
+# Track AI token usage
+commet.usage.track(
+    feature="ai_generation",
+    external_id="user_123",
+    model="claude-sonnet-4-20250514",
+    input_tokens=1000,
+    output_tokens=500,
+)
+```
+
+## Customer context
+
+Scope all operations to a customer to avoid repeating `external_id`:
+
+```python
+customer = commet.customer("user_123")
+
+customer.usage.track("api_calls")
+customer.features.check("custom_branding")
+customer.seats.add("editor", count=3)
+customer.portal.get_url()
+```
+
+## Webhook verification
+
+```python
+from commet import Webhooks
+
+webhooks = Webhooks()
+
+payload = webhooks.verify_and_parse(
+    raw_body=request_body,
+    signature=request.headers["x-commet-signature"],
+    secret="whsec_xxx",
+)
+
+if payload is None:
+    raise ValueError("Invalid webhook signature")
+
+if payload["event"] == "subscription.activated":
+    # handle activation
+    pass
+```
+
+## Context manager
+
+```python
+with Commet(api_key="ck_xxx") as commet:
+    commet.usage.track(feature="api_calls", external_id="user_123")
+# connection pool is automatically closed
+```
+
+## Environments
+
+The SDK defaults to `sandbox`. Set `environment="production"` for live operations:
+
+```python
+commet = Commet(api_key="ck_xxx", environment="production")
+```
+
+## License
+
+MIT

commet_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "commet-sdk"
+version = "0.1.0"
+description = "Commet SDK for Python - Billing and usage tracking for SaaS"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "Commet Team" }]
+keywords = [
+    "billing",
+    "sdk",
+    "payments",
+    "invoicing",
+    "usage-based-billing",
+    "seat-licensing",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = ["httpx>=0.27"]
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff", "mypy", "respx"]
+
+[project.urls]
+Homepage = "https://commet.co"
+Repository = "https://github.com/commet-labs/commet-python"
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

commet_sdk-0.1.0/setup.cfg

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

commet_sdk-0.1.0/src/commet/__init__.py

@@ -0,0 +1,21 @@
+from ._exceptions import CommetAPIError, CommetError, CommetValidationError
+from ._http import ApiResponse
+from .client import Commet
+from .resources.webhooks import Webhooks
+
+try:
+    from importlib.metadata import version
+
+    __version__ = version("commet")
+except Exception:
+    __version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    "ApiResponse",
+    "Commet",
+    "CommetAPIError",
+    "CommetError",
+    "CommetValidationError",
+    "Webhooks",
+]

commet_sdk-0.1.0/src/commet/_customer.py

@@ -0,0 +1,119 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ._http import ApiResponse
+    from .resources.features import FeaturesResource
+    from .resources.portal import PortalResource
+    from .resources.seats import SeatsResource
+    from .resources.subscriptions import SubscriptionsResource
+    from .resources.usage import UsageResource
+
+
+class CustomerContext:
+    """Customer-scoped API context.
+
+    All operations are automatically scoped to the customer's external_id.
+
+    Usage::
+
+        customer = commet.customer("user_123")
+
+        customer.features.get("team_members")
+        customer.seats.add("editor")
+        customer.usage.track("api_calls")
+    """
+
+    def __init__(
+        self,
+        external_id: str,
+        *,
+        features: FeaturesResource,
+        seats: SeatsResource,
+        usage: UsageResource,
+        subscriptions: SubscriptionsResource,
+        portal: PortalResource,
+    ) -> None:
+        self._external_id = external_id
+        self.features = _CustomerFeatures(external_id, features)
+        self.seats = _CustomerSeats(external_id, seats)
+        self.usage = _CustomerUsage(external_id, usage)
+        self.subscription = _CustomerSubscription(external_id, subscriptions)
+        self.portal = _CustomerPortal(external_id, portal)
+
+
+class _CustomerFeatures:
+    def __init__(self, external_id: str, resource: FeaturesResource) -> None:
+        self._external_id = external_id
+        self._resource = resource
+
+    def get(self, code: str) -> ApiResponse:
+        return self._resource.get(code=code, external_id=self._external_id)
+
+    def check(self, code: str) -> ApiResponse:
+        return self._resource.check(code=code, external_id=self._external_id)
+
+    def can_use(self, code: str) -> ApiResponse:
+        return self._resource.can_use(code=code, external_id=self._external_id)
+
+    def list(self) -> ApiResponse:
+        return self._resource.list(self._external_id)
+
+
+class _CustomerSeats:
+    def __init__(self, external_id: str, resource: SeatsResource) -> None:
+        self._external_id = external_id
+        self._resource = resource
+
+    def add(self, seat_type: str, count: int = 1) -> ApiResponse:
+        return self._resource.add(
+            seat_type=seat_type, count=count, external_id=self._external_id
+        )
+
+    def remove(self, seat_type: str, count: int = 1) -> ApiResponse:
+        return self._resource.remove(
+            seat_type=seat_type, count=count, external_id=self._external_id
+        )
+
+    def set(self, seat_type: str, count: int) -> ApiResponse:
+        return self._resource.set(
+            seat_type=seat_type, count=count, external_id=self._external_id
+        )
+
+    def get_balance(self, seat_type: str) -> ApiResponse:
+        return self._resource.get_balance(seat_type=seat_type, external_id=self._external_id)
+
+
+class _CustomerUsage:
+    def __init__(self, external_id: str, resource: UsageResource) -> None:
+        self._external_id = external_id
+        self._resource = resource
+
+    def track(
+        self,
+        feature: str,
+        value: int | None = None,
+        properties: dict[str, str] | None = None,
+    ) -> ApiResponse:
+        return self._resource.track(
+            feature=feature, external_id=self._external_id, value=value, properties=properties
+        )
+
+
+class _CustomerSubscription:
+    def __init__(self, external_id: str, resource: SubscriptionsResource) -> None:
+        self._external_id = external_id
+        self._resource = resource
+
+    def get(self) -> ApiResponse:
+        return self._resource.get(self._external_id)
+
+
+class _CustomerPortal:
+    def __init__(self, external_id: str, resource: PortalResource) -> None:
+        self._external_id = external_id
+        self._resource = resource
+
+    def get_url(self) -> ApiResponse:
+        return self._resource.get_url(external_id=self._external_id)

commet_sdk-0.1.0/src/commet/_exceptions.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+
+class CommetError(Exception):
+    def __init__(
+        self,
+        message: str,
+        *,
+        code: str | None = None,
+        status_code: int | None = None,
+        details: object = None,
+    ) -> None:
+        super().__init__(message)
+        self.code = code
+        self.status_code = status_code
+        self.details = details
+
+
+class CommetAPIError(CommetError):
+    def __init__(
+        self,
+        message: str,
+        *,
+        status_code: int,
+        code: str | None = None,
+        details: object = None,
+    ) -> None:
+        super().__init__(message, code=code, status_code=status_code, details=details)
+
+
+class CommetValidationError(CommetError):
+    def __init__(
+        self,
+        message: str,
+        *,
+        validation_errors: dict[str, list[str]],
+    ) -> None:
+        super().__init__(message)
+        self.validation_errors = validation_errors