gofeatureflag-python-provider 0.4.4__tar.gz → 1.0.0__tar.gz

gofeatureflag_python_provider-1.0.0/.gitignore

@@ -0,0 +1,161 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# uv
+#   uv.lock is recommended to be included in version control for reproducibility.
+#   https://docs.astral.sh/uv/concepts/projects/layout/#the-lockfile
+#uv.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+./gofeatureflag_python_provider/wasm/_wasi_version.txt
+./gofeatureflag_python_provider/wasm/gofeatureflag-evaluation_*.wasi

gofeatureflag_python_provider-1.0.0/AGENTS.md

@@ -0,0 +1,148 @@
+# GO Feature Flag Python Provider
+
+OpenFeature Python provider for [GO Feature Flag](https://gofeatureflag.org).
+
+## Project Overview
+
+This is a Python package that implements the OpenFeature provider interface to connect to a GO Feature Flag relay proxy. It enables Python applications to evaluate feature flags using the OpenFeature SDK.
+
+## Architecture
+
+```
+gofeatureflag_python_provider/
+├── __init__.py                 # Package exports
+├── provider.py                 # Main GoFeatureFlagProvider class (AbstractProvider implementation)
+├── options.py                  # GoFeatureFlagOptions configuration class
+├── hooks/                      # OpenFeature hooks
+│   ├── __init__.py
+│   ├── data_collector.py       # Hook for collecting flag evaluation usage data
+│   └── enrich_evaluation_context.py  # Hook that adds gofeatureflag metadata to context before evaluation
+├── metadata.py                 # Provider metadata
+├── request_data_collector.py   # Data models for usage collection
+├── request_flag_evaluation.py  # Request models for flag evaluation API calls
+└── response_flag_evaluation.py # Response models for flag evaluation API calls
+
+tests/
+├── test_gofeatureflag_python_provider.py  # Main provider tests
+├── test_enrich_evaluation_context_hook.py # EnrichEvaluationContextHook tests
+├── test_provider_graceful_exit.py         # Shutdown/cleanup tests
+├── test_websocket_cache_invalidation.py   # WebSocket cache invalidation tests
+├── mock_responses/                        # JSON mock responses for testing
+├── config.goff.yaml                       # Test flag configuration
+└── docker-compose.yml                     # Test infrastructure
+```
+
+## Key Components
+
+### GoFeatureFlagProvider (`provider.py`)
+- Extends `AbstractProvider` from OpenFeature SDK
+- Implements all resolve methods: `resolve_boolean_details`, `resolve_string_details`, `resolve_integer_details`, `resolve_float_details`, `resolve_object_details`
+- Uses `generic_go_feature_flag_resolver` for all flag types
+- Features:
+  - LRU cache for flag evaluations (`pylru`)
+  - WebSocket connection for cache invalidation
+  - Data collection for usage analytics
+
+### GoFeatureFlagOptions (`options.py`)
+Configuration options:
+- `endpoint` (required): URL of the GO Feature Flag relay proxy
+- `cache_size`: Max cached flags (default: 10000)
+- `data_flush_interval`: Interval to flush usage data in ms (default: 60000)
+- `disable_data_collection`: Turn off usage tracking (default: false)
+- `reconnect_interval`: WebSocket reconnect interval in seconds (default: 60)
+- `disable_cache_invalidation`: Disable WebSocket cache invalidation (default: false)
+- `api_key`: API key for authenticated requests
+- `exporter_metadata`: Custom metadata for evaluation events
+- `debug`: Enable debug logging (default: false)
+- `urllib3_pool_manager`: Custom HTTP client
+
+### DataCollectorHook (`hooks/data_collector.py`)
+- OpenFeature Hook implementation for collecting usage data
+- Tracks flag evaluations via `after()` and `error()` hooks
+- Flushes data to `/v1/data/collector` endpoint periodically
+
+### EnrichEvaluationContextHook (`hooks/enrich_evaluation_context.py`)
+- Enriches the evaluation context with a `gofeatureflag` attribute (from `exporter_metadata`) before flag resolution
+- Used by the relay proxy for analytics or filtering; registered automatically by the provider
+
+## Development
+
+### Prerequisites
+- Python 3.9+
+- uv (package manager)
+
+### Setup
+```bash
+# Install dependencies
+uv sync
+
+# Run a command in the virtual environment
+uv run <command>
+```
+
+### Running Tests
+```bash
+# Run all tests
+uv run pytest
+
+# Run specific test file
+uv run pytest tests/test_gofeatureflag_python_provider.py
+
+# Run with verbose output
+uv run pytest -v
+```
+
+### Code Style
+```bash
+# Format code with black
+uv run black gofeatureflag_python_provider tests
+```
+
+## Key Patterns
+
+### Pydantic Models
+- All data classes extend Pydantic `BaseModel` for validation
+- Request/response models use `model_dump_json()` for serialization
+- Use `model_validate_json()` for deserialization
+
+### HTTP Communication
+- Uses `urllib3.PoolManager` for HTTP requests
+- POST to `/v1/feature/{flag_key}/eval` for flag evaluation
+- POST to `/v1/data/collector` for usage data
+- WebSocket at `/ws/v1/flag/change` for cache invalidation
+
+### Caching Strategy
+- LRU cache keyed by `{flag_key}:{evaluation_context_hash()}`
+- Cache cleared on WebSocket message (flag config changed)
+- Set `cacheable` field in response determines if result is cached
+
+### Error Handling
+- `FlagNotFoundError`: Flag doesn't exist (404)
+- `InvalidContextError`: Invalid evaluation context (400)
+- `TypeMismatchError`: Response type doesn't match expected type
+- `GeneralError`: Other errors (500+)
+
+## API Reference
+
+The provider communicates with the GO Feature Flag relay proxy:
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/v1/feature/{flag}/eval` | POST | Evaluate a flag |
+| `/v1/data/collector` | POST | Send usage data |
+| `/ws/v1/flag/change` | WebSocket | Cache invalidation notifications |
+
+## Dependencies
+
+Core:
+- `openfeature-sdk`: OpenFeature Python SDK
+- `pydantic`: Data validation
+- `urllib3`: HTTP client
+- `pylru`: LRU cache implementation
+- `websocket-client`: WebSocket support
+- `rel`: WebSocket reconnection handling
+
+Dev:
+- `pytest`: Testing framework
+- `black`: Code formatter
+- `pytest-docker`: Docker-based integration tests

gofeatureflag_python_provider-1.0.0/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+## [1.0.0](https://github.com/thomaspoignant/go-feature-flag/compare/openfeature/providers/python-provider/v0.5.0...openfeature/providers/python-provider/v1.0.0) (2026-03-31)
+
+
+### ⚠ BREAKING CHANGES
+
+* **python:** New python provider with inprocess support ([#4861](https://github.com/thomaspoignant/go-feature-flag/issues/4861))
+
+### 🚀 New Features
+
+* **python:** New python provider with inprocess support ([#4861](https://github.com/thomaspoignant/go-feature-flag/issues/4861)) ([d67c24b](https://github.com/thomaspoignant/go-feature-flag/commit/d67c24b3f5969a7d3ec5a2cd893d6094e3534152))
+
+
+### 🔧 Chores
+
+* Bump github.com/aws/aws-sdk-go-v2/service/s3 ([#4613](https://github.com/thomaspoignant/go-feature-flag/issues/4613)) ([a8e9b13](https://github.com/thomaspoignant/go-feature-flag/commit/a8e9b136eb972da636726525bffc1c2f86fcb432))
+* Bump go.opentelemetry.io/otel/sdk from 1.41.0 to 1.42.0 ([#4944](https://github.com/thomaspoignant/go-feature-flag/issues/4944)) ([ede0c19](https://github.com/thomaspoignant/go-feature-flag/commit/ede0c19d7452e55e9b8e27d1c929da9c0492a82a))
+* Bump rel in /openfeature/providers/python-provider ([#4816](https://github.com/thomaspoignant/go-feature-flag/issues/4816)) ([abed2fc](https://github.com/thomaspoignant/go-feature-flag/commit/abed2fc066214042bf6002b988de6c32b7288873))
+* Bump urllib3 in /openfeature/providers/python-provider ([#4605](https://github.com/thomaspoignant/go-feature-flag/issues/4605)) ([3d97b25](https://github.com/thomaspoignant/go-feature-flag/commit/3d97b256978c7f74f7e1a3eec229f6db553892ec))
+
+## [0.5.0](https://github.com/thomaspoignant/go-feature-flag/compare/openfeature/providers/python-provider/v0.5.0...openfeature/providers/python-provider/v0.5.0) (2025-10-26)
+
+
+### 🚀 New Features
+
+* Python Provider Graceful Exit ([#4106](https://github.com/thomaspoignant/go-feature-flag/issues/4106)) ([b48cc0c](https://github.com/thomaspoignant/go-feature-flag/commit/b48cc0c0d3874e002eea174192251e0564540512))
+
+
+### 🔧 Chores
+
+* Bump pydantic in /openfeature/providers/python-provider ([#4050](https://github.com/thomaspoignant/go-feature-flag/issues/4050)) ([d4ea37f](https://github.com/thomaspoignant/go-feature-flag/commit/d4ea37fa7d3d91742acd75e246563699bb71b287))
+* Bump pydantic in /openfeature/providers/python-provider ([#4120](https://github.com/thomaspoignant/go-feature-flag/issues/4120)) ([beda91c](https://github.com/thomaspoignant/go-feature-flag/commit/beda91cbbc0369c38c71178b92ab13f1103e83a6))
+* Bump websocket-client in /openfeature/providers/python-provider ([#4053](https://github.com/thomaspoignant/go-feature-flag/issues/4053)) ([4147232](https://github.com/thomaspoignant/go-feature-flag/commit/4147232126e8f6af5a03a90001d07177ba1e60a8))
+* **main:** release openfeature/providers/python-provider 0.5.0 ([#4065](https://github.com/thomaspoignant/go-feature-flag/issues/4065)) ([fb0d9ba](https://github.com/thomaspoignant/go-feature-flag/commit/fb0d9babaeae8fc4721c6bcd9a566d8c6e5502a9))
+* Release python as v0.5.0 ([#4142](https://github.com/thomaspoignant/go-feature-flag/issues/4142)) ([0c1508a](https://github.com/thomaspoignant/go-feature-flag/commit/0c1508a7bc466be35d18f3026668f0896f8fa55e))
+
+## [0.5.0](https://github.com/thomaspoignant/go-feature-flag/compare/openfeature/providers/python-provider/v0.4.4...openfeature/providers/python-provider/v0.5.0) (2025-10-26)
+
+
+### 🚀 New Features
+
+* Python Provider Graceful Exit ([#4106](https://github.com/thomaspoignant/go-feature-flag/issues/4106)) ([b48cc0c](https://github.com/thomaspoignant/go-feature-flag/commit/b48cc0c0d3874e002eea174192251e0564540512))
+
+
+### 🔧 Chores
+
+* Bump pydantic in /openfeature/providers/python-provider ([#4050](https://github.com/thomaspoignant/go-feature-flag/issues/4050)) ([d4ea37f](https://github.com/thomaspoignant/go-feature-flag/commit/d4ea37fa7d3d91742acd75e246563699bb71b287))
+* Bump pydantic in /openfeature/providers/python-provider ([#4120](https://github.com/thomaspoignant/go-feature-flag/issues/4120)) ([beda91c](https://github.com/thomaspoignant/go-feature-flag/commit/beda91cbbc0369c38c71178b92ab13f1103e83a6))
+* Bump websocket-client in /openfeature/providers/python-provider ([#4053](https://github.com/thomaspoignant/go-feature-flag/issues/4053)) ([4147232](https://github.com/thomaspoignant/go-feature-flag/commit/4147232126e8f6af5a03a90001d07177ba1e60a8))

gofeatureflag_python_provider-1.0.0/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

{gofeatureflag_python_provider-0.4.4 → gofeatureflag_python_provider-1.0.0}/PKG-INFO

@@ -1,36 +1,26 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: gofeatureflag-python-provider
-Version: 0.4.4
+Version: 1.0.0
 Summary: GO Feature Flag provider for OpenFeature
-License: Apache-2.0
-Keywords: feature flags,feature toggles,go-feature-flag,gofeatureflag,openfeature,open-feature
+Project-URL: Bug Tracker, https://github.com/thomaspoignant/go-feature-flag/issues
+Project-URL: Source Code, https://github.com/thomaspoignant/go-feature-flag/tree/main/openfeature/providers/python-provider
+Project-URL: Documentation, https://github.com/thomaspoignant/go-feature-flag/tree/main/openfeature/providers/python-provider
 Author: Thomas Poignant
-Requires-Python: >=3.9,<4.0
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
+License-Expression: Apache-2.0
+Keywords: feature flags,feature toggles,go-feature-flag,gofeatureflag,open-feature,openfeature
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: openfeature-sdk (>=0.5.0,<0.9.0)
-Requires-Dist: pydantic (>=2.5.2,<3.0.0)
-Requires-Dist: pylru (>=1.2.1,<2.0.0)
-Requires-Dist: rel (>=0.4.9,<0.5.0)
-Requires-Dist: urllib3 (>=2.1.0,<3.0.0)
-Requires-Dist: websocket-client (>=1.6.4,<2.0.0)
-Project-URL: Bug Tracker, https://github.com/thomaspoignant/go-feature-flag/issues
-Project-URL: Documentation, https://github.com/thomaspoignant/go-feature-flag/tree/main/openfeature/providers/python-provider
-Project-URL: Homepage, https://gofeatureflag.org
-Project-URL: Repository, https://github.com/thomaspoignant/go-feature-flag
-Project-URL: Source Code, https://github.com/thomaspoignant/go-feature-flag/tree/main/openfeature/providers/python-provider
+Requires-Python: >=3.9
+Requires-Dist: openfeature-provider-ofrep>=0.2.0
+Requires-Dist: openfeature-sdk<0.9.0,>=0.8.4
+Requires-Dist: pydantic>=2.5.2
+Requires-Dist: urllib3>=2.1.0
+Requires-Dist: wasmtime>=41.0.0
 Description-Content-Type: text/markdown
 
 # GO Feature Flag Python Provider
 
-GO Feature Flag provider allows you to connect to your GO Feature Flag instance.  
+GO Feature Flag provider allows you to connect to your GO Feature Flag instance.
 
 [GO Feature Flag](https://gofeatureflag.org) believes in simplicity and offers a simple and lightweight solution to use feature flags.  
 Our focus is to avoid any complex infrastructure work to use GO Feature Flag.
@@ -71,9 +61,8 @@ client = api.get_client(domain="test-client")
 
 This code block explains how you can create an `EvaluationContext` and use it to evaluate your flag.
 
-
 > In this example we are evaluating a `boolean` flag, but other types are available.
-> 
+>
 > **Refer to the [Open Feature documentation](https://docs.openfeature.dev/docs/reference/concepts/evaluation-api#basic-evaluation) to know more about it.**
 
 ```python
@@ -99,10 +88,9 @@ admin_flag = client.get_boolean_value(
           default_value=default_value,
           evaluation_context=ctx,
       )
-      
+
 if admin_flag:
   # flag "flag-only-for-admin" is true for the user
 else:
   # flag "flag-only-for-admin" is false for the user
 ```
-

{gofeatureflag_python_provider-0.4.4 → gofeatureflag_python_provider-1.0.0}/README.md

@@ -1,6 +1,6 @@
 # GO Feature Flag Python Provider
 
-GO Feature Flag provider allows you to connect to your GO Feature Flag instance.  
+GO Feature Flag provider allows you to connect to your GO Feature Flag instance.
 
 [GO Feature Flag](https://gofeatureflag.org) believes in simplicity and offers a simple and lightweight solution to use feature flags.  
 Our focus is to avoid any complex infrastructure work to use GO Feature Flag.
@@ -41,9 +41,8 @@ client = api.get_client(domain="test-client")
 
 This code block explains how you can create an `EvaluationContext` and use it to evaluate your flag.
 
-
 > In this example we are evaluating a `boolean` flag, but other types are available.
-> 
+>
 > **Refer to the [Open Feature documentation](https://docs.openfeature.dev/docs/reference/concepts/evaluation-api#basic-evaluation) to know more about it.**
 
 ```python
@@ -69,7 +68,7 @@ admin_flag = client.get_boolean_value(
           default_value=default_value,
           evaluation_context=ctx,
       )
-      
+
 if admin_flag:
   # flag "flag-only-for-admin" is true for the user
 else:

gofeatureflag_python_provider-1.0.0/gofeatureflag_python_provider/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

gofeatureflag_python_provider-1.0.0/gofeatureflag_python_provider/evaluator/__init__.py

@@ -0,0 +1,17 @@
+"""
+Evaluator implementations for GO Feature Flag provider.
+
+Selects remote (relay proxy) or inprocess (local/WASM) evaluation based on options.
+"""
+
+from gofeatureflag_python_provider.evaluator.abstract_evaluator import AbstractEvaluator
+from gofeatureflag_python_provider.evaluator.inprocess_evaluator import (
+    InProcessEvaluator,
+)
+from gofeatureflag_python_provider.evaluator.remote_evaluator import RemoteEvaluator
+
+__all__ = [
+    "AbstractEvaluator",
+    "InProcessEvaluator",
+    "RemoteEvaluator",
+]

gofeatureflag_python_provider-1.0.0/gofeatureflag_python_provider/evaluator/abstract_evaluator.py

@@ -0,0 +1,136 @@
+"""
+Abstract interface for flag evaluation.
+
+Implementations: RemoteEvaluator (relay proxy), InProcessEvaluator (local/WASM).
+"""
+
+from abc import ABC, abstractmethod
+from typing import Optional, Union
+
+from openfeature.evaluation_context import EvaluationContext
+from openfeature.flag_evaluation import FlagResolutionDetails
+
+
+class AbstractEvaluator(ABC):
+    """Interface for evaluating feature flags (remote or in-process)."""
+
+    @abstractmethod
+    def initialize(
+        self, evaluation_context: Optional[EvaluationContext] = None
+    ) -> None:
+        """Initialize the evaluator (e.g. cache, WebSocket, WASM)."""
+        ...
+
+    @abstractmethod
+    def shutdown(self) -> None:
+        """Release resources (connections, threads, etc.)."""
+        ...
+
+    # --- Sync evaluation ---
+
+    @abstractmethod
+    def resolve_boolean_details(
+        self,
+        flag_key: str,
+        default_value: bool,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[bool]:
+        """Resolve the flag as a boolean."""
+        ...
+
+    @abstractmethod
+    def resolve_string_details(
+        self,
+        flag_key: str,
+        default_value: str,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[str]:
+        """Resolve the flag as a string."""
+        ...
+
+    @abstractmethod
+    def resolve_integer_details(
+        self,
+        flag_key: str,
+        default_value: int,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[int]:
+        """Resolve the flag as an integer."""
+        ...
+
+    @abstractmethod
+    def resolve_float_details(
+        self,
+        flag_key: str,
+        default_value: float,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[float]:
+        """Resolve the flag as a float."""
+        ...
+
+    @abstractmethod
+    def resolve_object_details(
+        self,
+        flag_key: str,
+        default_value: Union[dict, list],
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[Union[list, dict]]:
+        """Resolve the flag as an object."""
+        ...
+
+    # --- Async evaluation ---
+
+    @abstractmethod
+    async def resolve_boolean_details_async(
+        self,
+        flag_key: str,
+        default_value: bool,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[bool]:
+        """Asynchronously resolve the flag as a boolean."""
+        ...
+
+    @abstractmethod
+    async def resolve_string_details_async(
+        self,
+        flag_key: str,
+        default_value: str,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[str]:
+        """Asynchronously resolve the flag as a string."""
+        ...
+
+    @abstractmethod
+    async def resolve_integer_details_async(
+        self,
+        flag_key: str,
+        default_value: int,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[int]:
+        """Asynchronously resolve the flag as an integer."""
+        ...
+
+    @abstractmethod
+    async def resolve_float_details_async(
+        self,
+        flag_key: str,
+        default_value: float,
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[float]:
+        """Asynchronously resolve the flag as a float."""
+        ...
+
+    @abstractmethod
+    async def resolve_object_details_async(
+        self,
+        flag_key: str,
+        default_value: Union[dict, list],
+        evaluation_context: Optional[EvaluationContext] = None,
+    ) -> FlagResolutionDetails[Union[dict, list]]:
+        """Asynchronously resolve the flag as an object."""
+        ...
+
+    @abstractmethod
+    def is_flag_trackable(self, flag_key: str) -> bool:
+        """Check if the flag is trackable."""
+        ...