Merge remote-tracking branch 'origin/main' into fork/balgaly/feat/500-context-merging-e2e

Author: gruebel

.github/workflows/build.yml

@@ -17,7 +17,7 @@ permissions:
   contents: read
 
 env:
-  PREK_VERSION: '0.3.x'
+  PREK_VERSION: '0.4.x'
   TARGET_PYTHON_VERSION: "3.14"
 
 jobs:
@@ -33,7 +33,7 @@ jobs:
           submodules: recursive
 
       - name: Install uv and set the python version
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           python-version: ${{ matrix.python-version }}
           activate-environment: true
@@ -49,7 +49,7 @@ jobs:
 
       - if: matrix.python-version == env.TARGET_PYTHON_VERSION
         name: Upload coverage to Codecov
-        uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5.5.1
+        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6.0.1
         with:
           flags: unittests # optional
           name: coverage # optional
@@ -63,7 +63,7 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
       - name: Install uv and set the python version
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           python-version: ${{ env.TARGET_PYTHON_VERSION }}
           ignore-nothing-to-cache: true
@@ -81,7 +81,7 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
       - name: Install uv and set the python version
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           python-version: ${{ env.TARGET_PYTHON_VERSION }}
           ignore-nothing-to-cache: true

.github/workflows/release.yml

@@ -24,13 +24,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: googleapis/release-please-action@db8f2c60ee802b3748b512940dde88eabd7b7e01 # v3
+      - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5
         id: release
         with:
-          command: manifest
           token: ${{secrets.RELEASE_PLEASE_ACTION_TOKEN}}
-          default-branch: main
-          signoff: "OpenFeature Bot <109696520+openfeaturebot@users.noreply.github.com>"
+          target-branch: main
     outputs:
       release_created: ${{ steps.release.outputs.release_created }}
       release_tag_name: ${{ steps.release.outputs.tag_name }}
@@ -48,7 +46,7 @@ jobs:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Install uv and set the python version
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           python-version: ${{ env.TARGET_PYTHON_VERSION }}
 

.pre-commit-config.yaml

@@ -1,7 +1,7 @@
 default_stages: [pre-commit]
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.7
+    rev: v0.15.15
     hooks:
       - id: ruff-check
         priority: 1
@@ -22,13 +22,14 @@ repos:
         priority: 0
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.20.0
+    rev: v2.21.2
     hooks:
       - id: pyproject-fmt
         priority: 0
+        additional_dependencies: [toml-fmt-common<1.3.3] # removed after fix https://github.com/tox-dev/toml-fmt/issues/355
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.20.0
+    rev: v2.1.0
     hooks:
       - id: mypy
         priority: 1

.release-please-manifest.json

@@ -1 +1 @@
-{".":"0.8.4"}
+{".":"0.10.0"}

CHANGELOG.md

@@ -1,5 +1,88 @@
 # Changelog
 
+## [0.10.0](https://github.com/open-feature/python-sdk/compare/v0.9.0...v0.10.0) (2026-06-01)
+
+
+### ⚠ BREAKING CHANGES
+
+* make set_provider non-blocking, add set_provider_and_wait ([#595](https://github.com/open-feature/python-sdk/issues/595))
+
+> [!IMPORTANT]
+> `set_provider()` no longer blocks until the provider is ready; provider initialization runs in the background. If your workload needs to wait until the `PROVIDER_READY` event has fired before proceeding (for example, to avoid `PROVIDER_NOT_READY` evaluations during startup), use `set_provider_and_wait()` instead.
+
+### 🐛 Bug Fixes
+
+* isolate provider event handler dispatch ([#599](https://github.com/open-feature/python-sdk/issues/599)) ([0a96426](https://github.com/open-feature/python-sdk/commit/0a96426a3e1df497f376c08a499cfa9227c7e2c2))
+
+
+### ✨ New Features
+
+* make set_provider non-blocking, add set_provider_and_wait ([#595](https://github.com/open-feature/python-sdk/issues/595)) ([cbacef0](https://github.com/open-feature/python-sdk/commit/cbacef0093c0ef44bc2ba8ad36de1c5497cf0cff))
+
+
+### 🧹 Chore
+
+* **deps:** update astral-sh/setup-uv action to v8 ([#603](https://github.com/open-feature/python-sdk/issues/603)) ([4422fad](https://github.com/open-feature/python-sdk/commit/4422fad635199d11bfd820425bf8938a68cec1ee))
+* **deps:** update codecov/codecov-action action to v6 ([#604](https://github.com/open-feature/python-sdk/issues/604)) ([e00fab3](https://github.com/open-feature/python-sdk/commit/e00fab3f04d52b3d35258d87c68e3c8d3954af31))
+* **deps:** update dependency prek to >=0.4.3,<0.5.0 ([#607](https://github.com/open-feature/python-sdk/issues/607)) ([760d808](https://github.com/open-feature/python-sdk/commit/760d808009e4eddd2984723d8bb3e3382df180ec))
+* **deps:** update googleapis/release-please-action action to v5 ([#605](https://github.com/open-feature/python-sdk/issues/605)) ([aa1366a](https://github.com/open-feature/python-sdk/commit/aa1366abeccf8d4463e933fbba035891e0531125))
+* **deps:** update pre-commit hook astral-sh/ruff-pre-commit to v0.15.15 ([#608](https://github.com/open-feature/python-sdk/issues/608)) ([5f4e42d](https://github.com/open-feature/python-sdk/commit/5f4e42dee5fad734a39b459b08b94045a7210ec3))
+* **deps:** update pre-commit hook pre-commit/mirrors-mypy to v2 ([#606](https://github.com/open-feature/python-sdk/issues/606)) ([d18beef](https://github.com/open-feature/python-sdk/commit/d18beefeaebb717102c40b02acbedf6b3c0c16a8))
+* **deps:** update pre-commit hook tox-dev/pyproject-fmt to v2.21.2 ([#601](https://github.com/open-feature/python-sdk/issues/601)) ([5cc9534](https://github.com/open-feature/python-sdk/commit/5cc9534661a1901c5d3a0b328d65df6495c46b92))
+
+## [0.9.0](https://github.com/open-feature/python-sdk/compare/v0.8.4...v0.9.0) (2026-04-17)
+
+
+### ⚠ BREAKING CHANGES
+
+* remove deprecated openfeature.provider.provider module ([#558](https://github.com/open-feature/python-sdk/issues/558))
+* Drop python 3.9 support ([#554](https://github.com/open-feature/python-sdk/issues/554))
+
+### 🐛 Bug Fixes
+
+* correctly reset api state on shutdown ([#589](https://github.com/open-feature/python-sdk/issues/589)) ([eaa195b](https://github.com/open-feature/python-sdk/commit/eaa195b1761101a04c767ffbd235d809c9f724ca))
+* Prevent providers from being initialized multiple times ([45f7fd1](https://github.com/open-feature/python-sdk/commit/45f7fd1fd3dd39240282e23bf0ce587435f3ff2f))
+* Prevent providers from being shutdown multiple times ([45f7fd1](https://github.com/open-feature/python-sdk/commit/45f7fd1fd3dd39240282e23bf0ce587435f3ff2f))
+* replace project.scripts with poethepoet ([#563](https://github.com/open-feature/python-sdk/issues/563)) ([05382aa](https://github.com/open-feature/python-sdk/commit/05382aad368800d593209ece7966045b9daf9756))
+* validate domain is present when calling `set_provider` on registry ([#561](https://github.com/open-feature/python-sdk/issues/561)) ([9fc6121](https://github.com/open-feature/python-sdk/commit/9fc612180a3ea8d26820394b329abd24804d2df4))
+
+
+### ✨ New Features
+
+* add logging hook ([#577](https://github.com/open-feature/python-sdk/issues/577)) ([ae59756](https://github.com/open-feature/python-sdk/commit/ae59756109f39f4a0d0551cdd80aeaa5aaada571))
+* Drop python 3.9 support ([04106f5](https://github.com/open-feature/python-sdk/commit/04106f532d3a92d9dd70fd2160a07672ca4404f8))
+* Implement tracking ([#564](https://github.com/open-feature/python-sdk/issues/564)) ([b81ee21](https://github.com/open-feature/python-sdk/commit/b81ee21c5bda6408bf41be5f22f4c5f7b280dfee))
+
+
+### 🧹 Chore
+
+* add pyproject-fmt hook ([#578](https://github.com/open-feature/python-sdk/issues/578)) ([fafd902](https://github.com/open-feature/python-sdk/commit/fafd9023c7c1c82656b5af99c998124e88160fdf))
+* **deps:** pin pypa/gh-action-pypi-publish action to ed0c539 ([#582](https://github.com/open-feature/python-sdk/issues/582)) ([c7ada5a](https://github.com/open-feature/python-sdk/commit/c7ada5a13eab9efcff93de7dbf4c3d8291407599))
+* **deps:** update actions/checkout digest to de0fac2 ([#572](https://github.com/open-feature/python-sdk/issues/572)) ([e9dfeac](https://github.com/open-feature/python-sdk/commit/e9dfeac1e696ec038af3b62ed5a6bb6d11453696))
+* **deps:** update astral-sh/setup-uv digest to 37802ad ([#581](https://github.com/open-feature/python-sdk/issues/581)) ([ddb8fd1](https://github.com/open-feature/python-sdk/commit/ddb8fd1296714f4849c821db90d0832337d1f9bb))
+* **deps:** update astral-sh/setup-uv digest to e06108d ([#573](https://github.com/open-feature/python-sdk/issues/573)) ([c35a1e5](https://github.com/open-feature/python-sdk/commit/c35a1e5664613da36e1264ec348b540e1aa0c8da))
+* **deps:** update dependency uv_build to ~=0.10.0 ([#571](https://github.com/open-feature/python-sdk/issues/571)) ([a6366e2](https://github.com/open-feature/python-sdk/commit/a6366e21c41f1c7560ca245840ece09f31c6938e))
+* **deps:** update github/codeql-action digest to 0d579ff ([#574](https://github.com/open-feature/python-sdk/issues/574)) ([0696033](https://github.com/open-feature/python-sdk/commit/0696033b30788bed6d7e0c0360192c2913f130cd))
+* **deps:** update github/codeql-action digest to c10b806 ([#583](https://github.com/open-feature/python-sdk/issues/583)) ([9478ea0](https://github.com/open-feature/python-sdk/commit/9478ea0c0188a997e7396083e9d9b6983604985a))
+* **deps:** update pre-commit hook astral-sh/ruff-pre-commit to v0.15.6 ([#575](https://github.com/open-feature/python-sdk/issues/575)) ([d0d7d8f](https://github.com/open-feature/python-sdk/commit/d0d7d8f6a2c83cf9488cb2185ebb2cb9cc32fbfe))
+* **deps:** update pre-commit hook pre-commit/mirrors-mypy to v1.19.1 ([#576](https://github.com/open-feature/python-sdk/issues/576)) ([ade3870](https://github.com/open-feature/python-sdk/commit/ade3870dcd734722df357a11771bfc584f128093))
+* **deps:** update pre-commit hook pre-commit/mirrors-mypy to v1.20.0 ([#588](https://github.com/open-feature/python-sdk/issues/588)) ([398d140](https://github.com/open-feature/python-sdk/commit/398d140883b9a16e866fc820d49442af1a5b7e69))
+* Drop python 3.9 support ([#554](https://github.com/open-feature/python-sdk/issues/554)) ([04106f5](https://github.com/open-feature/python-sdk/commit/04106f532d3a92d9dd70fd2160a07672ca4404f8))
+* replace pre-commit with prek ([#580](https://github.com/open-feature/python-sdk/issues/580)) ([d1e0cde](https://github.com/open-feature/python-sdk/commit/d1e0cdee150bebd63ea74cda917df44846c016c3))
+* update pytest to v9 ([#559](https://github.com/open-feature/python-sdk/issues/559)) ([71ebb9f](https://github.com/open-feature/python-sdk/commit/71ebb9fe961acb2ed256f12695123864fcf69cd5))
+* update uv to 0.11 and relax version requirement ([#587](https://github.com/open-feature/python-sdk/issues/587)) ([7d9229f](https://github.com/open-feature/python-sdk/commit/7d9229fd4f039ccd94b2a8a7ebfc0c4f0476294d))
+
+
+### 📚 Documentation
+
+* fix inaccuracies in README code examples ([#592](https://github.com/open-feature/python-sdk/issues/592)) ([17d62c4](https://github.com/open-feature/python-sdk/commit/17d62c4946c81985577b0372e6a6344b7b13470d))
+
+
+### 🔄 Refactoring
+
+* Delete provider status instead of marking as NOT_READY ([45f7fd1](https://github.com/open-feature/python-sdk/commit/45f7fd1fd3dd39240282e23bf0ce587435f3ff2f))
+* remove deprecated openfeature.provider.provider module ([#558](https://github.com/open-feature/python-sdk/issues/558)) ([7c27c7a](https://github.com/open-feature/python-sdk/commit/7c27c7ae58ab498fdc85ab508a76f7d5261f02f1))
+
 ## [0.8.4](https://github.com/open-feature/python-sdk/compare/v0.8.3...v0.8.4) (2025-12-08)
 
 

README.md

@@ -19,8 +19,8 @@
 
   <!-- x-release-please-start-version -->
 
-  <a href="https://github.com/open-feature/python-sdk/releases/tag/v0.8.4">
-    <img alt="Latest version" src="https://img.shields.io/static/v1?label=release&message=v0.8.4&color=blue&style=for-the-badge" />
+  <a href="https://github.com/open-feature/python-sdk/releases/tag/v0.10.0">
+    <img alt="Latest version" src="https://img.shields.io/static/v1?label=release&message=v0.10.0&color=blue&style=for-the-badge" />
   </a>
 
   <!-- x-release-please-end -->
@@ -60,13 +60,13 @@
 #### Pip install
 
 ```bash
-pip install openfeature-sdk==0.8.4
+pip install openfeature-sdk==0.10.0
 ```
 
 #### requirements.txt
 
 ```bash
-openfeature-sdk==0.8.4
+openfeature-sdk==0.10.0
 ```
 
 ```python
@@ -130,6 +130,15 @@ api.set_provider(NoOpProvider())
 open_feature_client = api.get_client()
 ```
 
+`set_provider()` is non-blocking: it registers the provider immediately and runs initialization in a background thread.
+Flag evaluations during the initialization window return the default value with a `PROVIDER_NOT_READY` error code.
+Use `set_provider_and_wait()` if you need to ensure the provider is ready before proceeding:
+
+```python
+# blocks until the provider is initialized (or raises on failure)
+api.set_provider_and_wait(NoOpProvider())
+```
+
 In some situations, it may be beneficial to register multiple providers in the same application.
 This is possible using [domains](#domains), which is covered in more detail below.
 
@@ -142,11 +151,11 @@ If the flag management system you're using supports targeting, you can provide t
 ```python
 from openfeature.api import (
     get_client,
-    get_provider,
     set_provider,
     get_evaluation_context,
     set_evaluation_context,
 )
+from openfeature.evaluation_context import EvaluationContext
 
 global_context = EvaluationContext(
     targeting_key="targeting_key1", attributes={"application": "value1"}
@@ -159,7 +168,7 @@ request_context = EvaluationContext(
 set_evaluation_context(global_context)
 
 # merge second context
-client = get_client(name="No-op Provider")
+client = get_client(domain="No-op Provider")
 client.get_string_value("email", "fallback", request_context)
 ```
 
@@ -172,19 +181,20 @@ If the hook you're looking for hasn't been created yet, see the [develop a hook]
 Once you've added a hook as a dependency, it can be registered at the global, client, or flag invocation level.
 
 ```python
+from openfeature import api
 from openfeature.api import add_hooks
 from openfeature.flag_evaluation import FlagEvaluationOptions
 
 # set global hooks at the API-level
 add_hooks([MyHook()])
 
 # or configure them in the client
-client = OpenFeatureClient()
+client = api.get_client()
 client.add_hooks([MyHook()])
 
 # or at the invocation-level
 options = FlagEvaluationOptions(hooks=[MyHook()])
-client.get_boolean_flag("my-flag", False, flag_evaluation_options=options)
+client.get_boolean_value("my-flag", False, flag_evaluation_options=options)
 ```
 ### Tracking
 
@@ -254,7 +264,7 @@ Please refer to the documentation of the provider you're using to see what event
 
 ```python
 from openfeature import api
-from openfeature.provider import ProviderEvent
+from openfeature.event import EventDetails, ProviderEvent
 
 def on_provider_ready(event_details: EventDetails):
     print(f"Provider {event_details.provider_name} is ready")
@@ -503,10 +513,11 @@ Implement your own hook by creating a hook that inherits from the `Hook` class.
 Any of the evaluation life-cycle stages (`before`/`after`/`error`/`finally_after`) can be override to add the desired business logic.
 
 ```python
-from openfeature.hook import Hook
+from openfeature.hook import Hook, HookContext, HookHints
+from openfeature.flag_evaluation import FlagEvaluationDetails, FlagValueType
 
 class MyHook(Hook):
-    def after(self, hook_context: HookContext, details: FlagEvaluationDetails, hints: dict):
+    def after(self, hook_context: HookContext, details: FlagEvaluationDetails[FlagValueType], hints: HookHints):
         print("This runs after the flag has been evaluated")
 
 ```

openfeature/_event_support.py

@@ -1,8 +1,11 @@
 from __future__ import annotations
 
+import atexit
 import threading
 import typing
 from collections import defaultdict
+from concurrent.futures import ThreadPoolExecutor
+from logging import getLogger
 
 from openfeature.event import (
     EventDetails,
@@ -16,6 +19,10 @@
     from openfeature.client import OpenFeatureClient
 
 
+logger = getLogger("openfeature")
+_event_executor = ThreadPoolExecutor(thread_name_prefix="openfeature-event-handler")
+atexit.register(_event_executor.shutdown, wait=True)
+
 _global_lock = threading.RLock()
 _global_handlers: dict[ProviderEvent, list[EventHandler]] = defaultdict(list)
 
@@ -29,14 +36,22 @@ def run_client_handlers(
     client: OpenFeatureClient, event: ProviderEvent, details: EventDetails
 ) -> None:
     with _client_lock:
-        for handler in _client_handlers[client][event]:
-            handler(details)
+        handlers_by_event = _client_handlers.get(client)
+        if handlers_by_event is None:
+            return
+
+        handlers = tuple(handlers_by_event.get(event, ()))
+
+    for handler in handlers:
+        _submit_handler(handler, details)
 
 
 def run_global_handlers(event: ProviderEvent, details: EventDetails) -> None:
     with _global_lock:
-        for handler in _global_handlers[event]:
-            handler(details)
+        handlers = tuple(_global_handlers.get(event, ()))
+
+    for handler in handlers:
+        _submit_handler(handler, details)
 
 
 def add_client_handler(
@@ -83,9 +98,12 @@ def run_handlers_for_provider(
     run_global_handlers(event, details)
     # run the handlers for clients associated to this provider
     with _client_lock:
-        for client in _client_handlers:
-            if client.provider == provider:
-                run_client_handlers(client, event, details)
+        clients = tuple(
+            client for client in _client_handlers if client.provider == provider
+        )
+
+    for client in clients:
+        run_client_handlers(client, event, details)
 
 
 def _run_immediate_handler(
@@ -98,7 +116,20 @@ def _run_immediate_handler(
         ProviderStatus.STALE: ProviderEvent.PROVIDER_STALE,
     }
     if event == status_to_event.get(client.get_provider_status()):
-        handler(EventDetails(provider_name=client.provider.get_metadata().name))
+        _submit_handler(
+            handler, EventDetails(provider_name=client.provider.get_metadata().name)
+        )
+
+
+def _submit_handler(handler: EventHandler, details: EventDetails) -> None:
+    _event_executor.submit(_run_handler, handler, details)
+
+
+def _run_handler(handler: EventHandler, details: EventDetails) -> None:
+    try:
+        handler(details)
+    except Exception:
+        logger.exception("Unhandled exception in OpenFeature event handler")
 
 
 def clear() -> None: