release: 0.12.0 (#566)

* chore(internal): update pydantic dependency

* chore(types): change optional parameter type from NotGiven to Omit

* chore: do not install brew dependencies in ./scripts/bootstrap by default

* chore(internal): version bump

* chore(internal): version bump

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* chore(internal): detect missing future annotations with ruff

* chore: bump `httpx-aiohttp` version to 0.1.9

* feat(api): api update

* feat(api): api update

* fix(client): close streams without requiring full consumption

* chore(internal/tests): avoid race condition with implicit client cleanup

* chore(internal): grammar fix (it's -> its)

* chore(package): drop Python 3.8 support

* fix: compat with Python 3.14

* release: 0.12.0

* chore(internal): update pydantic dependency

* chore(types): change optional parameter type from NotGiven to Omit

* chore: do not install brew dependencies in ./scripts/bootstrap by default

* chore(internal): version bump

* chore(internal): version bump

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* chore(internal): detect missing future annotations with ruff

* chore: bump `httpx-aiohttp` version to 0.1.9

* feat(api): api update

* feat(api): api update

* fix(client): close streams without requiring full consumption

* chore(internal/tests): avoid race condition with implicit client cleanup

* chore(internal): grammar fix (it's -> its)

* chore(package): drop Python 3.8 support

* fix: compat with Python 3.14

* chore(internal): version bump

* chore(internal): version bump

* chore(internal): version bump

* chore(internal): version bump

* chore(internal): version bump

* chore(internal): version bump

* release: 0.12.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Vinicius Mello <vinicius@openlayer.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.11.4"
+  ".": "0.12.0"
 }

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 18
-openapi_spec_hash: 153617b7252b1b12f21043b2a1246f8b
-config_hash: 30422a4611d93ca69e4f1aff60b9ddb5
+openapi_spec_hash: 539798fac79a1eeebf9ac4faa0492455
+config_hash: 6dcf08c4324405f152d1da9fc11ab04a

CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## 0.12.0 (2025-12-26)
+
+Full Changelog: [v0.11.4...v0.12.0](https://github.com/openlayer-ai/openlayer-python/compare/v0.11.4...v0.12.0)
+
+### Features
+
+* **api:** api update ([f117723](https://github.com/openlayer-ai/openlayer-python/commit/f11772338f2da872ca49f0a658c45109b9507800))
+* **api:** api update ([9f22b46](https://github.com/openlayer-ai/openlayer-python/commit/9f22b4660e4b37a786a6ff3999847936577c8a23))
+* enhance LiteLLM metadata extraction by adding cost retrieval from response headers ([43a7d2e](https://github.com/openlayer-ai/openlayer-python/commit/43a7d2e44b788586a3e4e3e484e9a7967f3631af))
+* prevent multiple patching in trace_litellm function to avoid duplicate traces ([#568](https://github.com/openlayer-ai/openlayer-python/issues/568)) ([a1619e7](https://github.com/openlayer-ai/openlayer-python/commit/a1619e793878720b5719ca7e2a580e9990b88f96))
+
+
+### Bug Fixes
+
+* **client:** close streams without requiring full consumption ([c1458b7](https://github.com/openlayer-ai/openlayer-python/commit/c1458b7487946db5d4a2037852ee0acd31cc5672))
+* compat with Python 3.14 ([c2d9681](https://github.com/openlayer-ai/openlayer-python/commit/c2d9681e556118e9f6f91de46f1662b7a794ee2c))
+
+
+### Chores
+
+* bump `httpx-aiohttp` version to 0.1.9 ([3f895de](https://github.com/openlayer-ai/openlayer-python/commit/3f895ded9e56ca11c4aafc093502726a14afedf6))
+* do not install brew dependencies in ./scripts/bootstrap by default ([45badc5](https://github.com/openlayer-ai/openlayer-python/commit/45badc57d4e30a195407e5b733a7327356685c69))
+* **internal/tests:** avoid race condition with implicit client cleanup ([3d05ccc](https://github.com/openlayer-ai/openlayer-python/commit/3d05ccc4ee73fe8f5c3de50d4a7dcbdcb3551674))
+* **internal:** detect missing future annotations with ruff ([d2887ba](https://github.com/openlayer-ai/openlayer-python/commit/d2887ba77f441518ca7e8ae1b690cee42794596a))
+* **internal:** grammar fix (it's -> its) ([4af20e1](https://github.com/openlayer-ai/openlayer-python/commit/4af20e1d560be01fb7eaa9dd050398fe23f1e4bb))
+* **internal:** update pydantic dependency ([0af11ac](https://github.com/openlayer-ai/openlayer-python/commit/0af11ac1a28176380247bf3e3b5db00fe6349593))
+* **internal:** version bump ([55f6ab0](https://github.com/openlayer-ai/openlayer-python/commit/55f6ab040221d31a154ef21c71a1957b77043f79))
+* **internal:** version bump ([3a5c286](https://github.com/openlayer-ai/openlayer-python/commit/3a5c2869c16c0f00e871042af29da29063a70c07))
+* **internal:** version bump ([d5dc8c0](https://github.com/openlayer-ai/openlayer-python/commit/d5dc8c0fd5b792e4a81f6445df0091f1cf9f8e36))
+* **internal:** version bump ([61324d6](https://github.com/openlayer-ai/openlayer-python/commit/61324d655921bbe613cd2542feba4a758d591293))
+* **internal:** version bump ([9db5997](https://github.com/openlayer-ai/openlayer-python/commit/9db5997e6d7648e00c37277ea87b2d5f7e79aa4f))
+* **internal:** version bump ([4659537](https://github.com/openlayer-ai/openlayer-python/commit/465953753d902fd2345cac72e0ed87131668b0f4))
+* **internal:** version bump ([199356c](https://github.com/openlayer-ai/openlayer-python/commit/199356ca1ce8eae57a6557c17d8c173486132fc2))
+* **internal:** version bump ([e63dee5](https://github.com/openlayer-ai/openlayer-python/commit/e63dee5ac27bfc396ec709188a54c3045e1e3698))
+* **package:** drop Python 3.8 support ([4c48617](https://github.com/openlayer-ai/openlayer-python/commit/4c48617ef7c34e0db601617a3b30d3bb540eeea5))
+* **types:** change optional parameter type from NotGiven to Omit ([54c1533](https://github.com/openlayer-ai/openlayer-python/commit/54c1533b6810fcf9323c23f39dc008405fd0a36e))
+
 ## 0.11.4 (2025-12-17)
 
 Full Changelog: [v0.11.3...v0.11.4](https://github.com/openlayer-ai/openlayer-python/compare/v0.11.3...v0.11.4)

README.md

@@ -3,7 +3,7 @@
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/openlayer.svg?label=pypi%20(stable))](https://pypi.org/project/openlayer/)
 
-The Openlayer Python library provides convenient access to the Openlayer REST API from any Python 3.8+
+The Openlayer Python library provides convenient access to the Openlayer REST API from any Python 3.9+
 application. The library includes type definitions for all request params and response fields,
 and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
 
@@ -515,7 +515,7 @@ print(openlayer.__version__)
 
 ## Requirements
 
-Python 3.8 or higher.
+Python 3.9 or higher.
 
 ## Contributing
 

examples/tracing/openai/openai_agents_tracing.ipynb

@@ -177,6 +177,9 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "from __future__ import annotations\n",
+    "\n",
+    "\n",
     "class AirlineAgentContext(BaseModel):\n",
     "    \"\"\"Context model to maintain conversation state across agents.\"\"\"\n",
     "    passenger_name: str | None = None\n",

examples/tracing/openai/openai_tracing.ipynb

@@ -121,6 +121,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "from __future__ import annotations\n",
+    "\n",
     "from pydantic import BaseModel\n",
     "\n",
     "\n",

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openlayer"
-version = "0.11.4"
+version = "0.12.0"
 description = "The official Python library for the openlayer API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -22,11 +22,10 @@ dependencies = [
     "tqdm",
     "wrapt>=1.14.0"
 ]
-requires-python = ">= 3.8"
+requires-python = ">= 3.9"
 classifiers = [
   "Typing :: Typed",
   "Intended Audience :: Developers",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
@@ -46,7 +45,7 @@ Homepage = "https://github.com/openlayer-ai/openlayer-python"
 Repository = "https://github.com/openlayer-ai/openlayer-python"
 
 [project.optional-dependencies]
-aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
+aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.9"]
 
 [tool.rye]
 managed = true
@@ -148,7 +147,7 @@ filterwarnings = [
 # there are a couple of flags that are still disabled by
 # default in strict mode as they are experimental and niche.
 typeCheckingMode = "strict"
-pythonVersion = "3.8"
+pythonVersion = "3.9"
 
 exclude = [
     "_dev",
@@ -233,6 +232,8 @@ select = [
   "B",
   # remove unused imports
   "F401",
+  # check for missing future annotations
+  "FA102",
   # bare except statements
   "E722",
   # unused arguments
@@ -255,6 +256,8 @@ unfixable = [
   "T203",
 ]
 
+extend-safe-fixes = ["FA102"]
+
 [tool.ruff.lint.flake8-tidy-imports.banned-api]
 "functools.lru_cache".msg = "This function does not retain type information for the wrapped function's arguments; The `lru_cache` function from `_utils` should be used instead"
 

requirements-dev.lock

@@ -57,7 +57,7 @@ httpx==0.28.1
     # via httpx-aiohttp
     # via openlayer
     # via respx
-httpx-aiohttp==0.1.8
+httpx-aiohttp==0.1.9
     # via openlayer
 idna==3.4
     # via anyio
@@ -96,11 +96,9 @@ pluggy==1.5.0
 propcache==0.3.2
     # via aiohttp
     # via yarl
-pyarrow==15.0.2
+pydantic==2.11.9
     # via openlayer
-pydantic==2.10.3
-    # via openlayer
-pydantic-core==2.27.1
+pydantic-core==2.33.2
     # via pydantic
 pygments==2.18.0
     # via rich
@@ -146,6 +144,9 @@ typing-extensions==4.12.2
     # via pydantic
     # via pydantic-core
     # via pyright
+    # via typing-inspection
+typing-inspection==0.4.1
+    # via pydantic
 tzdata==2024.1
     # via pandas
 urllib3==2.2.3

requirements.lock

@@ -44,7 +44,7 @@ httpcore==1.0.9
 httpx==0.28.1
     # via httpx-aiohttp
     # via openlayer
-httpx-aiohttp==0.1.8
+httpx-aiohttp==0.1.9
     # via openlayer
 idna==3.4
     # via anyio
@@ -63,11 +63,9 @@ pandas==2.2.2
 propcache==0.3.2
     # via aiohttp
     # via yarl
-pyarrow==15.0.2
+pydantic==2.11.9
     # via openlayer
-pydantic==2.10.3
-    # via openlayer
-pydantic-core==2.27.1
+pydantic-core==2.33.2
     # via pydantic
 python-dateutil==2.9.0.post0
     # via pandas
@@ -92,6 +90,10 @@ typing-extensions==4.12.2
     # via openlayer
     # via pydantic
     # via pydantic-core
+    # via typing-inspection
+typing-inspection==0.4.1
+    # via pydantic
+yarl==1.20.0
 tzdata==2024.1
     # via pandas
 urllib3==2.2.3

scripts/bootstrap

@@ -4,10 +4,18 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-if ! command -v rye >/dev/null 2>&1 && [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ]; then
+if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ] && [ -t 0 ]; then
   brew bundle check >/dev/null 2>&1 || {
-    echo "==> Installing Homebrew dependencies…"
-    brew bundle
+    echo -n "==> Install Homebrew dependencies? (y/N): "
+    read -r response
+    case "$response" in
+      [yY][eE][sS]|[yY])
+        brew bundle
+        ;;
+      *)
+        ;;
+    esac
+    echo
   }
 fi