Standardizing Feature Flagging for Everyone
Project description
OpenFeature Python SDK
⚠️ Development is in progress, but there's not a stable release available. ⚠️
This is the Python implementation of OpenFeature, a vendor-agnostic abstraction library for evaluating feature flags.
We support multiple data types for flags (numbers, strings, booleans, objects) as well as hooks, which can alter the lifecycle of a flag evaluation.
This library is intended to be used in server-side contexts and has not been evaluated for use in mobile devices.
🔍 Requirements:
- Python 3.8+
📦 Installation:
Add it to your build
Pip install
pip install openfeature-sdk==0.2.0
requirements.txt
openfeature-sdk==0.2.0
pip install requirements.txt
🌟 Features:
- support for various backend providers
- easy integration and extension via hooks
- bool, string, numeric, and object flag types
- context-aware evaluation
🚀 Usage:
Configure it
In order to use the sdk there is some minor configuration. Follow the script below:
from open_feature import api
from open_feature.provider.no_op_provider import NoOpProvider
api.set_provider(NoOpProvider())
open_feature_client = api.get_client()
Basics:
While Boolean provides the simplest introduction, we offer a variety of flag types.
# Depending on the flag type, use one of the methods below
flag_key = "PROVIDER_FLAG"
boolean_result = open_feature_client.get_boolean_value(key=flag_key,default_value=False)
integer_result = open_feature_client.get_integer_value(key=flag_key,default_value=-1)
float_result = open_feature_client.get_float_value(key=flag_key,default_value=-1)
string_result = open_feature_client.get_string_value(key=flag_key,default_value="")
object_result = open_feature_client.get_object_value(key=flag_key,default_value={})
You can also bind a provider to a specific client by name instead of setting that provider globally:
api.set_provider(NoOpProvider())
Each provider class may have further setup required i.e. secret keys, environment variables etc
Context-aware evaluation:
Sometimes the value of a flag must take into account some dynamic criteria about the application or user, such as the user location, IP, email address, or the location of the server.
In OpenFeature, we refer to this as targeting
.
If the flag system you're using supports targeting, you can provide the input data using the EvaluationContext
.
from open_feature.api import (
get_client,
get_provider,
set_provider
get_evaluation_context,
set_evaluation_context,
)
global_context = EvaluationContext(
targeting_key="targeting_key1", attributes={"application": "value1"}
)
request_context = EvaluationContext(
targeting_key="targeting_key2", attributes={"email": request.form['email']}
)
## set global context
set_evaluation_context(first_context)
# merge second context
client = get_client(name="No-op Provider", version="0.5.2")
client.get_string_value("email", None, request_context)
Events
TBD (See Issue #131)
Providers:
To develop a provider, you need to create a new project and include the OpenFeature SDK as a dependency. This can be a new repository or included in the existing contrib repository available under the OpenFeature organization. Finally, you’ll then need to write the provider itself. This can be accomplished by implementing the Provider
interface exported by the OpenFeature SDK.
See here for a catalog of available providers.
Hooks:
A hook is a mechanism that allows for adding arbitrary behavior at well-defined points of the flag evaluation life-cycle. Use cases include validating the resolved flag value, modifying or adding data to the evaluation context, logging, telemetry, and tracking.
from open_feature.hook import Hook
class MyHook(Hook):
def after(self, hook_context: HookContext, details: FlagEvaluationDetails, hints: dict):
print("This runs after the flag has been evaluated")
# set global hooks at the API-level
from open_feature.api import add_hooks
add_hooks([MyHook()])
# or configure them in the client
client = OpenFeatureClient()
client.add_hooks([MyHook()])
See here for a catalog of available hooks.
Logging:
TBD
⭐️ Support the project
- Give this repo a ⭐️!
- Follow us on social media:
- Twitter: @openfeature
- LinkedIn: OpenFeature
- Join us on Slack
- For more check out our community page
🤝 Contributing
Interested in contributing? Great, we'd love your help! To get started, take a look at the CONTRIBUTING guide.
Thanks to everyone that has already contributed
Made with contrib.rocks.
Contacting us
We hold regular meetings which you can see here.
We are also present on the #openfeature
channel in the CNCF slack.
📜 License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for openfeature_sdk-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d164c0781587ce18c8f2c24f176afb02c20e118644440afb32c7ef7c281eed86 |
|
MD5 | 10af98e226cbc0a1d3ed603b37129e81 |
|
BLAKE2b-256 | 0e024c4dffdf8df22847da7c8a7528409352e688b9a198025466a7ca3059ceb2 |