honeycomb-api 0.1.0__py3-none-any.whl

honeycomb/__init__.py

@@ -0,0 +1,217 @@
+"""Honeycomb API client for Python."""
+
+from importlib.metadata import version
+
+__version__ = version("honeycomb-api")
+
+from . import tools
+from .auth import APIKeyAuth, AuthStrategy, ManagementKeyAuth, create_auth
+from .client import HoneycombClient, RateLimitInfo, RetryConfig
+from .exceptions import (
+    HoneycombAPIError,
+    HoneycombAuthError,
+    HoneycombConnectionError,
+    HoneycombForbiddenError,
+    HoneycombNotFoundError,
+    HoneycombRateLimitError,
+    HoneycombServerError,
+    HoneycombTimeoutError,
+    HoneycombValidationError,
+)
+from .models import (
+    SLI,
+    SLO,
+    ApiKey,
+    ApiKeyCreate,
+    ApiKeyType,
+    BatchEvent,
+    BatchEventResult,
+    Board,
+    BoardBuilder,
+    BoardBundle,
+    BoardCreate,
+    BurnAlert,
+    BurnAlertBuilder,
+    BurnAlertCreate,
+    BurnAlertDefinition,
+    BurnAlertRecipient,
+    BurnAlertType,
+    CalcOp,
+    Calculation,
+    Column,
+    ColumnCreate,
+    ColumnType,
+    Dataset,
+    DatasetCreate,
+    DerivedColumn,
+    DerivedColumnBuilder,
+    DerivedColumnCreate,
+    Environment,
+    EnvironmentColor,
+    EnvironmentCreate,
+    EnvironmentUpdate,
+    Filter,
+    FilterCombination,
+    FilterOp,
+    Having,
+    Marker,
+    MarkerBuilder,
+    MarkerCreate,
+    MarkerSetting,
+    MarkerSettingCreate,
+    Order,
+    OrderDirection,
+    Query,
+    QueryAnnotation,
+    QueryAnnotationCreate,
+    QueryAnnotationSource,
+    QueryBuilder,
+    QueryResult,
+    QuerySpec,
+    Recipient,
+    RecipientBuilder,
+    RecipientCreate,
+    RecipientMixin,
+    RecipientType,
+    ServiceMapDependency,
+    ServiceMapDependencyRequest,
+    ServiceMapDependencyRequestCreate,
+    ServiceMapDependencyRequestStatus,
+    ServiceMapDependencyResult,
+    ServiceMapNode,
+    ServiceMapNodeType,
+    SLIDefinition,
+    SLOBuilder,
+    SLOBundle,
+    SLOCreate,
+    TagsMixin,
+    Trigger,
+    TriggerAlertType,
+    TriggerBuilder,
+    TriggerBundle,
+    TriggerCreate,
+    TriggerQuery,
+    TriggerThreshold,
+    TriggerThresholdOp,
+)
+
+__all__ = [
+    "__version__",
+    # Client
+    "HoneycombClient",
+    "RetryConfig",
+    "RateLimitInfo",
+    # Tools (Claude API)
+    "tools",
+    # Auth
+    "AuthStrategy",
+    "APIKeyAuth",
+    "ManagementKeyAuth",
+    "create_auth",
+    # Exceptions
+    "HoneycombAPIError",
+    "HoneycombAuthError",
+    "HoneycombForbiddenError",
+    "HoneycombNotFoundError",
+    "HoneycombValidationError",
+    "HoneycombRateLimitError",
+    "HoneycombServerError",
+    "HoneycombTimeoutError",
+    "HoneycombConnectionError",
+    # Models - Query Builder (enums and typed models)
+    "CalcOp",
+    "FilterOp",
+    "OrderDirection",
+    "FilterCombination",
+    "Calculation",
+    "Filter",
+    "Order",
+    "Having",
+    "QueryBuilder",
+    # Models - Triggers
+    "Trigger",
+    "TriggerCreate",
+    "TriggerThreshold",
+    "TriggerThresholdOp",
+    "TriggerAlertType",
+    "TriggerQuery",
+    "TriggerBuilder",
+    "TriggerBundle",
+    # Models - SLOs
+    "SLO",
+    "SLOCreate",
+    "SLI",
+    "SLOBuilder",
+    "SLOBundle",
+    "SLIDefinition",
+    # Models - Datasets
+    "Dataset",
+    "DatasetCreate",
+    # Models - Boards
+    "Board",
+    "BoardBuilder",
+    "BoardBundle",
+    "BoardCreate",
+    "ExistingQueryPanel",
+    "ExistingSLOPanel",
+    "QueryBuilderPanel",
+    "SLOBuilderPanel",
+    "TextPanel",
+    # Models - Queries
+    "Query",
+    "QuerySpec",
+    "QueryResult",
+    # Models - Query Annotations
+    "QueryAnnotation",
+    "QueryAnnotationCreate",
+    "QueryAnnotationSource",
+    # Models - Columns
+    "Column",
+    "ColumnCreate",
+    "ColumnType",
+    # Models - Derived Columns (Calculated Fields)
+    "DerivedColumn",
+    "DerivedColumnCreate",
+    "DerivedColumnBuilder",
+    # Models - Markers
+    "Marker",
+    "MarkerBuilder",
+    "MarkerCreate",
+    "MarkerSetting",
+    "MarkerSettingCreate",
+    # Models - Recipients
+    "Recipient",
+    "RecipientCreate",
+    "RecipientType",
+    "RecipientBuilder",
+    "RecipientMixin",
+    # Models - Tags
+    "TagsMixin",
+    # Models - Burn Alerts
+    "BurnAlert",
+    "BurnAlertBuilder",
+    "BurnAlertCreate",
+    "BurnAlertDefinition",
+    "BurnAlertRecipient",
+    "BurnAlertType",
+    # Models - Events
+    "BatchEvent",
+    "BatchEventResult",
+    # Models - API Keys (v2)
+    "ApiKey",
+    "ApiKeyCreate",
+    "ApiKeyType",
+    # Models - Environments (v2)
+    "Environment",
+    "EnvironmentCreate",
+    "EnvironmentUpdate",
+    "EnvironmentColor",
+    # Models - Service Map Dependencies
+    "ServiceMapDependency",
+    "ServiceMapDependencyRequest",
+    "ServiceMapDependencyRequestCreate",
+    "ServiceMapDependencyRequestStatus",
+    "ServiceMapDependencyResult",
+    "ServiceMapNode",
+    "ServiceMapNodeType",
+]

honeycomb/_generated/__init__.py

@@ -0,0 +1,8 @@
+
+""" A client library for accessing Honeycomb API """
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

honeycomb/_generated/api/__init__.py

@@ -0,0 +1 @@
+""" Contains methods for accessing the API """

honeycomb/_generated/api/auth/get_auth.py

@@ -0,0 +1,172 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.auth import Auth
+from ...models.error import Error
+from typing import cast
+
+
+
+def _get_kwargs(
+    
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/1/auth",
+    }
+
+
+    return _kwargs
+
+
+def _parse_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Optional[Union[Auth, Error]]:
+    if response.status_code == 200:
+        response_200 = Auth.from_dict(response.json())
+
+
+
+        return response_200
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+
+
+        return response_401
+    if response.status_code == 429:
+        response_429 = Error.from_dict(response.json())
+
+
+
+        return response_429
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Response[Union[Auth, Error]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+
+) -> Response[Union[Auth, Error]]:
+    """ List Authorizations
+
+     Returns metadata about the API Key used to call the API.
+    Note: a Honeycomb Classic API key will return an empty string for both of the `environment` values.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[Auth, Error]]
+     """
+
+
+    kwargs = _get_kwargs(
+        
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+
+) -> Optional[Union[Auth, Error]]:
+    """ List Authorizations
+
+     Returns metadata about the API Key used to call the API.
+    Note: a Honeycomb Classic API key will return an empty string for both of the `environment` values.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[Auth, Error]
+     """
+
+
+    return sync_detailed(
+        client=client,
+
+    ).parsed
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+
+) -> Response[Union[Auth, Error]]:
+    """ List Authorizations
+
+     Returns metadata about the API Key used to call the API.
+    Note: a Honeycomb Classic API key will return an empty string for both of the `environment` values.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[Auth, Error]]
+     """
+
+
+    kwargs = _get_kwargs(
+        
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+
+) -> Optional[Union[Auth, Error]]:
+    """ List Authorizations
+
+     Returns metadata about the API Key used to call the API.
+    Note: a Honeycomb Classic API key will return an empty string for both of the `environment` values.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[Auth, Error]
+     """
+
+
+    return (await asyncio_detailed(
+        client=client,
+
+    )).parsed

honeycomb/_generated/api/auth/get_v2_auth.py

@@ -0,0 +1,168 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.auth_v2_response import AuthV2Response
+from ...models.error import Error
+from typing import cast
+
+
+
+def _get_kwargs(
+    
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/2/auth",
+    }
+
+
+    return _kwargs
+
+
+def _parse_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Optional[Union[AuthV2Response, Error]]:
+    if response.status_code == 200:
+        response_200 = AuthV2Response.from_dict(response.json())
+
+
+
+        return response_200
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+
+
+        return response_401
+    if response.status_code == 429:
+        response_429 = Error.from_dict(response.json())
+
+
+
+        return response_429
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Response[Union[AuthV2Response, Error]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+
+) -> Response[Union[AuthV2Response, Error]]:
+    """ List Authorizations V2
+
+     Returns metadata about the Management API Key used to call the API.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[AuthV2Response, Error]]
+     """
+
+
+    kwargs = _get_kwargs(
+        
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+
+) -> Optional[Union[AuthV2Response, Error]]:
+    """ List Authorizations V2
+
+     Returns metadata about the Management API Key used to call the API.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[AuthV2Response, Error]
+     """
+
+
+    return sync_detailed(
+        client=client,
+
+    ).parsed
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+
+) -> Response[Union[AuthV2Response, Error]]:
+    """ List Authorizations V2
+
+     Returns metadata about the Management API Key used to call the API.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[AuthV2Response, Error]]
+     """
+
+
+    kwargs = _get_kwargs(
+        
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+
+) -> Optional[Union[AuthV2Response, Error]]:
+    """ List Authorizations V2
+
+     Returns metadata about the Management API Key used to call the API.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[AuthV2Response, Error]
+     """
+
+
+    return (await asyncio_detailed(
+        client=client,
+
+    )).parsed