devhelm 0.1.0__py3-none-any.whl

devhelm/__init__.py

@@ -0,0 +1,123 @@
+"""DevHelm SDK for Python — typed client for monitors, incidents, alerting, and more."""
+
+from devhelm._errors import AuthError, DevhelmError
+from devhelm._pagination import CursorPage, Page
+from devhelm.client import Devhelm
+from devhelm.resources.alert_channels import AlertChannels
+from devhelm.resources.api_keys import ApiKeys
+from devhelm.resources.dependencies import Dependencies
+from devhelm.resources.deploy_lock import DeployLock
+from devhelm.resources.environments import Environments
+from devhelm.resources.incidents import Incidents
+from devhelm.resources.monitors import Monitors
+from devhelm.resources.notification_policies import NotificationPolicies
+from devhelm.resources.resource_groups import ResourceGroups
+from devhelm.resources.secrets import Secrets
+from devhelm.resources.status import Status
+from devhelm.resources.tags import Tags
+from devhelm.resources.webhooks import Webhooks
+from devhelm.types import (
+    AcquireDeployLockRequest,
+    AlertChannelDto,
+    ApiKeyCreateResponse,
+    ApiKeyDto,
+    AssertionTestResultDto,
+    CheckResultDto,
+    CreateAlertChannelRequest,
+    CreateApiKeyRequest,
+    CreateEnvironmentRequest,
+    CreateManualIncidentRequest,
+    CreateMonitorRequest,
+    CreateNotificationPolicyRequest,
+    CreateResourceGroupRequest,
+    CreateSecretRequest,
+    CreateTagRequest,
+    CreateWebhookEndpointRequest,
+    DashboardOverviewDto,
+    DeployLockDto,
+    EnvironmentDto,
+    IncidentDetailDto,
+    IncidentDto,
+    MonitorDto,
+    MonitorVersionDto,
+    NotificationPolicyDto,
+    ResourceGroupDto,
+    ResourceGroupMemberDto,
+    SecretDto,
+    ServiceSubscriptionDto,
+    TagDto,
+    UpdateAlertChannelRequest,
+    UpdateEnvironmentRequest,
+    UpdateMonitorRequest,
+    UpdateNotificationPolicyRequest,
+    UpdateResourceGroupRequest,
+    UpdateSecretRequest,
+    UpdateTagRequest,
+    UpdateWebhookEndpointRequest,
+    WebhookEndpointDto,
+)
+
+__all__ = [
+    # Client
+    "Devhelm",
+    # Errors
+    "DevhelmError",
+    "AuthError",
+    # Pagination
+    "Page",
+    "CursorPage",
+    # Resource classes
+    "Monitors",
+    "Incidents",
+    "AlertChannels",
+    "NotificationPolicies",
+    "Environments",
+    "Secrets",
+    "Tags",
+    "ResourceGroups",
+    "Webhooks",
+    "ApiKeys",
+    "Dependencies",
+    "DeployLock",
+    "Status",
+    # Response DTOs
+    "MonitorDto",
+    "IncidentDto",
+    "IncidentDetailDto",
+    "AlertChannelDto",
+    "NotificationPolicyDto",
+    "EnvironmentDto",
+    "SecretDto",
+    "TagDto",
+    "ResourceGroupDto",
+    "ResourceGroupMemberDto",
+    "WebhookEndpointDto",
+    "ApiKeyDto",
+    "ApiKeyCreateResponse",
+    "ServiceSubscriptionDto",
+    "MonitorVersionDto",
+    "CheckResultDto",
+    "DashboardOverviewDto",
+    "DeployLockDto",
+    "AssertionTestResultDto",
+    # Request types
+    "CreateMonitorRequest",
+    "UpdateMonitorRequest",
+    "CreateManualIncidentRequest",
+    "CreateAlertChannelRequest",
+    "UpdateAlertChannelRequest",
+    "CreateNotificationPolicyRequest",
+    "UpdateNotificationPolicyRequest",
+    "CreateEnvironmentRequest",
+    "UpdateEnvironmentRequest",
+    "CreateSecretRequest",
+    "UpdateSecretRequest",
+    "CreateTagRequest",
+    "UpdateTagRequest",
+    "CreateResourceGroupRequest",
+    "UpdateResourceGroupRequest",
+    "CreateWebhookEndpointRequest",
+    "UpdateWebhookEndpointRequest",
+    "CreateApiKeyRequest",
+    "AcquireDeployLockRequest",
+]

devhelm/_errors.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import json
+from typing import Literal
+
+DevhelmErrorCode = Literal["AUTH", "NOT_FOUND", "CONFLICT", "VALIDATION", "API"]
+
+
+class DevhelmError(Exception):
+    """Base error for all DevHelm API errors."""
+
+    code: DevhelmErrorCode
+    status: int
+    message: str
+    detail: str | None
+
+    def __init__(
+        self,
+        code: DevhelmErrorCode,
+        message: str,
+        status: int,
+        detail: str | None = None,
+    ) -> None:
+        super().__init__(message)
+        self.code = code
+        self.status = status
+        self.message = message
+        self.detail = detail
+
+
+class AuthError(DevhelmError):
+    """Raised on 401/403 authentication or authorization failures."""
+
+    def __init__(self, message: str, status: int) -> None:
+        super().__init__("AUTH", message, status)
+
+
+def error_from_response(status: int, body: str) -> DevhelmError:
+    """Map an HTTP error response to a typed DevhelmError."""
+    message = f"HTTP {status}"
+    detail: str | None = None
+
+    try:
+        parsed = json.loads(body)
+        if isinstance(parsed, dict):
+            message = str(parsed.get("message") or parsed.get("error") or message)
+            raw_detail = parsed.get("detail")
+            if raw_detail is not None:
+                detail = str(raw_detail)
+    except (json.JSONDecodeError, ValueError):
+        if body:
+            message = body
+
+    if status in (401, 403):
+        return AuthError(message, status)
+    if status == 404:
+        return DevhelmError("NOT_FOUND", message, status, detail)
+    if status == 409:
+        return DevhelmError("CONFLICT", message, status, detail)
+    if status in (400, 422):
+        return DevhelmError("VALIDATION", message, status, detail)
+    return DevhelmError("API", message, status, detail)