honeycomb-api 0.5.10__tar.gz → 0.7.4__tar.gz

{honeycomb_api-0.5.10 → honeycomb_api-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: honeycomb-api
-Version: 0.5.10
+Version: 0.7.4
 Summary: Python client for the Honeycomb.io API
 License-Expression: MIT
 License-File: LICENSE
@@ -15,11 +15,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
-Requires-Dist: attrs (>=23.0)
+Requires-Dist: cachetools (>=5.0)
 Requires-Dist: httpx (>=0.27)
 Requires-Dist: pydantic (>=2.0)
 Requires-Dist: pytest-xdist (>=3.8.0,<4.0.0)
-Requires-Dist: python-dateutil (>=2.8)
 Requires-Dist: pyyaml (>=6.0)
 Requires-Dist: rich (>=13.0)
 Requires-Dist: typer (>=0.21.0)
@@ -252,6 +251,58 @@ hny query run --dataset my-dataset --count --last-30-minutes
 
 See the [CLI Reference](https://irvingpop.github.io/honeycomb-api-python/cli/) for full documentation.
 
+## MCP Server for Claude
+
+The SDK includes an MCP (Model Context Protocol) server that lets Claude Desktop, Claude Code, and Cursor interact with Honeycomb directly.
+
+### Configuration
+
+No installation required! Add to your MCP configuration using `uvx` or `pipx`:
+
+**Using uvx (recommended):**
+
+```json
+{
+  "mcpServers": {
+    "honeycomb": {
+      "command": "uvx",
+      "args": ["--from", "honeycomb-api[mcp]", "hny-mcp"],
+      "env": {
+        "HONEYCOMB_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Using pipx:**
+
+```json
+{
+  "mcpServers": {
+    "honeycomb": {
+      "command": "pipx",
+      "args": ["run", "--spec", "honeycomb-api[mcp]", "hny-mcp"],
+      "env": {
+        "HONEYCOMB_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Configuration file locations:**
+- Claude Desktop (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Claude Code: `~/.claude/settings.json` or `.claude/settings.local.json`
+- Cursor: `~/.cursor/mcp.json`
+
+Once configured, ask Claude:
+- "What datasets do I have in Honeycomb?"
+- "Create a trigger for high error rates in api-logs"
+- "Search for columns related to HTTP status"
+
+See the [MCP documentation](https://irvingpop.github.io/honeycomb-api-python/usage/mcp/) for detailed setup instructions.
+
 ## Usage Guide
 
 For complete usage examples and guides, see the [full documentation](https://irvingpop.github.io/honeycomb-api-python/):
@@ -366,6 +417,14 @@ cp .envrc.example .envrc
 direnv allow
 ```
 
+### Testing Standards
+
+This project maintains **high test coverage standards**:
+
+- **≥95% coverage** required for all resource modules
+- Tests use [Polyfactory](https://github.com/litestar-org/polyfactory) for schema-valid mock data generation
+
+
 ### Make Commands
 
 All common development tasks are available via `make`. Run `make help` for a full list:

{honeycomb_api-0.5.10 → honeycomb_api-0.7.4}/README.md

@@ -223,6 +223,58 @@ hny query run --dataset my-dataset --count --last-30-minutes
 
 See the [CLI Reference](https://irvingpop.github.io/honeycomb-api-python/cli/) for full documentation.
 
+## MCP Server for Claude
+
+The SDK includes an MCP (Model Context Protocol) server that lets Claude Desktop, Claude Code, and Cursor interact with Honeycomb directly.
+
+### Configuration
+
+No installation required! Add to your MCP configuration using `uvx` or `pipx`:
+
+**Using uvx (recommended):**
+
+```json
+{
+  "mcpServers": {
+    "honeycomb": {
+      "command": "uvx",
+      "args": ["--from", "honeycomb-api[mcp]", "hny-mcp"],
+      "env": {
+        "HONEYCOMB_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Using pipx:**
+
+```json
+{
+  "mcpServers": {
+    "honeycomb": {
+      "command": "pipx",
+      "args": ["run", "--spec", "honeycomb-api[mcp]", "hny-mcp"],
+      "env": {
+        "HONEYCOMB_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Configuration file locations:**
+- Claude Desktop (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Claude Code: `~/.claude/settings.json` or `.claude/settings.local.json`
+- Cursor: `~/.cursor/mcp.json`
+
+Once configured, ask Claude:
+- "What datasets do I have in Honeycomb?"
+- "Create a trigger for high error rates in api-logs"
+- "Search for columns related to HTTP status"
+
+See the [MCP documentation](https://irvingpop.github.io/honeycomb-api-python/usage/mcp/) for detailed setup instructions.
+
 ## Usage Guide
 
 For complete usage examples and guides, see the [full documentation](https://irvingpop.github.io/honeycomb-api-python/):
@@ -337,6 +389,14 @@ cp .envrc.example .envrc
 direnv allow
 ```
 
+### Testing Standards
+
+This project maintains **high test coverage standards**:
+
+- **≥95% coverage** required for all resource modules
+- Tests use [Polyfactory](https://github.com/litestar-org/polyfactory) for schema-valid mock data generation
+
+
 ### Make Commands
 
 All common development tasks are available via `make`. Run `make help` for a full list:

{honeycomb_api-0.5.10 → honeycomb_api-0.7.4}/pyproject.toml

@@ -28,21 +28,21 @@ Repository = "https://github.com/irvingpop/honeycomb-api-python"
 honeycomb = "honeycomb.cli:app"
 hny = "honeycomb.cli:app"
 honeycomb-api = "honeycomb.cli:app"  # Matches package name for uvx/pipx
+hny-mcp = "honeycomb.mcp:run_server"  # MCP server for Claude Desktop
 
 [tool.poetry]
-version = "0.5.10"
+version = "0.7.4"
 packages = [{ include = "honeycomb", from = "src" }]
 
 [tool.poetry.dependencies]
 python = ">=3.10"
 httpx = ">=0.27"
 pydantic = ">=2.0"
-attrs = ">=23.0"          # Used by generated client
-python-dateutil = ">=2.8" # Used by generated client
 pytest-xdist = "^3.8.0"
 typer = ">=0.21.0"
 rich = ">=13.0"
 pyyaml = ">=6.0"
+cachetools = ">=5.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = ">=8.0"
@@ -54,6 +54,11 @@ mkdocs-include-markdown-plugin = "^7.2.0"
 types-pyyaml = "^6.0.12.20250915"
 isort = "^7.0.0"
 pytest-cov = "^7.0.0"
+datamodel-code-generator = {extras = ["http", "ruff"], version = "^0.52.2"}
+jsonschema = ">=4.23.0"
+types-jsonschema = "^4.26.0.20260109"
+polyfactory = {version = ">=2.18.0", python = ">=3.10,<4.0"}
+types-cachetools = "^6.2.0.20251022"
 
 [tool.poetry.group.docs.dependencies]
 mkdocs = ">=1.5"
@@ -70,6 +75,13 @@ optional = true
 [tool.poetry.group.evals.dependencies]
 deepeval = {version = "^3.7.5", python = ">=3.10,<4.0"}
 anthropic = ">=0.75.0"
+tenacity = ">=8.0.0"
+
+[tool.poetry.group.mcp]
+optional = true
+
+[tool.poetry.group.mcp.dependencies]
+mcp = ">=1.2.0"
 
 [build-system]
 requires = ["poetry-core"]
@@ -90,7 +102,7 @@ markers = [
 target-version = "py310"
 line-length = 100
 src = ["src", "tests"]
-exclude = ["src/honeycomb/_generated"]  # Generated code - don't lint
+exclude = ["src/honeycomb/_generated_models.py"]  # Generated code - don't lint
 
 [tool.ruff.lint]
 select = [
@@ -111,6 +123,7 @@ ignore = [
 
 [tool.ruff.lint.per-file-ignores]
 "src/honeycomb/cli/*.py" = ["B904"]  # CLI error exits don't need exception chaining
+"tests/factories/*.py" = ["E731"]  # Polyfactory uses lambda expressions for field providers
 
 [tool.ruff.lint.isort]
 known-first-party = ["honeycomb"]
@@ -125,5 +138,5 @@ disallow_any_generics = false
 warn_return_any = false
 
 [[tool.mypy.overrides]]
-module = "honeycomb._generated.*"
+module = "honeycomb._generated_models"
 ignore_errors = true

{honeycomb_api-0.5.10 → honeycomb_api-0.7.4}/src/honeycomb/__init__.py

@@ -34,24 +34,33 @@ from .exceptions import (
     HoneycombValidationError,
 )
 from .models import (
-    SLI,
     SLO,
+    AlertType,
     ApiKey,
     ApiKeyCreate,
+    ApiKeyCreateRequest,
+    ApiKeyListResponse,
+    ApiKeyObject,
+    ApiKeyObjectType,
+    ApiKeyResponse,
     ApiKeyType,
     ApiKeyUpdate,
-    AuthInfo,
-    AuthInfoV2,
+    ApiKeyUpdateRequest,
+    Auth,
+    AuthV2Response,
     BatchEvent,
     BatchEventResult,
     Board,
     BoardBuilder,
     BoardBundle,
     BoardCreate,
+    BudgetRateBurnAlertDetailResponse,
     BurnAlert,
     BurnAlertBuilder,
     BurnAlertCreate,
     BurnAlertDefinition,
+    BurnAlertDetailResponse,
+    BurnAlertListResponse,
     BurnAlertRecipient,
     BurnAlertType,
     CalcOp,
@@ -59,30 +68,46 @@ from .models import (
     Column,
     ColumnCreate,
     ColumnType,
+    ConfigurationKey,
+    CreateBudgetRateBurnAlertRequest,
+    CreateBudgetRateBurnAlertRequestSlo,
+    CreateBurnAlertRequest,
+    CreateEnvironmentRequest,
+    CreateExhaustionTimeBurnAlertRequest,
+    CreateExhaustionTimeBurnAlertRequestSlo,
     Dataset,
     DatasetCreate,
     DatasetUpdate,
     DerivedColumn,
     DerivedColumnBuilder,
     DerivedColumnCreate,
+    EmailRecipient,
     EmailRecipientDetails,
     Environment,
     EnvironmentColor,
     EnvironmentCreate,
+    EnvironmentListResponse,
+    EnvironmentResponse,
     EnvironmentUpdate,
+    ExhaustionTimeDetailResponse,
     Filter,
     FilterCombination,
     FilterOp,
     Having,
+    IngestKey,
     Marker,
     MarkerBuilder,
     MarkerCreate,
     MarkerSetting,
     MarkerSettingCreate,
+    MSTeamsRecipient,
     MSTeamsRecipientDetails,
+    MSTeamsWorkflowRecipient,
     MSTeamsWorkflowRecipientDetails,
+    NotificationRecipient,
     Order,
     OrderDirection,
+    PagerDutyRecipient,
     PagerDutyRecipientDetails,
     Query,
     QueryAnnotation,
@@ -103,23 +128,29 @@ from .models import (
     ServiceMapDependencyResult,
     ServiceMapNode,
     ServiceMapNodeType,
+    SlackRecipient,
     SlackRecipientDetails,
     SLIDefinition,
     SLOBuilder,
     SLOBundle,
     SLOCreate,
+    SLOCreateSli,
     TagsMixin,
     Trigger,
     TriggerAlertType,
     TriggerBuilder,
     TriggerBundle,
     TriggerCreate,
-    TriggerQuery,
     TriggerThreshold,
     TriggerThresholdOp,
+    TriggerWithInlineQuery,
+    TriggerWithQueryReference,
+    UpdateBurnAlertRequest,
+    UpdateEnvironmentRequest,
     WebhookHeader,
     WebhookPayloads,
     WebhookPayloadTemplate,
+    WebhookRecipient,
     WebhookRecipientDetails,
     WebhookTemplateVariable,
 )
@@ -159,17 +190,18 @@ __all__ = [
     "QueryBuilder",
     # Models - Triggers
     "Trigger",
-    "TriggerCreate",
+    "TriggerCreate",  # Union type for compatibility
+    "TriggerWithInlineQuery",  # Specific type for inline queries
+    "TriggerWithQueryReference",  # Specific type for query references
     "TriggerThreshold",
     "TriggerThresholdOp",
     "TriggerAlertType",
-    "TriggerQuery",
     "TriggerBuilder",
     "TriggerBundle",
     # Models - SLOs
     "SLO",
     "SLOCreate",
-    "SLI",
+    "SLOCreateSli",
     "SLOBuilder",
     "SLOBundle",
     "SLIDefinition",
@@ -215,41 +247,73 @@ __all__ = [
     "RecipientType",
     "RecipientBuilder",
     "RecipientMixin",
+    "EmailRecipient",
     "EmailRecipientDetails",
+    "SlackRecipient",
     "SlackRecipientDetails",
+    "PagerDutyRecipient",
     "PagerDutyRecipientDetails",
+    "WebhookRecipient",
     "WebhookRecipientDetails",
     "WebhookHeader",
     "WebhookPayloads",
     "WebhookPayloadTemplate",
     "WebhookTemplateVariable",
+    "MSTeamsRecipient",
     "MSTeamsRecipientDetails",
+    "MSTeamsWorkflowRecipient",
     "MSTeamsWorkflowRecipientDetails",
     # Models - Tags
     "TagsMixin",
     # Models - Burn Alerts
+    "AlertType",
+    "BudgetRateBurnAlertDetailResponse",
     "BurnAlert",
     "BurnAlertBuilder",
     "BurnAlertCreate",
     "BurnAlertDefinition",
+    "BurnAlertDetailResponse",
+    "BurnAlertListResponse",
     "BurnAlertRecipient",
     "BurnAlertType",
+    "CreateBudgetRateBurnAlertRequest",
+    "CreateBudgetRateBurnAlertRequestSlo",
+    "CreateBurnAlertRequest",
+    "CreateExhaustionTimeBurnAlertRequest",
+    "CreateExhaustionTimeBurnAlertRequestSlo",
+    "ExhaustionTimeDetailResponse",
+    "NotificationRecipient",
+    "UpdateBudgetRateBurnAlert",
+    "UpdateBurnAlertRequest",
+    "UpdateExhaustionTimeBurnAlertRequest",
     # Models - Events
     "BatchEvent",
     "BatchEventResult",
     # Models - API Keys (v2)
     "ApiKey",
     "ApiKeyCreate",
+    "ApiKeyCreateRequest",
+    "ApiKeyListResponse",
+    "ApiKeyObject",
+    "ApiKeyObjectType",
+    "ApiKeyResponse",
     "ApiKeyType",
     "ApiKeyUpdate",
+    "ApiKeyUpdateRequest",
+    "ConfigurationKey",
+    "IngestKey",
     # Models - Auth
-    "AuthInfo",
-    "AuthInfoV2",
+    "Auth",
+    "AuthV2Response",
     # Models - Environments (v2)
+    "CreateEnvironmentRequest",
     "Environment",
+    "EnvironmentColor",
     "EnvironmentCreate",
+    "EnvironmentListResponse",
+    "EnvironmentResponse",
     "EnvironmentUpdate",
-    "EnvironmentColor",
+    "UpdateEnvironmentRequest",
     # Models - Service Map Dependencies
     "ServiceMapDependency",
     "ServiceMapDependencyRequest",