contextpress 0.5.1__tar.gz → 0.5.2__tar.gz

{contextpress-0.5.1 → contextpress-0.5.2}/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to `contextpress` are recorded here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.2] - 2026-07-22
+
+- **`OpenAIBackend`** — optional `api_key` / env (`OPENAI_API_KEY`); no manual client required.
+
 ## [0.5.1] - 2026-07-22
 
 - **`ClaudeBackend`** — shortcut for Anthropic Claude (`ANTHROPIC_API_KEY` or `api_key=`).

{contextpress-0.5.1 → contextpress-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contextpress
-Version: 0.5.1
+Version: 0.5.2
 Summary: Deterministic context compression for LLM chat, RAG, and agent pipelines
 Project-URL: Homepage, https://github.com/Taha-azizi/contextpress
 Project-URL: Documentation, https://github.com/Taha-azizi/contextpress#readme
@@ -459,11 +459,10 @@ Optional constructor knobs: **`llm_min_input_chars`**, **`llm_max_summary_tokens
 **Install SDKs** (not bundled): `pip install openai`, `anthropic`, and/or **`ollama`** (for local Ollama), or `pip install "contextpress[llm]"` from this repo’s `pyproject.toml` to pull all optional LLM clients.
 
 ```python
-from openai import OpenAI
 from contextpress import ContextManager
 from contextpress.llm.adapters import OpenAIBackend
 
-backend = OpenAIBackend(client=OpenAI(), model="gpt-4o-mini")
+backend = OpenAIBackend(model="gpt-4o-mini")  # uses OPENAI_API_KEY
 cm = ContextManager(
     type="chat",
     llm_backend=backend,

{contextpress-0.5.1 → contextpress-0.5.2}/README.md

@@ -218,11 +218,10 @@ Optional constructor knobs: **`llm_min_input_chars`**, **`llm_max_summary_tokens
 **Install SDKs** (not bundled): `pip install openai`, `anthropic`, and/or **`ollama`** (for local Ollama), or `pip install "contextpress[llm]"` from this repo’s `pyproject.toml` to pull all optional LLM clients.
 
 ```python
-from openai import OpenAI
 from contextpress import ContextManager
 from contextpress.llm.adapters import OpenAIBackend
 
-backend = OpenAIBackend(client=OpenAI(), model="gpt-4o-mini")
+backend = OpenAIBackend(model="gpt-4o-mini")  # uses OPENAI_API_KEY
 cm = ContextManager(
     type="chat",
     llm_backend=backend,

{contextpress-0.5.1 → contextpress-0.5.2}/contextpress/__init__.py

@@ -16,7 +16,7 @@ __all__ = [
     "CompressionResult",
     "CompressionStats",
 ]
-__version__ = "0.5.1"
+__version__ = "0.5.2"
 
 
 def __getattr__(name: str) -> Any:

{contextpress-0.5.1 → contextpress-0.5.2}/contextpress/llm/adapters.py

@@ -27,20 +27,45 @@ def _ollama_response_text(resp: Any) -> str:
 
 class OpenAIBackend(LLMBackend):
     """
-    Adapter for OpenAI-compatible APIs.
-    Requires: pip install openai
-    User must pass their own client instance.
+    Adapter for **OpenAI** chat APIs.
+
+    Requires: ``pip install openai``
+
+    Usage (API key from env ``OPENAI_API_KEY`` or ``api_key=``)::
 
-    Usage:
-        from openai import OpenAI
         from contextpress.llm.adapters import OpenAIBackend
 
-        backend = OpenAIBackend(client=OpenAI(), model="gpt-4o-mini")
-        cm = ContextManager(type="chat", llm_backend=backend)
+        backend = OpenAIBackend(model=\"gpt-4o-mini\")
+        cm = ContextManager(type=\"chat\", llm_backend=backend)
+
+    Or pass your own client::
+
+        from openai import OpenAI
+
+        backend = OpenAIBackend(client=OpenAI(), model=\"gpt-4o-mini\")
     """
 
-    def __init__(self, client: Any, model: str = "gpt-4o-mini"):
-        self.client = client
+    def __init__(
+        self,
+        client: Any | None = None,
+        model: str = "gpt-4o-mini",
+        *,
+        api_key: str | None = None,
+    ):
+        if client is not None:
+            self.client = client
+            self.model = model
+            return
+        try:
+            from openai import OpenAI
+        except ImportError as exc:
+            raise ImportError(
+                "OpenAIBackend requires the 'openai' package. " "Install with: pip install openai"
+            ) from exc
+        key = api_key or os.environ.get("OPENAI_API_KEY")
+        if not key:
+            raise ValueError("Set OPENAI_API_KEY or pass api_key= for OpenAIBackend")
+        self.client = OpenAI(api_key=key)
         self.model = model
 
     def summarize(self, text: str, max_tokens: int) -> str:

{contextpress-0.5.1 → contextpress-0.5.2}/examples/llm_tier_openai.py

@@ -17,8 +17,6 @@ from __future__ import annotations
 import os
 import sys
 
-from openai import OpenAI
-
 from contextpress import ContextManager
 from contextpress.llm.adapters import OpenAIBackend
 
@@ -35,7 +33,7 @@ def main() -> None:
         {"role": "user", "content": "And numpy? " * 80},
     ]
 
-    backend = OpenAIBackend(client=OpenAI(), model="gpt-4o-mini")
+    backend = OpenAIBackend(model="gpt-4o-mini")
     cm = ContextManager(
         type="chat",
         llm_backend=backend,

{contextpress-0.5.1 → contextpress-0.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "contextpress"
-version = "0.5.1"
+version = "0.5.2"
 description = "Deterministic context compression for LLM chat, RAG, and agent pipelines"
 readme = "README.md"
 license = { file = "LICENSE" }

contextpress-0.5.2/tests/test_v052.py

@@ -0,0 +1,32 @@
+import os
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from contextpress.llm.adapters import OpenAIBackend
+
+
+def test_openai_backend_with_client():
+    client = MagicMock()
+    backend = OpenAIBackend(client=client, model="gpt-4o-mini")
+    assert backend.client is client
+    assert backend.model == "gpt-4o-mini"
+
+
+def test_openai_backend_requires_api_key():
+    mock_openai = MagicMock()
+    with patch.dict(os.environ, {}, clear=True):
+        with patch.dict("sys.modules", {"openai": mock_openai}):
+            with pytest.raises(ValueError, match="OPENAI_API_KEY"):
+                OpenAIBackend()
+
+
+def test_openai_backend_from_api_key():
+    mock_module = MagicMock()
+    mock_client = MagicMock()
+    mock_module.OpenAI.return_value = mock_client
+    with patch.dict(os.environ, {"OPENAI_API_KEY": "sk-test"}):
+        with patch.dict("sys.modules", {"openai": mock_module}):
+            backend = OpenAIBackend(model="gpt-4o-mini")
+    assert backend.client is mock_client
+    mock_module.OpenAI.assert_called_once_with(api_key="sk-test")