Python: Add OpenFeature provider

.github/workflows/test.yml

@@ -40,4 +40,31 @@ jobs:
       uses: codecov/codecov-action@1af58845a975a7985b0beb0cbe6fbbb71a41dbad  # v5
       with:
         token: ${{ secrets.CODECOV_TOKEN }}
-        slug: mixpanel/mixpanel-python
+        slug: mixpanel/mixpanel-python
+
+  test-openfeature-provider:
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', 'pypy3.9', 'pypy3.11']
+
+    steps:
+    - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+        pip install -e ./openfeature-provider[test]
+    - name: Run OpenFeature provider tests
+      run: |
+        pytest --cov --cov-branch --cov-report=xml openfeature-provider/tests/
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@1af58845a975a7985b0beb0cbe6fbbb71a41dbad  # v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        slug: mixpanel/mixpanel-python
+        flags: openfeature-provider

mixpanel/flags/local_feature_flags.py

@@ -520,6 +520,10 @@ def _track_exposure(
     async def __aenter__(self):
         return self
 
+    def shutdown(self):
+        self.stop_polling_for_definitions()
+        self._sync_client.close()
+
     def __enter__(self):
         return self
 

mixpanel/flags/remote_feature_flags.py

@@ -343,6 +343,9 @@ def _lookup_flag_in_response(
         )
         return fallback_value, True
 
+    def shutdown(self):
+        self._sync_client.close()
+
     def __enter__(self):
         return self
 

openfeature-provider/RELEASE.md

@@ -0,0 +1,45 @@
+# Releasing the OpenFeature Provider
+
+The OpenFeature provider (`mixpanel-openfeature`) is published to PyPI independently from the core SDK.
+
+## Prerequisites
+
+- Python 3.9+
+- `build` and `twine` packages: `pip install build twine`
+- A PyPI API token with permission to upload to the `mixpanel-openfeature` project
+  - Create one at https://pypi.org/manage/account/token/
+  - For the first upload, you'll need an account-scoped token (project-scoped tokens can only be created after the project exists on PyPI)
+
+## Releasing
+
+1. Update the version in `pyproject.toml`
+
+2. Build the package:
+   ```bash
+   cd openfeature-provider
+   python -m build
+   ```
+
+3. Verify the built artifacts look correct:
+   ```bash
+   ls dist/
+   # Should show: mixpanel_openfeature-<version>-py3-none-any.whl
+   #              mixpanel_openfeature-<version>.tar.gz
+   ```
+
+4. Upload to PyPI:
+   ```bash
+   python -m twine upload dist/*
+   ```
+   Twine will prompt for credentials. Use `__token__` as the username and your API token as the password. Alternatively, configure `~/.pypirc`:
+   ```ini
+   [pypi]
+   username = __token__
+   password = pypi-<your-token>
+   ```
+
+5. Verify at https://pypi.org/project/mixpanel-openfeature/
+
+## Versioning
+
+The OpenFeature provider is versioned independently from the core SDK. The core SDK dependency version is pinned in `pyproject.toml` (`mixpanel>=5.1.0,<6`) — update it when the provider needs features from a newer core SDK release.

openfeature-provider/pyproject.toml

@@ -0,0 +1,98 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mixpanel-openfeature"
+version = "0.1.0"
+description = "OpenFeature provider for the Mixpanel Python SDK"
+license = "Apache-2.0"
+authors = [
+    {name = "Mixpanel, Inc.", email = "dev@mixpanel.com"},
+]
+requires-python = ">=3.9"
+dependencies = [
+    "mixpanel>=5.1.0,<6",
+    "openfeature-sdk>=0.7.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.4.1",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=6.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+# --- Ruff configuration (mirrors main project) ---
+
+[tool.ruff]
+target-version = "py39"
+line-length = 88
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    # --- Rule conflicts ---
+    "D203",    # conflicts with D211 (no-blank-line-before-class)
+    "D213",    # conflicts with D212 (multi-line-summary-first-line)
+    "COM812",  # conflicts with ruff formatter
+    "ISC001",  # conflicts with ruff formatter
+
+    # --- Type annotations (separate effort) ---
+    "ANN",     # all annotation rules
+
+    # --- Docstrings (separate effort) ---
+    "D100",    # undocumented-public-module
+    "D101",    # undocumented-public-class
+    "D102",    # undocumented-public-method
+    "D103",    # undocumented-public-function
+    "D104",    # undocumented-public-package
+    "D105",    # undocumented-magic-method
+    "D107",    # undocumented-public-init
+
+    # --- Boolean arguments (public API) ---
+    "FBT",     # boolean-type-hint / boolean-default / boolean-positional
+
+    # --- TODO/FIXME enforcement ---
+    "TD002",   # missing-todo-author
+    "TD003",   # missing-todo-link
+    "FIX001",  # line-contains-fixme
+    "FIX002",  # line-contains-todo
+
+    # --- Exception message style ---
+    "EM101",   # raw-string-in-exception
+    "EM103",   # dot-format-in-exception
+    "TRY003",  # raise-vanilla-args
+
+    # --- Other pragmatic exclusions ---
+    "PLR0913", # too-many-arguments
+    "PLR0911", # too-many-return-statements (_resolve has many type-check branches)
+    "E501",    # line-too-long (formatter handles code)
+    "FA100",   # future-rewritable-type-annotation
+    "BLE001",  # blind-exception (catching Exception in flag resolution is intentional)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = [
+    "S101",    # assert
+    "S105",    # hardcoded-password-string (test fixtures)
+    "S106",    # hardcoded-password-func-arg
+    "SLF001",  # private-member-access
+    "PLR2004", # magic-value-comparison
+    "D",       # all docstring rules
+    "PT018",   # pytest-composite-assertion
+    "INP001",  # implicit-namespace-package (no __init__.py in tests)
+    "ARG",     # unused arguments (lambda stubs in mocks)
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["mixpanel", "mixpanel_openfeature"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"

openfeature-provider/src/mixpanel_openfeature/__init__.py

@@ -0,0 +1,3 @@
+from .provider import MixpanelProvider
+
+__all__ = ["MixpanelProvider"]