polyllm-openai 0.1.0__tar.gz

polyllm_openai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PolyLLM contributors
+
+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.

polyllm_openai-0.1.0/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: polyllm-openai
+Version: 0.1.0
+Summary: OpenAI plugin for PolyLLM.
+Author: PolyLLM contributors
+License-Expression: MIT
+Project-URL: Homepage, https://polyllm.raingpt.top
+Project-URL: Repository, https://github.com/you-want/PolyLLM
+Project-URL: Issues, https://github.com/you-want/PolyLLM/issues
+Keywords: llm,polyllm,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: polyllm-core>=0.1.0
+Dynamic: license-file
+
+# PolyLLM OpenAI Plugin for Python
+
+```python
+from polyllm_core import create_llm
+from polyllm_openai import OpenAIPlugin
+
+llm = create_llm(plugins=[OpenAIPlugin()], providers={"openai": {"api_key": "..."}})
+response = await llm.chat("openai:gpt-4o-mini", messages=[{"role": "user", "content": "你好"}])
+```

polyllm_openai-0.1.0/README.md

@@ -0,0 +1,9 @@
+# PolyLLM OpenAI Plugin for Python
+
+```python
+from polyllm_core import create_llm
+from polyllm_openai import OpenAIPlugin
+
+llm = create_llm(plugins=[OpenAIPlugin()], providers={"openai": {"api_key": "..."}})
+response = await llm.chat("openai:gpt-4o-mini", messages=[{"role": "user", "content": "你好"}])
+```

polyllm_openai-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "polyllm-openai"
+version = "0.1.0"
+description = "OpenAI plugin for PolyLLM."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = ["polyllm-core>=0.1.0"]
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "PolyLLM contributors" }]
+keywords = ["llm", "polyllm", "openai"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://polyllm.raingpt.top"
+Repository = "https://github.com/you-want/PolyLLM"
+Issues = "https://github.com/you-want/PolyLLM/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+polyllm_openai = ["py.typed"]

polyllm_openai-0.1.0/setup.cfg

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

polyllm_openai-0.1.0/src/polyllm_openai/__init__.py

@@ -0,0 +1,4 @@
+from .plugin import OpenAIPlugin, parse_sse
+from .specs import models
+
+__all__ = ["OpenAIPlugin", "models", "parse_sse"]

polyllm_openai-0.1.0/src/polyllm_openai/plugin.py

@@ -0,0 +1,212 @@
+from __future__ import annotations
+
+import asyncio
+import json
+from typing import Any, AsyncIterator, Callable, Mapping, cast
+from urllib.error import HTTPError
+from urllib.request import Request, urlopen
+
+from polyllm_core.config import resolve_provider_runtime
+from polyllm_core.errors import PolyLLMError
+from polyllm_core.types import (
+    ChatContext,
+    FinishReason,
+    LLMPlugin,
+    ModelSpec,
+    ProviderConfig,
+    ProviderModelInfo,
+    UnifiedChoice,
+    UnifiedMessage,
+    UnifiedRequest,
+    UnifiedResponse,
+    UnifiedStreamChunk,
+    UnifiedToolCall,
+    UnifiedUsage,
+)
+
+from .specs import capabilities, models
+
+Transport = Callable[[str, str, dict[str, str], dict[str, Any] | None, int], tuple[int, str]]
+
+
+class OpenAIPlugin(LLMPlugin):
+    provider = "openai"
+    models = models
+
+    def __init__(self, transport: Transport | None = None):
+        self._transport = transport or urllib_transport
+
+    async def chat(
+        self,
+        request: UnifiedRequest,
+        config: ProviderConfig,
+        context: ChatContext,
+    ) -> UnifiedResponse:
+        status, body = await self._request("POST", "/chat/completions", self._build_body(request), config, context)
+        data = self._parse_json(status, body)
+        choice = data["choices"][0]
+        message = choice["message"]
+        return UnifiedResponse(
+            id=data["id"],
+            model=data["model"],
+            choices=[
+                UnifiedChoice(
+                    index=choice["index"],
+                    message=UnifiedMessage(
+                        role="assistant",
+                        content=message.get("content") or "",
+                        tool_calls=tuple(
+                            UnifiedToolCall(
+                                id=call["id"],
+                                type="function",
+                                function=dict(call["function"]),
+                            )
+                            for call in message.get("tool_calls", [])
+                        ),
+                    ),
+                    finish_reason=choice.get("finish_reason", "other"),
+                )
+            ],
+            usage=self._parse_usage(data.get("usage", {})),
+            provider_metadata=data.get("metadata"),
+        )
+
+    async def chat_stream(
+        self,
+        request: UnifiedRequest,
+        config: ProviderConfig,
+        context: ChatContext,
+    ) -> AsyncIterator[UnifiedStreamChunk]:
+        body = self._build_body(request)
+        body["stream"] = True
+        status, text = await self._request("POST", "/chat/completions", body, config, context)
+        if status < 200 or status >= 300:
+            raise PolyLLMError("PROVIDER_ERROR", f"OpenAI API 错误: {status} {text}", {"status": status})
+        for event in parse_sse(text):
+            if event.get("object") != "chat.completion.chunk":
+                continue
+            yield UnifiedStreamChunk(
+                id=event["id"],
+                model=event["model"],
+                delta=dict(event.get("delta", {})),
+                finish_reason=event.get("finish_reason"),
+            )
+
+    async def list_models(self, config: ProviderConfig) -> list[ProviderModelInfo]:
+        status, body = await self._request("GET", "/models", None, config, ChatContext(model=self.models[0]))
+        data = self._parse_json(status, body)
+        return [
+            ProviderModelInfo(
+                id=item["id"],
+                display_name=item.get("display_name"),
+                owned_by=item.get("owned_by"),
+                created_at=item.get("created"),
+                metadata=item.get("metadata"),
+            )
+            for item in data.get("data", [])
+        ]
+
+    def create_model_spec(self, model_id: str) -> ModelSpec:
+        return ModelSpec(
+            id=model_id,
+            provider=self.provider,
+            capabilities=capabilities,
+            context_window=128000,
+            max_output=16384,
+        )
+
+    def _build_body(self, request: UnifiedRequest) -> dict[str, Any]:
+        body: dict[str, Any] = {
+            "model": request.model,
+            "messages": [self._serialize_message(message) for message in request.messages],
+        }
+        if request.temperature is not None:
+            body["temperature"] = request.temperature
+        if request.max_tokens is not None:
+            body["max_tokens"] = request.max_tokens
+        if request.top_p is not None:
+            body["top_p"] = request.top_p
+        if request.json_mode:
+            body["response_format"] = {"type": "json_object"}
+        if request.tools:
+            body["tools"] = [{"type": "function", "function": dict(tool.function)} for tool in request.tools]
+        return body
+
+    @staticmethod
+    def _serialize_message(message: UnifiedMessage) -> dict[str, Any]:
+        result: dict[str, Any] = {"role": message.role, "content": message.content}
+        if message.name:
+            result["name"] = message.name
+        if message.tool_call_id:
+            result["tool_call_id"] = message.tool_call_id
+        if message.tool_calls:
+            result["tool_calls"] = [dict(call.__dict__) for call in message.tool_calls]
+        return result
+
+    async def _request(
+        self,
+        method: str,
+        path: str,
+        payload: dict[str, Any] | None,
+        config: ProviderConfig,
+        context: ChatContext | None,
+    ) -> tuple[int, str]:
+        runtime = resolve_provider_runtime(self.provider, config)
+        base_url = (runtime.base_url or "https://api.openai.com/v1").rstrip("/")
+        headers = {"Authorization": f"Bearer {runtime.api_key}", **runtime.headers}
+        if payload is not None:
+            headers["Content-Type"] = "application/json"
+        return await asyncio.to_thread(
+            self._transport,
+            method,
+            f"{base_url}{path}",
+            headers,
+            payload,
+            context.timeout_ms if context is not None and context.timeout_ms is not None else 120000,
+        )
+
+    @staticmethod
+    def _parse_usage(data: Mapping[str, Any]) -> UnifiedUsage:
+        return UnifiedUsage(
+            prompt_tokens=data.get("prompt_tokens", 0),
+            completion_tokens=data.get("completion_tokens", 0),
+            total_tokens=data.get("total_tokens", 0),
+        )
+
+    @staticmethod
+    def _parse_json(status: int, body: str) -> dict[str, Any]:
+        try:
+            data = cast(dict[str, Any], json.loads(body))
+        except json.JSONDecodeError as error:
+            raise PolyLLMError("PROVIDER_ERROR", f"OpenAI 返回无效 JSON: {body[:200]}", {"status": status}) from error
+        if status < 200 or status >= 300:
+            raise PolyLLMError("PROVIDER_ERROR", f"OpenAI API 错误: {status} {body}", {"status": status, "body": data})
+        return data
+
+
+def urllib_transport(
+    method: str,
+    url: str,
+    headers: dict[str, str],
+    payload: dict[str, Any] | None,
+    timeout_ms: int,
+) -> tuple[int, str]:
+    data = json.dumps(payload).encode("utf-8") if payload is not None else None
+    request = Request(url, data=data, headers=headers, method=method)
+    try:
+        with urlopen(request, timeout=timeout_ms / 1000) as response:
+            return response.status, response.read().decode("utf-8")
+    except HTTPError as error:
+        return error.code, error.read().decode("utf-8")
+
+
+def parse_sse(text: str) -> list[dict[str, Any]]:
+    events: list[dict[str, Any]] = []
+    for line in text.splitlines():
+        if not line.startswith("data:"):
+            continue
+        value = line.removeprefix("data:").strip()
+        if not value or value == "[DONE]":
+            continue
+        events.append(json.loads(value))
+    return events

polyllm_openai-0.1.0/src/polyllm_openai/specs.py

@@ -0,0 +1,39 @@
+from polyllm_core.types import ModelCapabilities, ModelSpec, NumericParamRange
+
+capabilities = ModelCapabilities(
+    streaming=True,
+    vision=True,
+    function_calling=True,
+    json_mode=True,
+    system_prompt=True,
+)
+
+models = (
+    ModelSpec(
+        id="gpt-4o-mini",
+        provider="openai",
+        aliases=("gpt4o-mini",),
+        capabilities=capabilities,
+        params={
+            "temperature": NumericParamRange(0, 2, 1),
+            "max_tokens": NumericParamRange(1, 16384, 4096, field="max_tokens"),
+            "top_p": NumericParamRange(0, 1, 1),
+        },
+        context_window=128000,
+        max_output=16384,
+    ),
+    ModelSpec(
+        id="gpt-4o",
+        provider="openai",
+        aliases=("gpt4o",),
+        snapshot="gpt-4o-2024-11-20",
+        capabilities=capabilities,
+        params={
+            "temperature": NumericParamRange(0, 2, 1),
+            "max_tokens": NumericParamRange(1, 16384, 4096, field="max_tokens"),
+            "top_p": NumericParamRange(0, 1, 1),
+        },
+        context_window=128000,
+        max_output=16384,
+    ),
+)

polyllm_openai-0.1.0/src/polyllm_openai.egg-info/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: polyllm-openai
+Version: 0.1.0
+Summary: OpenAI plugin for PolyLLM.
+Author: PolyLLM contributors
+License-Expression: MIT
+Project-URL: Homepage, https://polyllm.raingpt.top
+Project-URL: Repository, https://github.com/you-want/PolyLLM
+Project-URL: Issues, https://github.com/you-want/PolyLLM/issues
+Keywords: llm,polyllm,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: polyllm-core>=0.1.0
+Dynamic: license-file
+
+# PolyLLM OpenAI Plugin for Python
+
+```python
+from polyllm_core import create_llm
+from polyllm_openai import OpenAIPlugin
+
+llm = create_llm(plugins=[OpenAIPlugin()], providers={"openai": {"api_key": "..."}})
+response = await llm.chat("openai:gpt-4o-mini", messages=[{"role": "user", "content": "你好"}])
+```

polyllm_openai-0.1.0/src/polyllm_openai.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/polyllm_openai/__init__.py
+src/polyllm_openai/plugin.py
+src/polyllm_openai/py.typed
+src/polyllm_openai/specs.py
+src/polyllm_openai.egg-info/PKG-INFO
+src/polyllm_openai.egg-info/SOURCES.txt
+src/polyllm_openai.egg-info/dependency_links.txt
+src/polyllm_openai.egg-info/requires.txt
+src/polyllm_openai.egg-info/top_level.txt
+tests/test_openai.py

polyllm_openai-0.1.0/src/polyllm_openai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

polyllm_openai-0.1.0/src/polyllm_openai.egg-info/requires.txt

@@ -0,0 +1 @@
+polyllm-core>=0.1.0

polyllm_openai-0.1.0/src/polyllm_openai.egg-info/top_level.txt

@@ -0,0 +1 @@
+polyllm_openai

polyllm_openai-0.1.0/tests/test_openai.py

@@ -0,0 +1,77 @@
+import asyncio
+import json
+import unittest
+
+from polyllm_core.types import ProviderConfig, UnifiedMessage, UnifiedRequest
+from polyllm_openai import OpenAIPlugin
+
+
+class OpenAITests(unittest.TestCase):
+    def test_chat_wire_and_response(self):
+        calls = []
+
+        def transport(method, url, headers, payload, timeout):
+            calls.append((method, url, headers, payload, timeout))
+            return 200, json.dumps(
+                {
+                    "id": "resp",
+                    "model": "gpt-4o-mini",
+                    "choices": [
+                        {"index": 0, "message": {"role": "assistant", "content": "ok"}, "finish_reason": "stop"}
+                    ],
+                    "usage": {"prompt_tokens": 2, "completion_tokens": 3, "total_tokens": 5},
+                }
+            )
+
+        plugin = OpenAIPlugin(transport)
+        response = asyncio.run(
+            plugin.chat(
+                UnifiedRequest(
+                    model="gpt-4o-mini",
+                    messages=[UnifiedMessage(role="user", content="hi")],
+                    temperature=0.2,
+                    max_tokens=128,
+                ),
+                ProviderConfig(api_key="k"),
+                None,
+            )
+        )
+        self.assertEqual(response.choices[0].message.content, "ok")
+        self.assertEqual(calls[0][3]["max_tokens"], 128)
+        self.assertTrue(calls[0][2]["Authorization"].startswith("Bearer "))
+
+    def test_list_models(self):
+        def transport(method, url, headers, payload, timeout):
+            self.assertEqual(method, "GET")
+            self.assertTrue(url.endswith("/models"))
+            return 200, json.dumps({"data": [{"id": "gpt-4o-mini", "owned_by": "openai"}]})
+
+        models = asyncio.run(OpenAIPlugin(transport).list_models(ProviderConfig(api_key="k")))
+        self.assertEqual(models[0].id, "gpt-4o-mini")
+
+    def test_stream_parses_sse(self):
+        sse = (
+            'data: {"id":"r","model":"gpt-4o-mini","object":"chat.completion.chunk",'
+            '"delta":{"role":"assistant","content":"he"}}\n\n'
+            'data: {"id":"r","model":"gpt-4o-mini","object":"chat.completion.chunk",'
+            '"delta":{"content":"llo"},"finish_reason":"stop"}\n\n'
+            "data: [DONE]\n\n"
+        )
+
+        async def run():
+            chunks = []
+            async for chunk in OpenAIPlugin(lambda *args: (200, sse)).chat_stream(
+                UnifiedRequest(model="gpt-4o-mini", messages=[UnifiedMessage(role="user", content="hi")], stream=True),
+                ProviderConfig(api_key="k"),
+                None,
+            ):
+                chunks.append(chunk)
+            return chunks
+
+        chunks = asyncio.run(run())
+        self.assertEqual([chunk.delta.get("content") for chunk in chunks], ["he", "llo"])
+        self.assertEqual(chunks[-1].finish_reason, "stop")
+
+
+if __name__ == "__main__":
+    unittest.main()