Optimizely Feature Experimentation is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/experiment/feature-experimentation/ or see our documentation at https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome. # Optimizely Python SDK
[](https://pypi.org/project/optimizely-sdk)
[](https://github.com/optimizely/python-sdk/actions/workflows/python.yml?query=branch%3Amaster)
[](https://coveralls.io/github/optimizely/python-sdk)
[](http://www.apache.org/licenses/LICENSE-2.0)
This repository houses the Python SDK for use with Optimizely Feature Experimentation and Optimizely Full Stack (legacy).
Optimizely Feature Experimentation is an A/B testing and feature management tool for product development teams that enables you to experiment at every step. Using Optimizely Feature Experimentation allows for every feature on your roadmap to be an opportunity to discover hidden insights. Learn more at [Optimizely.com](https://www.optimizely.com/products/experiment/feature-experimentation/), or see the [developer documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome).
Optimizely Rollouts is [free feature flags](https://www.optimizely.com/free-feature-flagging/) for development teams. You can easily roll out and roll back features in any application without code deploys, mitigating risk for every feature on your roadmap.
## Get Started
Refer to the [Python SDK's developer documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/python-sdk) for detailed instructions on getting started with using the SDK.
### Requirements
Version `5.0+`: Python 3.8+, PyPy 3.8+
Version `4.0+`: Python 3.7+, PyPy 3.7+
Version `3.0+`: Python 2.7+, PyPy 3.4+
### Install the SDK
The SDK is available through [PyPi](https://pypi.python.org/pypi?name=optimizely-sdk&:action=display).
To install:
pip install optimizely-sdk
### Feature Management Access
To access the Feature Management configuration in the Optimizely
dashboard, please contact your Optimizely customer success manager.
## Use the Python SDK
### Initialization
You can initialize the Optimizely instance in three ways: with a datafile, by providing an sdk_key, or by providing an implementation of
[BaseConfigManager](https://github.com/optimizely/python-sdk/tree/master/optimizely/config_manager.py#L32).
Each method is described below.
1. Initialize Optimizely with a datafile. This datafile will be used as
the source of ProjectConfig throughout the life of Optimizely instance:
optimizely.Optimizely(
datafile
)
2. Initialize Optimizely by providing an \'sdk_key\'. This will
initialize a PollingConfigManager that makes an HTTP GET request to
the URL (formed using your provided sdk key and the
default datafile CDN URL template) to asynchronously download the
project datafile at regular intervals and update ProjectConfig when
a new datafile is received. A hard-coded datafile can also be
provided along with the sdk_key that will be used
initially before any update:
optimizely.Optimizely(
sdk_key='put_your_sdk_key_here'
)
If providing a datafile, the initialization will look like:
optimizely.Optimizely(
datafile=datafile,
sdk_key='put_your_sdk_key_here'
)
3. Initialize Optimizely by providing a ConfigManager that implements
[BaseConfigManager](https://github.com/optimizely/python-sdk/tree/master/optimizely/config_manager.py#L34).
You may use our [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L150) or
[AuthDatafilePollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L375) as needed:
optimizely.Optimizely(
config_manager=custom_config_manager
)
### PollingConfigManager
The [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L150) asynchronously polls for
datafiles from a specified URL at regular intervals by making HTTP requests.
polling_config_manager = PollingConfigManager(
sdk_key=None,
datafile=None,
update_interval=None,
url=None,
url_template=None,
logger=None,
error_handler=None,
notification_center=None,
skip_json_validation=False
)
**Note**: You must provide either the sdk_key or URL. If
you provide both, the URL takes precedence.
**sdk_key** The sdk_key is used to compose the outbound
HTTP request to the default datafile location on the Optimizely CDN.
**datafile** You can provide an initial datafile to bootstrap the
`ProjectConfigManager` so that it can be used immediately. The initial
datafile also serves as a fallback datafile if HTTP connection cannot be
established. The initial datafile will be discarded after the first
successful datafile poll.
**update_interval** The update_interval is used to specify a fixed
delay in seconds between consecutive HTTP requests for the datafile.
**url** The target URL from which to request the datafile.
**url_template** A string with placeholder `{sdk_key}` can be provided
so that this template along with the provided sdk key is
used to form the target URL.
You may also provide your own logger, error_handler, or
notification_center.
### AuthDatafilePollingConfigManager
The [AuthDatafilePollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L375)
implements `PollingConfigManager` and asynchronously polls for authenticated datafiles from a specified URL at regular intervals
by making HTTP requests.
auth_datafile_polling_config_manager = AuthDatafilePollingConfigManager(
datafile_access_token,
*args,
**kwargs
)
**Note**: To use [AuthDatafilePollingConfigManager](#authdatafilepollingconfigmanager), you must create a secure environment for
your project and generate an access token for your datafile.
**datafile_access_token** The datafile_access_token is attached to the outbound HTTP request header to authorize the request and fetch the datafile.
### Advanced configuration
The following properties can be set to override the default
configurations for [PollingConfigManager](#pollingconfigmanager) and [AuthDatafilePollingConfigManager](#authdatafilepollingconfigmanager).
| **Property Name** | **Default Value** | **Description** |
| :---------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------: |
| sdk_key | None | Optimizely project SDK key |
| datafile | None | Initial datafile, typically sourced from a local cached source |
| update_interval | 5 minutes | Fixed delay between fetches for the datafile |
| url | None | Custom URL location from which to fetch the datafile |
| url_template | `PollingConfigManager:`<br/>https://cdn.optimizely.com/datafiles/{sdk_key}.json<br/>`AuthDatafilePollingConfigManager:`<br/>https://config.optimizely.com/datafiles/auth/{sdk_key}.json | Parameterized datafile URL by SDK key |
A notification signal will be triggered whenever a _new_ datafile is
fetched and Project Config is updated. To subscribe to these
notifications, use:
```
notification_center.add_notification_listener(NotificationTypes.OPTIMIZELY_CONFIG_UPDATE, update_callback)
```
For Further details see the Optimizely [Feature Experimentation documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome)
to learn how to set up your first Python project and use the SDK.
## SDK Development
### Building the SDK
Build and install the SDK with pip, using the following command:
pip install -e .
### Unit Tests
#### Running all tests
To get test dependencies installed, use a modified version of the
install command:
pip install -e '.[test]'
You can run all unit tests with:
pytest
#### Running all tests in a file
To run all tests under a particular test file you can use the following
command:
pytest tests.<file_name_without_extension>
For example, to run all tests under `test_event_builder`, the command would be:
pytest tests/test_event_builder.py
#### Running all tests under a class
To run all tests under a particular class of tests you can use the
following command:
pytest tests/<file_name_with_extension>::ClassName
For example, to run all tests under `test_event_builder.EventTest`, the command
would be:
pytest tests/test_event_builder.py::EventTest
#### Running a single test
To run a single test you can use the following command:
pytest tests/<file_name_with_extension>::ClassName::test_name
For example, to run `test_event_builder.EventTest.test_init`, the command
would be:
pytest tests/test_event_builder.py::EventTest::test_init
### Contributing
Please see [CONTRIBUTING](https://github.com/optimizely/python-sdk/blob/master/CONTRIBUTING.md).
### Credits
This software incorporates code from the following open source projects:
requests (Apache-2.0 License: https://github.com/psf/requests/blob/master/LICENSE)
idna (BSD 3-Clause License https://github.com/kjd/idna/blob/master/LICENSE.md)
### Other Optimizely SDKs
- Agent - https://github.com/optimizely/agent
- Android - https://github.com/optimizely/android-sdk
- C# - https://github.com/optimizely/csharp-sdk
- Flutter - https://github.com/optimizely/optimizely-flutter-sdk
- Go - https://github.com/optimizely/go-sdk
- Java - https://github.com/optimizely/java-sdk
- JavaScript - https://github.com/optimizely/javascript-sdk
- PHP - https://github.com/optimizely/php-sdk
- Python - https://github.com/optimizely/python-sdk
- React - https://github.com/optimizely/react-sdk
- Ruby - https://github.com/optimizely/ruby-sdk
- Swift - https://github.com/optimizely/swift-sdk
# Optimizely Python SDK Changelog
## 5.0.1
June 26th, 2024
We removed redundant dependencies pyOpenSSL and cryptography ([#435](https://github.com/optimizely/python-sdk/pull/435), [#436](https://github.com/optimizely/python-sdk/pull/436)).
## 5.0.0
January 18th, 2024
### New Features
The 5.0.0 release introduces a new primary feature, [Advanced Audience Targeting]( https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting) enabled through integration with [Optimizely Data Platform (ODP)](https://docs.developers.optimizely.com/optimizely-data-platform/docs) ([#395](https://github.com/optimizely/python-sdk/pull/395), [#398](https://github.com/optimizely/python-sdk/pull/398), [#402](https://github.com/optimizely/python-sdk/pull/402), [#403](https://github.com/optimizely/python-sdk/pull/403), [#405](https://github.com/optimizely/python-sdk/pull/405)).
You can use ODP, a high-performance [Customer Data Platform (CDP)]( https://www.optimizely.com/optimization-glossary/customer-data-platform/), to easily create complex real-time segments (RTS) using first-party and 50+ third-party data sources out of the box. You can create custom schemas that support the user attributes important for your business, and stitch together user behavior done on different devices to better understand and target your customers for personalized user experiences. ODP can be used as a single source of truth for these segments in any Optimizely or 3rd party tool.
With ODP accounts integrated into Optimizely projects, you can build audiences using segments pre-defined in ODP. The SDK will fetch the segments for given users and make decisions using the segments. For access to ODP audience targeting in your Feature Experimentation account, please contact your Optimizely Customer Success Manager.
This version includes the following changes:
* New API added to `OptimizelyUserContext`:
* `fetchQualifiedSegments()`: this API will retrieve user segments from the ODP server. The fetched segments will be used for audience evaluation. The fetched data will be stored in the local cache to avoid repeated network delays.
* When an `OptimizelyUserContext` is created, the SDK will automatically send an identify request to the ODP server to facilitate observing user activities.
* New APIs added to `OptimizelyClient`:
* `sendOdpEvent()`: customers can build/send arbitrary ODP events that will bind user identifiers and data to user profiles in ODP.
For details, refer to our documentation pages:
* [Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting)
* [Server SDK Support](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-for-server-side-sdks)
* [Initialize Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/initialize-sdk-python)
* [OptimizelyUserContext Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/wip-fsodp-optimizelyusercontext-python)
* [Advanced Audience Targeting segment qualification methods](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-segment-qualification-methods-python)
* [Send Optimizely Data Platform data using Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/send-odp-data-using-advanced-audience-targeting-python)
### Logging
* Add warning to polling intervals below 30 seconds ([#428](https://github.com/optimizely/python-sdk/pull/428))
* Add warning to duplicate experiment keys ([#430](https://github.com/optimizely/python-sdk/pull/430))
### Enhancements
* Added `py.typed` to enable external usage of mypy type annotations.
### Breaking Changes
* Updated minimum supported Python version from 3.7 -> 3.8
* `ODPManager` in the SDK is enabled by default. Unless an ODP account is integrated into the Optimizely projects, most `ODPManager` functions will be ignored. If needed, `ODPManager` can be disabled when `OptimizelyClient` is instantiated.
* `BaseConfigManager` abstract class now requires a get_sdk_key method. ([#413](https://github.com/optimizely/python-sdk/pull/413))
* `PollingConfigManager` requires either the sdk_key parameter or datafile containing an sdkKey. ([#413](https://github.com/optimizely/python-sdk/pull/413))
* Asynchronous `BatchEventProcessor` is now the default event processor. ([#378](https://github.com/optimizely/python-sdk/pull/378))
## 5.0.0-beta
Apr 28th, 2023
### New Features
The 5.0.0-beta release introduces a new primary feature, [Advanced Audience Targeting]( https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting) enabled through integration with [Optimizely Data Platform (ODP)](https://docs.developers.optimizely.com/optimizely-data-platform/docs) ([#395](https://github.com/optimizely/python-sdk/pull/395), [#398](https://github.com/optimizely/python-sdk/pull/398), [#402](https://github.com/optimizely/python-sdk/pull/402), [#403](https://github.com/optimizely/python-sdk/pull/403), [#405](https://github.com/optimizely/python-sdk/pull/405)).
You can use ODP, a high-performance [Customer Data Platform (CDP)]( https://www.optimizely.com/optimization-glossary/customer-data-platform/), to easily create complex real-time segments (RTS) using first-party and 50+ third-party data sources out of the box. You can create custom schemas that support the user attributes important for your business, and stitch together user behavior done on different devices to better understand and target your customers for personalized user experiences. ODP can be used as a single source of truth for these segments in any Optimizely or 3rd party tool.
With ODP accounts integrated into Optimizely projects, you can build audiences using segments pre-defined in ODP. The SDK will fetch the segments for given users and make decisions using the segments. For access to ODP audience targeting in your Feature Experimentation account, please contact your Optimizely Customer Success Manager.
This version includes the following changes:
* New API added to `OptimizelyUserContext`:
* `fetchQualifiedSegments()`: this API will retrieve user segments from the ODP server. The fetched segments will be used for audience evaluation. The fetched data will be stored in the local cache to avoid repeated network delays.
* When an `OptimizelyUserContext` is created, the SDK will automatically send an identify request to the ODP server to facilitate observing user activities.
* New APIs added to `OptimizelyClient`:
* `sendOdpEvent()`: customers can build/send arbitrary ODP events that will bind user identifiers and data to user profiles in ODP.
For details, refer to our documentation pages:
* [Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting)
* [Server SDK Support](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-for-server-side-sdks)
* [Initialize Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/initialize-sdk-python)
* [OptimizelyUserContext Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/wip-fsodp-optimizelyusercontext-python)
* [Advanced Audience Targeting segment qualification methods](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-segment-qualification-methods-python)
* [Send Optimizely Data Platform data using Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/send-odp-data-using-advanced-audience-targeting-python)
### Breaking Changes
* `ODPManager` in the SDK is enabled by default. Unless an ODP account is integrated into the Optimizely projects, most `ODPManager` functions will be ignored. If needed, `ODPManager` can be disabled when `OptimizelyClient` is instantiated.
* `BaseConfigManager` abstract class now requires a get_sdk_key method. ([#413](https://github.com/optimizely/python-sdk/pull/413))
* `PollingConfigManager` requires either the sdk_key parameter or datafile containing an sdkKey. ([#413](https://github.com/optimizely/python-sdk/pull/413))
* Asynchronous `BatchEventProcessor` is now the default event processor. ([#378](https://github.com/optimizely/python-sdk/pull/378))
## 4.1.1
March 10th, 2023
We updated our README.md and other non-functional code to reflect that this SDK supports both Optimizely Feature Experimentation and Optimizely Full Stack. ([#420](https://github.com/optimizely/python-sdk/pull/420))
## 4.1.0
July 7th, 2022
### Bug Fixes
* Fix invalid datafile returned from `ProjectConfig.to_datafile` and `OptimizelyConfig.get_datafile` ([#321](https://github.com/optimizely/python-sdk/pull/321), [#384](https://github.com/optimizely/python-sdk/pull/384))
## 4.0.0
January 12th, 2022
### New Features
* Add a set of new APIs for overriding and managing user-level flag, experiment and delivery rule decisions. These methods can be used for QA and automated testing purposes. They are an extension of the OptimizelyUserContext interface ([#361](https://github.com/optimizely/python-sdk/pull/361), [#365](https://github.com/optimizely/python-sdk/pull/365), [#369](https://github.com/optimizely/python-sdk/pull/369)):
- setForcedDecision
- getForcedDecision
- removeForcedDecision
- removeAllForcedDecisions
* For details, refer to our documentation pages: [OptimizelyUserContext](https://docs.developers.optimizely.com/full-stack/v4.0/docs/optimizelyusercontext-python) and [Forced Decision methods](https://docs.developers.optimizely.com/full-stack/v4.0/docs/forced-decision-methods-python).
### Breaking Changes:
* Support for `Python v3.4` has been dropped as of this release due to a security vulnerability with `PyYAML <v5.4`. ([#366](https://github.com/optimizely/python-sdk/pull/366))
* We no longer support `Python v2.7, v3.5, and v3.6` including `PyPy` as of this release. ([#377](https://github.com/optimizely/python-sdk/pull/373))
* We now support `Python v3.7 and above` including `PyPy3`.
## 3.10.0
September 16th, 2021
### New Features
* Added new public properties to OptimizelyConfig.
- sdk_key and environment_key [#338] (https://github.com/optimizely/python-sdk/pull/338)
- attributes and events [#339] (https://github.com/optimizely/python-sdk/pull/339)
- experiment_rules, delivery_rules, audiences and audiences in OptimizelyExperiment
- [#342] (https://github.com/optimizely/python-sdk/pull/342)
- [#351] (https://github.com/optimizely/python-sdk/pull/351/files)
* For details please refer to our documentation page:
- Python-sdk: [https://docs.developers.optimizely.com/full-stack/docs/optimizelyconfig-python]
* OptimizelyFeature.experiments_map of OptimizelyConfig is now deprecated. Please use OptimizelyFeature.experiment_rules and OptimizelyFeature.delivery_rules. [#360] (https://github.com/optimizely/python-sdk/pull/360)
### Bug Fixes
* Fix event processor negative timeout interval when retrieving events from queue. [#356] (https://github.com/optimizely/python-sdk/pull/356)
## 3.9.1
July 14th, 2021
### Bug Fixes:
* Fixed issue with serving incorrect variation in projects containing multiple flags with duplicate keys. [#347] (https://github.com/optimizely/python-sdk/pull/347)
* Fixed issue with serving incorrect variation in create_impression_event in user_event_factory.py. [#350] (https://github.com/optimizely/python-sdk/pull/350)
## 3.9.0
June 1st, 2021
### New Features
* Added support for multiple concurrent prioritized experiments per flag. [#322](https://github.com/optimizely/python-sdk/pull/322)
## 3.8.0
February 12th, 2021
### New Features
* New Features
Introducing a new primary interface for retrieving feature flag status, configuration and associated experiment decisions for users ([#309](https://github.com/optimizely/python-sdk/pull/309)). The new `OptimizelyUserContext` class is instantiated with `create_user_context` and exposes the following APIs to get `OptimizelyDecision`:
- set_attribute
- decide
- decide_all
- decide_for_keys
- track_event
For details, refer to our documentation page: https://docs.developers.optimizely.com/full-stack/v4.0/docs/python-sdk.
## 3.7.1
November 19th, 2020
### Bug Fixes:
* Added "enabled" field to decision metadata structure. [#306](https://github.com/optimizely/python-sdk/pull/306)
## 3.7.0
November 2nd, 2020
### New Features
* Added support for upcoming application-controlled introduction of tracking for non-experiment Flag decisions. [#300](https://github.com/optimizely/python-sdk/pull/300)
## 3.6.0
October 1st, 2020
### New Features:
* Version targeting using semantic version syntax. [#293](https://github.com/optimizely/python-sdk/pull/293)
* Datafile accessor API added to access current config as a JSON string. [#283](https://github.com/optimizely/python-sdk/pull/283)
### Bug Fixes:
* Fixed package installation for Python 3.4 and pypy. [#298](https://github.com/optimizely/python-sdk/pull/298)
## 3.5.2
July 14th, 2020
### Bug Fixes:
* Fixed handling of network and no status code errors when polling for datafile in `PollingConfigManager` and `AuthDatafilePollingConfigManager`. ([#287](https://github.com/optimizely/python-sdk/pull/287))
## 3.5.1
July 10th, 2020
### Bug Fixes:
* Fixed HTTP request exception handling in `PollingConfigManager`. ([#285](https://github.com/optimizely/python-sdk/pull/285))
## 3.5.0
July 9th, 2020
### New Features:
* Introduced 2 APIs to interact with feature variables:
* `get_feature_variable_json` allows you to get value for JSON variables related to a feature.
* `get_all_feature_variables` gets values for all variables under a feature.
* Added support for fetching authenticated datafiles. `AuthDatafilePollingConfigManager` is a new config manager that allows you to poll for a datafile belonging to a secure environment. You can create a client by setting the `datafile_access_token`.
### Bug Fixes:
* Fixed log messages for targeted rollouts evaluation. ([#268](https://github.com/optimizely/python-sdk/pull/268))
## 3.4.2
June 11th, 2020
### Bug Fixes:
* Adjusted log level for audience evaluation logs. ([#267](https://github.com/optimizely/python-sdk/pull/267))
## 3.4.1
March 19th, 2020
### Bug Fixes:
* Updated `jsonschema` to address [installation issue](https://github.com/optimizely/python-sdk/issues/232).
## 3.4.0
January 27th, 2020
### New Features:
* Added a new API to get project configuration static data.
* Call `get_optimizely_config()` to get a snapshot of project configuration static data.
* It returns an `OptimizelyConfig` instance which includes a datafile revision number, all experiments, and feature flags mapped by their key values.
* Added caching for `get_optimizely_config()` - `OptimizelyConfig` object will be cached and reused for the lifetime of the datafile.
* For details, refer to our documentation page: [https://docs.developers.optimizely.com/full-stack/docs/optimizelyconfig-python](https://docs.developers.optimizely.com/full-stack/docs/optimizelyconfig-python).
## 3.3.1
December 16th, 2019
### Bug Fixes:
* Fixed [installation issue](https://github.com/optimizely/python-sdk/issues/220) on Windows. ([#224](https://github.com/optimizely/python-sdk/pull/224))
* Fixed batch event processor deadline reset issue. ([#227](https://github.com/optimizely/python-sdk/pull/227))
* Added more batch event processor debug messages. ([#227](https://github.com/optimizely/python-sdk/pull/227))
## 3.3.0
October 28th, 2019
### New Features:
* Added support for event batching via the event processor.
* Events generated by methods like `activate`, `track`, and `is_feature_enabled` will be held in a queue until the configured batch size is reached, or the configured flush interval has elapsed. Then, they will be batched into a single payload and sent to the event dispatcher.
* To configure event batching, set the `batch_size` and `flush_interval` properties when initializing instance of [BatchEventProcessor](https://github.com/optimizely/python-sdk/blob/3.3.x/optimizely/event/event_processor.py#L45).
* Event batching is disabled by default. You can pass in instance of `BatchEventProcessor` when creating `Optimizely` instance to enable event batching.
* Users can subscribe to `LogEvent` notification to be notified of whenever a payload consisting of a batch of user events is handed off to the event dispatcher to send to Optimizely's backend.
* Introduced blocking timeout in `PollingConfigManager`. By default, calls to `get_config` will block for maximum of 10 seconds until config is available.
### Bug Fixes:
* Fixed incorrect log message when numeric metric is not used. ([#217](https://github.com/optimizely/python-sdk/pull/217))
## 3.2.0
August 27th, 2019
### New Features:
* Added support for automatic datafile management via [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151):
* The [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151) is an implementation of the [BaseConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L32).
* Users may provide one of datafile or SDK key (sdk_key) or both to `optimizely.Optimizely`. Based on that, the SDK will use the [StaticConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L73) or the [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151). Refer to the [README](README.md) for more instructions.
* An initial datafile can be provided to the `PollingConfigManager` to bootstrap before making HTTP requests for the hosted datafile.
* Requests for the datafile are made in a separate thread and are scheduled with fixed delay.
* Configuration updates can be subscribed to by adding the OPTIMIZELY_CONFIG_UPDATE notification listener.
* Introduced `Optimizely.get_feature_variable` API. ([#191](https://github.com/optimizely/python-sdk/pull/191))
### Deprecated:
* `NotificationCenter.clear_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))
* `NotificationCenter.clear_all_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_all_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))
## 3.2.0b1
July 26th, 2019
### New Features:
* Added support for automatic datafile management via [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151):
* The [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151) is an implementation of the [BaseConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L32).
* Users may provide one of datafile or SDK key (sdk_key) or both to `optimizely.Optimizely`. Based on that, the SDK will use the [StaticConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L73) or the [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151). Refer to the [README](README.md) for more instructions.
* An initial datafile can be provided to the `PollingConfigManager` to bootstrap before making HTTP requests for the hosted datafile.
* Requests for the datafile are made in a separate thread and are scheduled with fixed delay.
* Configuration updates can be subscribed to by adding the OPTIMIZELY_CONFIG_UPDATE notification listener.
* Introduced `Optimizely.get_feature_variable` API. ([#191](https://github.com/optimizely/python-sdk/pull/191))
### Deprecated:
* `NotificationCenter.clear_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))
* `NotificationCenter.clear_all_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_all_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))
## 3.1.0
May 3rd, 2019
### New Features:
* Introduced Decision notification listener to be able to record:
* Variation assignments for users activated in an experiment.
* Feature access for users.
* Feature variable value for users.
### Bug Fixes:
* Feature variable APIs now return default variable value when featureEnabled property is false. ([#171](https://github.com/optimizely/python-sdk/pull/171))
### Deprecated:
* Activate notification listener is deprecated as of this release. Recommendation is to use the new Decision notification listener. Activate notification listener will be removed in the next major release.
## 3.0.0
March 1st, 2019
The 3.0 release improves event tracking and supports additional audience
targeting functionality.
### New Features:
* Event tracking:
* The `track` method now dispatches its conversion event *unconditionally*, without first determining whether the user is targeted by a known experiment that uses the event. This may increase outbound network traffic.
* In Optimizely results, conversion events sent by 3.0 SDKs don\'t explicitly name the experiments and variations that are currently targeted to the user. Instead, conversions are automatically attributed to variations that the user has previously seen, as long as those variations were served via 3.0 SDKs or by other clients capable of automatic attribution, and as long as our backend actually received the impression events for those variations.
* Altogether, this allows you to track conversion events and attribute them to variations even when you don't know all of a user's attribute values, and even if the user's attribute values or the experiment's configuration have changed such that the user is no longer affected by the experiment. As a result, **you may observe an increase in the conversion rate for previously-instrumented events.** If that is undesirable, you can reset the results of previously-running experiments after upgrading to the 3.0 SDK. - This will also allow you to attribute events to variations from other Optimizely projects in your account, even though those experiments don't appear in the same datafile.
* Note that for results segmentation in Optimizely results, the user attribute values from one event are automatically applied to all other events in the same session, as long as the events in question were actually received by our backend. This behavior was already in place and is not affected by the 3.0 release.
* Support for all types of attribute values, not just strings.
* All values are passed through to notification listeners.
* Strings, booleans, and valid numbers are passed to the event dispatcher and can be used for Optimizely results segmentation. A valid number is a finite float or numbers.Integral in the inclusive range \[-2 ^ 53, 2 ^ 53\].
* Strings, booleans, and valid numbers are relevant for audience conditions.
* Support for additional matchers in audience conditions:
* An `exists` matcher that passes if the user has a non-null value for the targeted user attribute and fails otherwise.
* A `substring` matcher that resolves if the user has a string value for the targeted attribute.
* `gt` (greater than) and `lt` (less than) matchers that resolve if the user has a valid number value for the targeted attribute. A valid number is a finite float or numbers.Integral in the inclusive range \[-2 ^ 53, 2 ^ 53\].
* The original (`exact`) matcher can now be used to target booleans and valid numbers, not just strings.
* Support for A/B tests, feature tests, and feature rollouts whose audiences are combined using `"and"` and `"not"` operators, not just the `"or"` operator.
* Datafile-version compatibility check: The SDK will remain uninitialized (i.e., will gracefully fail to activate experiments and features) if given a datafile version greater than 4.
* Updated Pull Request template and commit message guidelines.
### Breaking Changes:
* Conversion events sent by 3.0 SDKs don\'t explicitly name the experiments and variations that are currently targeted to the user, so these events are unattributed in raw events data export. You must use the new *results* export to determine the variations to which events have been attributed.
* Previously, notification listeners were only given string-valued user attributes because only strings could be passed into various method calls. That is no longer the case. You may pass non-string attribute values, and if you do, you must update your notification listeners to be able to receive whatever values you pass in.
### Bug Fixes:
* Experiments and features can no longer activate when a negatively targeted attribute has a missing, null, or malformed value.
* Audience conditions (except for the new `exists` matcher) no longer resolve to `false` when they fail to find an legitimate value for the targeted user attribute. The result remains `null` (unknown). Therefore, an audience that negates such a condition (using the `"not"` operator) can no longer resolve to `true` unless there is an unrelated branch in the condition tree that itself resolves to `true`.
* Updated the default event dispatcher to log an error if the request resolves to HTTP 4xx or 5xx. ([#140](https://github.com/optimizely/python-sdk/pull/140))
* All methods now validate that user IDs are strings and that experiment keys, feature keys, feature variable keys, and event keys are non-empty strings.
## 2.1.1
August 21st, 2018
* Fix: record conversions for all experiments using an event when using track([#136](https://github.com/optimizely/python-sdk/pull/136)).
## 2.1.0
July 2nd, 2018
* Introduced support for bot filtering ([#121](https://github.com/optimizely/python-sdk/pull/121)).
* Overhauled logging to use standard Python logging ([#123](https://github.com/optimizely/python-sdk/pull/123)).
## 2.0.1
June 19th, 2018
* Fix: send impression event for Feature Test when Feature is disabled ([#128](https://github.com/optimizely/python-sdk/pull/128)).
## 2.0.0
April 12th, 2018
This major release introduces APIs for Feature Management. It also
introduces some breaking changes listed below.
### New Features
* Introduced the `is_feature_enabled` API to determine whether to show a feature to a user or not.
```
is_enabled = optimizel_client.is_feature_enabled('my_feature_key', 'my_user', user_attributes)
```
* All enabled features for the user can be retrieved by calling:
```
enabled_features = optimizely_client.get_enabled_features('my_user', user_attributes)
```
* Introduced Feature Variables to configure or parameterize a feature. There are four variable types: `String`, `Integer`, `Double`, `Boolean`.
```
string_variable = optimizely_client.get_feature_variable_string('my_feature_key', 'string_variable_key', 'my_user')
integer_variable = optimizely_client.get_feature_variable_integer('my_feature_key', 'integer_variable_key', 'my_user')
double_variable = optimizely_client.get_feature_variable_double('my_feature_key', 'double_variable_key', 'my_user')
boolean_variable = optimizely_client.get_feature_variable_boolean('my_feature_key', 'boolean_variable_key', 'my_user')
```
### Breaking changes
* The `track` API with revenue value as a stand-alone parameter has been removed. The revenue value should be passed in as an entry in the event tags dict. The key for the revenue tag is `revenue` and the passed in value will be treated by Optimizely as the value for computing results.
```
event_tags = {
'revenue': 1200
}
optimizely_client.track('event_key', 'my_user', user_attributes, event_tags)
```
## 2.0.0b1
March 29th, 2018
This beta release introduces APIs for Feature Management. It also
introduces some breaking changes listed below.
### New Features
* Introduced the `is_feature_enabled` API to determine whether to show a feature to a user or not.
```
is_enabled = optimizel_client.is_feature_enabled('my_feature_key', 'my_user', user_attributes)
```
* All enabled features for the user can be retrieved by calling:
```
enabled_features = optimizely_client.get_enabled_features('my_user', user_attributes)
```
* Introduced Feature Variables to configure or parameterize a feature. There are four variable types: `String`, `Integer`, `Double`, `Boolean`.
```
string_variable = optimizely_client.get_feature_variable_string('my_feature_key', 'string_variable_key', 'my_user')
integer_variable = optimizely_client.get_feature_variable_integer('my_feature_key', 'integer_variable_key', 'my_user')
double_variable = optimizely_client.get_feature_variable_double('my_feature_key', 'double_variable_key', 'my_user')
boolean_variable = optimizely_client.get_feature_variable_boolean('my_feature_key', 'boolean_variable_key', 'my_user')
```
### Breaking changes
* The `track` API with revenue value as a stand-alone parameter has been removed. The revenue value should be passed in as an entry in the event tags dict. The key for the revenue tag is `revenue` and the passed in value will be treated by Optimizely as the value for computing results.
```
event_tags = {
'revenue': 1200
}
optimizely_client.track('event_key', 'my_user', user_attributes, event_tags)
```
## 1.4.0
* Added support for IP anonymization.
* Added support for notification listeners.
* Added support for bucketing ID.
* Updated mmh3 to handle installation failures on Windows 10.
## 1.3.0
* Introduced support for forced bucketing.
* Introduced support for numeric metrics.
* Updated event builder to support new endpoint.
## 1.2.1
* Removed older feature flag parsing.
## 1.2.0
* Added user profile service.
## 1.1.1
* Updated datafile parsing to be able to handle additional fields.
* Deprecated Classic project support.
## 1.1.0
* Included datafile revision information in log events.
* Added event tags to track API to allow users to pass in event metadata.
* Deprecated the `event_value` parameter from the track method. Should use `event_tags` to pass in event value instead.
* Updated event logging endpoint to logx.optimizely.com.
## 1.0.0
* Introduced support for Full Stack projects in Optimizely X. No breaking changes from previous version.
* Introduced more graceful exception handling in instantiation and core methods.
* Updated whitelisting to precede audience matching.
## 0.1.3
* Added support for v2 endpoint and datafile.
* Updated dispatch_event to consume an Event object instead of url and params. The Event object comprises of four properties: url (string representing URL to dispatch event to), params (dict representing the params to be set for the event), http_verb (one of 'GET' or 'POST') and headers (header values to be sent along).
* Fixed issue with tracking events for experiments in groups.
## 0.1.2
* Updated requirements file.
## 0.1.1
* Introduced option to skip JSON schema validation.
## 0.1.0
* Beta release of the Python SDK for server-side testing.
Raw data
{
"_id": null,
"home_page": "https://github.com/optimizely/python-sdk",
"name": "optimizely-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Optimizely",
"author_email": "developers@optimizely.com",
"download_url": "https://files.pythonhosted.org/packages/e1/c0/d7148e843cae328438b341b1e76aab7391357a2f2735c99c04f4f62c1e6f/optimizely-sdk-5.0.1.tar.gz",
"platform": null,
"description": "Optimizely Feature Experimentation is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/experiment/feature-experimentation/ or see our documentation at https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome. # Optimizely Python SDK\n\n[](https://pypi.org/project/optimizely-sdk)\n[](https://github.com/optimizely/python-sdk/actions/workflows/python.yml?query=branch%3Amaster)\n[](https://coveralls.io/github/optimizely/python-sdk)\n[](http://www.apache.org/licenses/LICENSE-2.0)\n\nThis repository houses the Python SDK for use with Optimizely Feature Experimentation and Optimizely Full Stack (legacy).\n\nOptimizely Feature Experimentation is an A/B testing and feature management tool for product development teams that enables you to experiment at every step. Using Optimizely Feature Experimentation allows for every feature on your roadmap to be an opportunity to discover hidden insights. Learn more at [Optimizely.com](https://www.optimizely.com/products/experiment/feature-experimentation/), or see the [developer documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome).\n\nOptimizely Rollouts is [free feature flags](https://www.optimizely.com/free-feature-flagging/) for development teams. You can easily roll out and roll back features in any application without code deploys, mitigating risk for every feature on your roadmap.\n\n## Get Started\n\nRefer to the [Python SDK's developer documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/python-sdk) for detailed instructions on getting started with using the SDK.\n\n### Requirements\n\nVersion `5.0+`: Python 3.8+, PyPy 3.8+\n\nVersion `4.0+`: Python 3.7+, PyPy 3.7+\n\nVersion `3.0+`: Python 2.7+, PyPy 3.4+\n\n### Install the SDK\n\nThe SDK is available through [PyPi](https://pypi.python.org/pypi?name=optimizely-sdk&:action=display).\n\nTo install:\n\n pip install optimizely-sdk\n\n### Feature Management Access\n\nTo access the Feature Management configuration in the Optimizely\ndashboard, please contact your Optimizely customer success manager.\n\n## Use the Python SDK\n\n### Initialization\n\nYou can initialize the Optimizely instance in three ways: with a datafile, by providing an sdk_key, or by providing an implementation of\n[BaseConfigManager](https://github.com/optimizely/python-sdk/tree/master/optimizely/config_manager.py#L32).\nEach method is described below.\n\n1. Initialize Optimizely with a datafile. This datafile will be used as\n the source of ProjectConfig throughout the life of Optimizely instance:\n\n optimizely.Optimizely(\n datafile\n )\n\n2. Initialize Optimizely by providing an \\'sdk_key\\'. This will\n initialize a PollingConfigManager that makes an HTTP GET request to\n the URL (formed using your provided sdk key and the\n default datafile CDN URL template) to asynchronously download the\n project datafile at regular intervals and update ProjectConfig when\n a new datafile is received. A hard-coded datafile can also be\n provided along with the sdk_key that will be used\n initially before any update:\n\n optimizely.Optimizely(\n sdk_key='put_your_sdk_key_here'\n )\n\n If providing a datafile, the initialization will look like:\n\n optimizely.Optimizely(\n datafile=datafile,\n sdk_key='put_your_sdk_key_here'\n )\n\n3. Initialize Optimizely by providing a ConfigManager that implements\n [BaseConfigManager](https://github.com/optimizely/python-sdk/tree/master/optimizely/config_manager.py#L34).\n You may use our [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L150) or\n [AuthDatafilePollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L375) as needed:\n\n optimizely.Optimizely(\n config_manager=custom_config_manager\n )\n\n### PollingConfigManager\n\nThe [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L150) asynchronously polls for\ndatafiles from a specified URL at regular intervals by making HTTP requests.\n\n polling_config_manager = PollingConfigManager(\n sdk_key=None,\n datafile=None,\n update_interval=None,\n url=None,\n url_template=None,\n logger=None,\n error_handler=None,\n notification_center=None,\n skip_json_validation=False\n )\n\n**Note**: You must provide either the sdk_key or URL. If\nyou provide both, the URL takes precedence.\n\n**sdk_key** The sdk_key is used to compose the outbound\nHTTP request to the default datafile location on the Optimizely CDN.\n\n**datafile** You can provide an initial datafile to bootstrap the\n`ProjectConfigManager` so that it can be used immediately. The initial\ndatafile also serves as a fallback datafile if HTTP connection cannot be\nestablished. The initial datafile will be discarded after the first\nsuccessful datafile poll.\n\n**update_interval** The update_interval is used to specify a fixed\ndelay in seconds between consecutive HTTP requests for the datafile.\n\n**url** The target URL from which to request the datafile.\n\n**url_template** A string with placeholder `{sdk_key}` can be provided\nso that this template along with the provided sdk key is\nused to form the target URL.\n\nYou may also provide your own logger, error_handler, or\nnotification_center.\n\n### AuthDatafilePollingConfigManager\n\nThe [AuthDatafilePollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L375)\nimplements `PollingConfigManager` and asynchronously polls for authenticated datafiles from a specified URL at regular intervals\nby making HTTP requests.\n\n auth_datafile_polling_config_manager = AuthDatafilePollingConfigManager(\n datafile_access_token,\n *args,\n **kwargs\n )\n\n**Note**: To use [AuthDatafilePollingConfigManager](#authdatafilepollingconfigmanager), you must create a secure environment for\nyour project and generate an access token for your datafile.\n\n**datafile_access_token** The datafile_access_token is attached to the outbound HTTP request header to authorize the request and fetch the datafile.\n\n### Advanced configuration\n\nThe following properties can be set to override the default\nconfigurations for [PollingConfigManager](#pollingconfigmanager) and [AuthDatafilePollingConfigManager](#authdatafilepollingconfigmanager).\n\n| **Property Name** | **Default Value** | **Description** |\n| :---------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------: |\n| sdk_key | None | Optimizely project SDK key |\n| datafile | None | Initial datafile, typically sourced from a local cached source |\n| update_interval | 5 minutes | Fixed delay between fetches for the datafile |\n| url | None | Custom URL location from which to fetch the datafile |\n| url_template | `PollingConfigManager:`<br/>https://cdn.optimizely.com/datafiles/{sdk_key}.json<br/>`AuthDatafilePollingConfigManager:`<br/>https://config.optimizely.com/datafiles/auth/{sdk_key}.json | Parameterized datafile URL by SDK key |\n\nA notification signal will be triggered whenever a _new_ datafile is\nfetched and Project Config is updated. To subscribe to these\nnotifications, use:\n\n```\nnotification_center.add_notification_listener(NotificationTypes.OPTIMIZELY_CONFIG_UPDATE, update_callback)\n```\n\nFor Further details see the Optimizely [Feature Experimentation documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome)\nto learn how to set up your first Python project and use the SDK.\n\n## SDK Development\n\n### Building the SDK\n\nBuild and install the SDK with pip, using the following command:\n\n pip install -e .\n\n### Unit Tests\n\n#### Running all tests\n\nTo get test dependencies installed, use a modified version of the\ninstall command:\n\n pip install -e '.[test]'\n\nYou can run all unit tests with:\n\n pytest\n\n#### Running all tests in a file\n\nTo run all tests under a particular test file you can use the following\ncommand:\n\n pytest tests.<file_name_without_extension>\n\nFor example, to run all tests under `test_event_builder`, the command would be:\n\n pytest tests/test_event_builder.py\n\n#### Running all tests under a class\n\nTo run all tests under a particular class of tests you can use the\nfollowing command:\n\n pytest tests/<file_name_with_extension>::ClassName\n\nFor example, to run all tests under `test_event_builder.EventTest`, the command\nwould be:\n\n pytest tests/test_event_builder.py::EventTest\n\n#### Running a single test\n\nTo run a single test you can use the following command:\n\n pytest tests/<file_name_with_extension>::ClassName::test_name\n\nFor example, to run `test_event_builder.EventTest.test_init`, the command\nwould be:\n\n pytest tests/test_event_builder.py::EventTest::test_init\n\n### Contributing\n\nPlease see [CONTRIBUTING](https://github.com/optimizely/python-sdk/blob/master/CONTRIBUTING.md).\n\n### Credits\n\nThis software incorporates code from the following open source projects:\n\nrequests (Apache-2.0 License: https://github.com/psf/requests/blob/master/LICENSE)\n\nidna (BSD 3-Clause License https://github.com/kjd/idna/blob/master/LICENSE.md)\n\n### Other Optimizely SDKs\n\n- Agent - https://github.com/optimizely/agent\n\n- Android - https://github.com/optimizely/android-sdk\n\n- C# - https://github.com/optimizely/csharp-sdk\n\n- Flutter - https://github.com/optimizely/optimizely-flutter-sdk\n\n- Go - https://github.com/optimizely/go-sdk\n\n- Java - https://github.com/optimizely/java-sdk\n\n- JavaScript - https://github.com/optimizely/javascript-sdk\n\n- PHP - https://github.com/optimizely/php-sdk\n\n- Python - https://github.com/optimizely/python-sdk\n\n- React - https://github.com/optimizely/react-sdk\n\n- Ruby - https://github.com/optimizely/ruby-sdk\n\n- Swift - https://github.com/optimizely/swift-sdk\n# Optimizely Python SDK Changelog\n\n## 5.0.1\nJune 26th, 2024\n\nWe removed redundant dependencies pyOpenSSL and cryptography ([#435](https://github.com/optimizely/python-sdk/pull/435), [#436](https://github.com/optimizely/python-sdk/pull/436)).\n\n## 5.0.0\nJanuary 18th, 2024\n\n### New Features\n\nThe 5.0.0 release introduces a new primary feature, [Advanced Audience Targeting]( https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting) enabled through integration with [Optimizely Data Platform (ODP)](https://docs.developers.optimizely.com/optimizely-data-platform/docs) ([#395](https://github.com/optimizely/python-sdk/pull/395), [#398](https://github.com/optimizely/python-sdk/pull/398), [#402](https://github.com/optimizely/python-sdk/pull/402), [#403](https://github.com/optimizely/python-sdk/pull/403), [#405](https://github.com/optimizely/python-sdk/pull/405)).\n\nYou can use ODP, a high-performance [Customer Data Platform (CDP)]( https://www.optimizely.com/optimization-glossary/customer-data-platform/), to easily create complex real-time segments (RTS) using first-party and 50+ third-party data sources out of the box. You can create custom schemas that support the user attributes important for your business, and stitch together user behavior done on different devices to better understand and target your customers for personalized user experiences. ODP can be used as a single source of truth for these segments in any Optimizely or 3rd party tool.\n\nWith ODP accounts integrated into Optimizely projects, you can build audiences using segments pre-defined in ODP. The SDK will fetch the segments for given users and make decisions using the segments. For access to ODP audience targeting in your Feature Experimentation account, please contact your Optimizely Customer Success Manager.\n\nThis version includes the following changes:\n\n* New API added to `OptimizelyUserContext`:\n\n * `fetchQualifiedSegments()`: this API will retrieve user segments from the ODP server. The fetched segments will be used for audience evaluation. The fetched data will be stored in the local cache to avoid repeated network delays.\n * When an `OptimizelyUserContext` is created, the SDK will automatically send an identify request to the ODP server to facilitate observing user activities.\n\n* New APIs added to `OptimizelyClient`:\n\n * `sendOdpEvent()`: customers can build/send arbitrary ODP events that will bind user identifiers and data to user profiles in ODP.\n\nFor details, refer to our documentation pages:\n\n* [Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting)\n* [Server SDK Support](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-for-server-side-sdks)\n* [Initialize Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/initialize-sdk-python)\n* [OptimizelyUserContext Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/wip-fsodp-optimizelyusercontext-python)\n* [Advanced Audience Targeting segment qualification methods](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-segment-qualification-methods-python)\n* [Send Optimizely Data Platform data using Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/send-odp-data-using-advanced-audience-targeting-python)\n\n### Logging\n\n* Add warning to polling intervals below 30 seconds ([#428](https://github.com/optimizely/python-sdk/pull/428))\n* Add warning to duplicate experiment keys ([#430](https://github.com/optimizely/python-sdk/pull/430))\n\n### Enhancements\n* Added `py.typed` to enable external usage of mypy type annotations.\n\n### Breaking Changes\n* Updated minimum supported Python version from 3.7 -> 3.8\n* `ODPManager` in the SDK is enabled by default. Unless an ODP account is integrated into the Optimizely projects, most `ODPManager` functions will be ignored. If needed, `ODPManager` can be disabled when `OptimizelyClient` is instantiated.\n* `BaseConfigManager` abstract class now requires a get_sdk_key method. ([#413](https://github.com/optimizely/python-sdk/pull/413))\n* `PollingConfigManager` requires either the sdk_key parameter or datafile containing an sdkKey. ([#413](https://github.com/optimizely/python-sdk/pull/413))\n* Asynchronous `BatchEventProcessor` is now the default event processor. ([#378](https://github.com/optimizely/python-sdk/pull/378))\n\n## 5.0.0-beta\nApr 28th, 2023\n\n### New Features\n\nThe 5.0.0-beta release introduces a new primary feature, [Advanced Audience Targeting]( https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting) enabled through integration with [Optimizely Data Platform (ODP)](https://docs.developers.optimizely.com/optimizely-data-platform/docs) ([#395](https://github.com/optimizely/python-sdk/pull/395), [#398](https://github.com/optimizely/python-sdk/pull/398), [#402](https://github.com/optimizely/python-sdk/pull/402), [#403](https://github.com/optimizely/python-sdk/pull/403), [#405](https://github.com/optimizely/python-sdk/pull/405)).\n\nYou can use ODP, a high-performance [Customer Data Platform (CDP)]( https://www.optimizely.com/optimization-glossary/customer-data-platform/), to easily create complex real-time segments (RTS) using first-party and 50+ third-party data sources out of the box. You can create custom schemas that support the user attributes important for your business, and stitch together user behavior done on different devices to better understand and target your customers for personalized user experiences. ODP can be used as a single source of truth for these segments in any Optimizely or 3rd party tool.\n\nWith ODP accounts integrated into Optimizely projects, you can build audiences using segments pre-defined in ODP. The SDK will fetch the segments for given users and make decisions using the segments. For access to ODP audience targeting in your Feature Experimentation account, please contact your Optimizely Customer Success Manager.\n\nThis version includes the following changes:\n\n* New API added to `OptimizelyUserContext`:\n\n * `fetchQualifiedSegments()`: this API will retrieve user segments from the ODP server. The fetched segments will be used for audience evaluation. The fetched data will be stored in the local cache to avoid repeated network delays.\n * When an `OptimizelyUserContext` is created, the SDK will automatically send an identify request to the ODP server to facilitate observing user activities.\n\n* New APIs added to `OptimizelyClient`:\n\n * `sendOdpEvent()`: customers can build/send arbitrary ODP events that will bind user identifiers and data to user profiles in ODP.\n\nFor details, refer to our documentation pages:\n\n* [Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting)\n* [Server SDK Support](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-for-server-side-sdks)\n* [Initialize Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/initialize-sdk-python)\n* [OptimizelyUserContext Python SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/wip-fsodp-optimizelyusercontext-python)\n* [Advanced Audience Targeting segment qualification methods](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-segment-qualification-methods-python)\n* [Send Optimizely Data Platform data using Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/send-odp-data-using-advanced-audience-targeting-python)\n\n### Breaking Changes\n\n* `ODPManager` in the SDK is enabled by default. Unless an ODP account is integrated into the Optimizely projects, most `ODPManager` functions will be ignored. If needed, `ODPManager` can be disabled when `OptimizelyClient` is instantiated.\n* `BaseConfigManager` abstract class now requires a get_sdk_key method. ([#413](https://github.com/optimizely/python-sdk/pull/413))\n* `PollingConfigManager` requires either the sdk_key parameter or datafile containing an sdkKey. ([#413](https://github.com/optimizely/python-sdk/pull/413))\n* Asynchronous `BatchEventProcessor` is now the default event processor. ([#378](https://github.com/optimizely/python-sdk/pull/378))\n\n## 4.1.1\nMarch 10th, 2023\n\nWe updated our README.md and other non-functional code to reflect that this SDK supports both Optimizely Feature Experimentation and Optimizely Full Stack. ([#420](https://github.com/optimizely/python-sdk/pull/420))\n\n## 4.1.0\nJuly 7th, 2022\n\n### Bug Fixes\n* Fix invalid datafile returned from `ProjectConfig.to_datafile` and `OptimizelyConfig.get_datafile` ([#321](https://github.com/optimizely/python-sdk/pull/321), [#384](https://github.com/optimizely/python-sdk/pull/384))\n\n## 4.0.0\nJanuary 12th, 2022\n\n### New Features\n* Add a set of new APIs for overriding and managing user-level flag, experiment and delivery rule decisions. These methods can be used for QA and automated testing purposes. They are an extension of the OptimizelyUserContext interface ([#361](https://github.com/optimizely/python-sdk/pull/361), [#365](https://github.com/optimizely/python-sdk/pull/365), [#369](https://github.com/optimizely/python-sdk/pull/369)):\n\t- setForcedDecision\n\t- getForcedDecision\n\t- removeForcedDecision\n\t- removeAllForcedDecisions\n\n* For details, refer to our documentation pages: [OptimizelyUserContext](https://docs.developers.optimizely.com/full-stack/v4.0/docs/optimizelyusercontext-python) and [Forced Decision methods](https://docs.developers.optimizely.com/full-stack/v4.0/docs/forced-decision-methods-python).\n\n### Breaking Changes:\n\n* Support for `Python v3.4` has been dropped as of this release due to a security vulnerability with `PyYAML <v5.4`. ([#366](https://github.com/optimizely/python-sdk/pull/366))\n* We no longer support `Python v2.7, v3.5, and v3.6` including `PyPy` as of this release. ([#377](https://github.com/optimizely/python-sdk/pull/373))\n* We now support `Python v3.7 and above` including `PyPy3`.\n\n## 3.10.0\nSeptember 16th, 2021\n\n### New Features\n* Added new public properties to OptimizelyConfig.\n - sdk_key and environment_key [#338] (https://github.com/optimizely/python-sdk/pull/338)\n - attributes and events [#339] (https://github.com/optimizely/python-sdk/pull/339)\n - experiment_rules, delivery_rules, audiences and audiences in OptimizelyExperiment\n - [#342] (https://github.com/optimizely/python-sdk/pull/342)\n - [#351] (https://github.com/optimizely/python-sdk/pull/351/files)\n* For details please refer to our documentation page:\n - Python-sdk: [https://docs.developers.optimizely.com/full-stack/docs/optimizelyconfig-python]\n\n* OptimizelyFeature.experiments_map of OptimizelyConfig is now deprecated. Please use OptimizelyFeature.experiment_rules and OptimizelyFeature.delivery_rules. [#360] (https://github.com/optimizely/python-sdk/pull/360)\n\n### Bug Fixes\n* Fix event processor negative timeout interval when retrieving events from queue. [#356] (https://github.com/optimizely/python-sdk/pull/356)\n\n## 3.9.1\nJuly 14th, 2021\n\n### Bug Fixes:\n* Fixed issue with serving incorrect variation in projects containing multiple flags with duplicate keys. [#347] (https://github.com/optimizely/python-sdk/pull/347)\n* Fixed issue with serving incorrect variation in create_impression_event in user_event_factory.py. [#350] (https://github.com/optimizely/python-sdk/pull/350)\n\n## 3.9.0\nJune 1st, 2021\n\n### New Features\n* Added support for multiple concurrent prioritized experiments per flag. [#322](https://github.com/optimizely/python-sdk/pull/322)\n\n## 3.8.0\nFebruary 12th, 2021\n\n### New Features\n* New Features\nIntroducing a new primary interface for retrieving feature flag status, configuration and associated experiment decisions for users ([#309](https://github.com/optimizely/python-sdk/pull/309)). The new `OptimizelyUserContext` class is instantiated with `create_user_context` and exposes the following APIs to get `OptimizelyDecision`:\n\n - set_attribute\n - decide\n - decide_all\n - decide_for_keys\n - track_event\n\nFor details, refer to our documentation page: https://docs.developers.optimizely.com/full-stack/v4.0/docs/python-sdk.\n\n## 3.7.1\nNovember 19th, 2020\n\n### Bug Fixes:\n* Added \"enabled\" field to decision metadata structure. [#306](https://github.com/optimizely/python-sdk/pull/306)\n\n## 3.7.0\nNovember 2nd, 2020\n\n### New Features\n* Added support for upcoming application-controlled introduction of tracking for non-experiment Flag decisions. [#300](https://github.com/optimizely/python-sdk/pull/300)\n\n## 3.6.0\nOctober 1st, 2020\n\n### New Features:\n* Version targeting using semantic version syntax. [#293](https://github.com/optimizely/python-sdk/pull/293)\n* Datafile accessor API added to access current config as a JSON string. [#283](https://github.com/optimizely/python-sdk/pull/283)\n\n### Bug Fixes:\n* Fixed package installation for Python 3.4 and pypy. [#298](https://github.com/optimizely/python-sdk/pull/298)\n\n## 3.5.2\nJuly 14th, 2020\n\n### Bug Fixes:\n* Fixed handling of network and no status code errors when polling for datafile in `PollingConfigManager` and `AuthDatafilePollingConfigManager`. ([#287](https://github.com/optimizely/python-sdk/pull/287))\n\n## 3.5.1\nJuly 10th, 2020\n\n### Bug Fixes:\n* Fixed HTTP request exception handling in `PollingConfigManager`. ([#285](https://github.com/optimizely/python-sdk/pull/285))\n\n## 3.5.0\nJuly 9th, 2020\n\n### New Features:\n* Introduced 2 APIs to interact with feature variables:\n * `get_feature_variable_json` allows you to get value for JSON variables related to a feature.\n * `get_all_feature_variables` gets values for all variables under a feature.\n* Added support for fetching authenticated datafiles. `AuthDatafilePollingConfigManager` is a new config manager that allows you to poll for a datafile belonging to a secure environment. You can create a client by setting the `datafile_access_token`.\n\n### Bug Fixes:\n* Fixed log messages for targeted rollouts evaluation. ([#268](https://github.com/optimizely/python-sdk/pull/268))\n\n## 3.4.2\nJune 11th, 2020\n\n### Bug Fixes:\n* Adjusted log level for audience evaluation logs. ([#267](https://github.com/optimizely/python-sdk/pull/267))\n\n## 3.4.1\nMarch 19th, 2020\n\n### Bug Fixes:\n* Updated `jsonschema` to address [installation issue](https://github.com/optimizely/python-sdk/issues/232).\n\n## 3.4.0\nJanuary 27th, 2020\n\n### New Features:\n* Added a new API to get project configuration static data.\n * Call `get_optimizely_config()` to get a snapshot of project configuration static data.\n * It returns an `OptimizelyConfig` instance which includes a datafile revision number, all experiments, and feature flags mapped by their key values.\n * Added caching for `get_optimizely_config()` - `OptimizelyConfig` object will be cached and reused for the lifetime of the datafile.\n * For details, refer to our documentation page: [https://docs.developers.optimizely.com/full-stack/docs/optimizelyconfig-python](https://docs.developers.optimizely.com/full-stack/docs/optimizelyconfig-python).\n\n\n## 3.3.1\nDecember 16th, 2019\n\n### Bug Fixes:\n* Fixed [installation issue](https://github.com/optimizely/python-sdk/issues/220) on Windows. ([#224](https://github.com/optimizely/python-sdk/pull/224))\n* Fixed batch event processor deadline reset issue. ([#227](https://github.com/optimizely/python-sdk/pull/227))\n* Added more batch event processor debug messages. ([#227](https://github.com/optimizely/python-sdk/pull/227))\n\n## 3.3.0\nOctober 28th, 2019\n\n### New Features:\n* Added support for event batching via the event processor.\n * Events generated by methods like `activate`, `track`, and `is_feature_enabled` will be held in a queue until the configured batch size is reached, or the configured flush interval has elapsed. Then, they will be batched into a single payload and sent to the event dispatcher.\n * To configure event batching, set the `batch_size` and `flush_interval` properties when initializing instance of [BatchEventProcessor](https://github.com/optimizely/python-sdk/blob/3.3.x/optimizely/event/event_processor.py#L45).\n * Event batching is disabled by default. You can pass in instance of `BatchEventProcessor` when creating `Optimizely` instance to enable event batching.\n * Users can subscribe to `LogEvent` notification to be notified of whenever a payload consisting of a batch of user events is handed off to the event dispatcher to send to Optimizely's backend.\n* Introduced blocking timeout in `PollingConfigManager`. By default, calls to `get_config` will block for maximum of 10 seconds until config is available.\n\n### Bug Fixes:\n* Fixed incorrect log message when numeric metric is not used. ([#217](https://github.com/optimizely/python-sdk/pull/217))\n\n## 3.2.0\nAugust 27th, 2019\n\n### New Features:\n* Added support for automatic datafile management via [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151):\n * The [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151) is an implementation of the [BaseConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L32).\n * Users may provide one of datafile or SDK key (sdk_key) or both to `optimizely.Optimizely`. Based on that, the SDK will use the [StaticConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L73) or the [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151). Refer to the [README](README.md) for more instructions.\n * An initial datafile can be provided to the `PollingConfigManager` to bootstrap before making HTTP requests for the hosted datafile.\n * Requests for the datafile are made in a separate thread and are scheduled with fixed delay.\n * Configuration updates can be subscribed to by adding the OPTIMIZELY_CONFIG_UPDATE notification listener.\n* Introduced `Optimizely.get_feature_variable` API. ([#191](https://github.com/optimizely/python-sdk/pull/191))\n\n### Deprecated:\n\n* `NotificationCenter.clear_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))\n* `NotificationCenter.clear_all_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_all_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))\n\n## 3.2.0b1\nJuly 26th, 2019\n\n### New Features:\n* Added support for automatic datafile management via [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151):\n * The [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151) is an implementation of the [BaseConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L32).\n * Users may provide one of datafile or SDK key (sdk_key) or both to `optimizely.Optimizely`. Based on that, the SDK will use the [StaticConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L73) or the [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/3.2.x/optimizely/config_manager.py#L151). Refer to the [README](README.md) for more instructions.\n * An initial datafile can be provided to the `PollingConfigManager` to bootstrap before making HTTP requests for the hosted datafile.\n * Requests for the datafile are made in a separate thread and are scheduled with fixed delay.\n * Configuration updates can be subscribed to by adding the OPTIMIZELY_CONFIG_UPDATE notification listener.\n* Introduced `Optimizely.get_feature_variable` API. ([#191](https://github.com/optimizely/python-sdk/pull/191))\n\n### Deprecated:\n\n* `NotificationCenter.clear_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))\n* `NotificationCenter.clear_all_notifications` is deprecated as of this release. Please use `NotificationCenter.clear_all_notification_listeners`. ([#182](https://github.com/optimizely/python-sdk/pull/182))\n\n## 3.1.0\nMay 3rd, 2019\n\n### New Features:\n* Introduced Decision notification listener to be able to record:\n * Variation assignments for users activated in an experiment.\n * Feature access for users.\n * Feature variable value for users.\n\n### Bug Fixes:\n* Feature variable APIs now return default variable value when featureEnabled property is false. ([#171](https://github.com/optimizely/python-sdk/pull/171))\n\n### Deprecated:\n* Activate notification listener is deprecated as of this release. Recommendation is to use the new Decision notification listener. Activate notification listener will be removed in the next major release.\n\n## 3.0.0\nMarch 1st, 2019\n\nThe 3.0 release improves event tracking and supports additional audience\ntargeting functionality.\n\n### New Features:\n* Event tracking:\n * The `track` method now dispatches its conversion event *unconditionally*, without first determining whether the user is targeted by a known experiment that uses the event. This may increase outbound network traffic.\n * In Optimizely results, conversion events sent by 3.0 SDKs don\\'t explicitly name the experiments and variations that are currently targeted to the user. Instead, conversions are automatically attributed to variations that the user has previously seen, as long as those variations were served via 3.0 SDKs or by other clients capable of automatic attribution, and as long as our backend actually received the impression events for those variations.\n * Altogether, this allows you to track conversion events and attribute them to variations even when you don't know all of a user's attribute values, and even if the user's attribute values or the experiment's configuration have changed such that the user is no longer affected by the experiment. As a result, **you may observe an increase in the conversion rate for previously-instrumented events.** If that is undesirable, you can reset the results of previously-running experiments after upgrading to the 3.0 SDK. - This will also allow you to attribute events to variations from other Optimizely projects in your account, even though those experiments don't appear in the same datafile.\n * Note that for results segmentation in Optimizely results, the user attribute values from one event are automatically applied to all other events in the same session, as long as the events in question were actually received by our backend. This behavior was already in place and is not affected by the 3.0 release.\n* Support for all types of attribute values, not just strings.\n * All values are passed through to notification listeners.\n * Strings, booleans, and valid numbers are passed to the event dispatcher and can be used for Optimizely results segmentation. A valid number is a finite float or numbers.Integral in the inclusive range \\[-2 ^ 53, 2 ^ 53\\].\n * Strings, booleans, and valid numbers are relevant for audience conditions.\n* Support for additional matchers in audience conditions:\n * An `exists` matcher that passes if the user has a non-null value for the targeted user attribute and fails otherwise.\n * A `substring` matcher that resolves if the user has a string value for the targeted attribute.\n * `gt` (greater than) and `lt` (less than) matchers that resolve if the user has a valid number value for the targeted attribute. A valid number is a finite float or numbers.Integral in the inclusive range \\[-2 ^ 53, 2 ^ 53\\].\n * The original (`exact`) matcher can now be used to target booleans and valid numbers, not just strings.\n* Support for A/B tests, feature tests, and feature rollouts whose audiences are combined using `\"and\"` and `\"not\"` operators, not just the `\"or\"` operator.\n* Datafile-version compatibility check: The SDK will remain uninitialized (i.e., will gracefully fail to activate experiments and features) if given a datafile version greater than 4.\n* Updated Pull Request template and commit message guidelines.\n\n### Breaking Changes:\n* Conversion events sent by 3.0 SDKs don\\'t explicitly name the experiments and variations that are currently targeted to the user, so these events are unattributed in raw events data export. You must use the new *results* export to determine the variations to which events have been attributed.\n* Previously, notification listeners were only given string-valued user attributes because only strings could be passed into various method calls. That is no longer the case. You may pass non-string attribute values, and if you do, you must update your notification listeners to be able to receive whatever values you pass in.\n\n### Bug Fixes:\n* Experiments and features can no longer activate when a negatively targeted attribute has a missing, null, or malformed value.\n * Audience conditions (except for the new `exists` matcher) no longer resolve to `false` when they fail to find an legitimate value for the targeted user attribute. The result remains `null` (unknown). Therefore, an audience that negates such a condition (using the `\"not\"` operator) can no longer resolve to `true` unless there is an unrelated branch in the condition tree that itself resolves to `true`.\n* Updated the default event dispatcher to log an error if the request resolves to HTTP 4xx or 5xx. ([#140](https://github.com/optimizely/python-sdk/pull/140))\n* All methods now validate that user IDs are strings and that experiment keys, feature keys, feature variable keys, and event keys are non-empty strings.\n\n## 2.1.1\nAugust 21st, 2018\n\n* Fix: record conversions for all experiments using an event when using track([#136](https://github.com/optimizely/python-sdk/pull/136)).\n\n## 2.1.0\nJuly 2nd, 2018\n\n* Introduced support for bot filtering ([#121](https://github.com/optimizely/python-sdk/pull/121)).\n* Overhauled logging to use standard Python logging ([#123](https://github.com/optimizely/python-sdk/pull/123)).\n\n## 2.0.1\nJune 19th, 2018\n\n* Fix: send impression event for Feature Test when Feature is disabled ([#128](https://github.com/optimizely/python-sdk/pull/128)).\n\n## 2.0.0\nApril 12th, 2018\n\nThis major release introduces APIs for Feature Management. It also\nintroduces some breaking changes listed below.\n\n### New Features\n* Introduced the `is_feature_enabled` API to determine whether to show a feature to a user or not.\n\n```\n is_enabled = optimizel_client.is_feature_enabled('my_feature_key', 'my_user', user_attributes)\n```\n\n* All enabled features for the user can be retrieved by calling:\n\n```\n enabled_features = optimizely_client.get_enabled_features('my_user', user_attributes)\n```\n* Introduced Feature Variables to configure or parameterize a feature. There are four variable types: `String`, `Integer`, `Double`, `Boolean`.\n\n```\n string_variable = optimizely_client.get_feature_variable_string('my_feature_key', 'string_variable_key', 'my_user')\n integer_variable = optimizely_client.get_feature_variable_integer('my_feature_key', 'integer_variable_key', 'my_user')\n double_variable = optimizely_client.get_feature_variable_double('my_feature_key', 'double_variable_key', 'my_user')\n boolean_variable = optimizely_client.get_feature_variable_boolean('my_feature_key', 'boolean_variable_key', 'my_user')\n```\n\n### Breaking changes\n* The `track` API with revenue value as a stand-alone parameter has been removed. The revenue value should be passed in as an entry in the event tags dict. The key for the revenue tag is `revenue` and the passed in value will be treated by Optimizely as the value for computing results.\n\n```\n event_tags = {\n 'revenue': 1200\n }\n\n optimizely_client.track('event_key', 'my_user', user_attributes, event_tags)\n```\n\n## 2.0.0b1\nMarch 29th, 2018\n\nThis beta release introduces APIs for Feature Management. It also\nintroduces some breaking changes listed below.\n\n### New Features\n* Introduced the `is_feature_enabled` API to determine whether to show a feature to a user or not.\n```\n is_enabled = optimizel_client.is_feature_enabled('my_feature_key', 'my_user', user_attributes)\n```\n\n* All enabled features for the user can be retrieved by calling:\n\n```\n enabled_features = optimizely_client.get_enabled_features('my_user', user_attributes)\n```\n\n* Introduced Feature Variables to configure or parameterize a feature. There are four variable types: `String`, `Integer`, `Double`, `Boolean`.\n\n```\n string_variable = optimizely_client.get_feature_variable_string('my_feature_key', 'string_variable_key', 'my_user')\n integer_variable = optimizely_client.get_feature_variable_integer('my_feature_key', 'integer_variable_key', 'my_user')\n double_variable = optimizely_client.get_feature_variable_double('my_feature_key', 'double_variable_key', 'my_user')\n boolean_variable = optimizely_client.get_feature_variable_boolean('my_feature_key', 'boolean_variable_key', 'my_user')\n```\n\n### Breaking changes\n* The `track` API with revenue value as a stand-alone parameter has been removed. The revenue value should be passed in as an entry in the event tags dict. The key for the revenue tag is `revenue` and the passed in value will be treated by Optimizely as the value for computing results.\n\n```\n event_tags = {\n 'revenue': 1200\n }\n\n optimizely_client.track('event_key', 'my_user', user_attributes, event_tags)\n```\n\n## 1.4.0\n\n* Added support for IP anonymization.\n* Added support for notification listeners.\n* Added support for bucketing ID.\n* Updated mmh3 to handle installation failures on Windows 10.\n\n## 1.3.0\n\n* Introduced support for forced bucketing.\n* Introduced support for numeric metrics.\n* Updated event builder to support new endpoint.\n\n## 1.2.1\n\n* Removed older feature flag parsing.\n\n## 1.2.0\n\n* Added user profile service.\n\n## 1.1.1\n\n* Updated datafile parsing to be able to handle additional fields.\n* Deprecated Classic project support.\n\n## 1.1.0\n\n* Included datafile revision information in log events.\n* Added event tags to track API to allow users to pass in event metadata.\n* Deprecated the `event_value` parameter from the track method. Should use `event_tags` to pass in event value instead.\n* Updated event logging endpoint to logx.optimizely.com.\n\n## 1.0.0\n\n* Introduced support for Full Stack projects in Optimizely X. No breaking changes from previous version.\n* Introduced more graceful exception handling in instantiation and core methods.\n* Updated whitelisting to precede audience matching.\n\n## 0.1.3\n\n* Added support for v2 endpoint and datafile.\n* Updated dispatch_event to consume an Event object instead of url and params. The Event object comprises of four properties: url (string representing URL to dispatch event to), params (dict representing the params to be set for the event), http_verb (one of 'GET' or 'POST') and headers (header values to be sent along).\n* Fixed issue with tracking events for experiments in groups.\n\n## 0.1.2\n\n* Updated requirements file.\n\n## 0.1.1\n\n* Introduced option to skip JSON schema validation.\n\n## 0.1.0\n\n* Beta release of the Python SDK for server-side testing.\n",
"bugtrack_url": null,
"license": null,
"summary": "Python SDK for Optimizely Feature Experimentation, Optimizely Full Stack (legacy), and Optimizely Rollouts.",
"version": "5.0.1",
"project_urls": {
"Homepage": "https://github.com/optimizely/python-sdk"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "236e0d17b3f8ff1a6d04a79918a6191492ed34b8e079a9f59ef5b14b6d2a17dd",
"md5": "4fb25118112555e4ffdf6ce6f9d449cb",
"sha256": "45e3087a1d6bc2bcc5f8bc4633b447734cfcbd72a298ebeb636da5127704506a"
},
"downloads": -1,
"filename": "optimizely_sdk-5.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4fb25118112555e4ffdf6ce6f9d449cb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 140342,
"upload_time": "2024-06-26T21:33:04",
"upload_time_iso_8601": "2024-06-26T21:33:04.699504Z",
"url": "https://files.pythonhosted.org/packages/23/6e/0d17b3f8ff1a6d04a79918a6191492ed34b8e079a9f59ef5b14b6d2a17dd/optimizely_sdk-5.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e1c0d7148e843cae328438b341b1e76aab7391357a2f2735c99c04f4f62c1e6f",
"md5": "9b1a920580c7510c931f7664e59e8ae5",
"sha256": "2ec9e490cf013d53a1bb77ed9b86e0368cafb489a5c8de849560f64c956b5ddd"
},
"downloads": -1,
"filename": "optimizely-sdk-5.0.1.tar.gz",
"has_sig": false,
"md5_digest": "9b1a920580c7510c931f7664e59e8ae5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 110742,
"upload_time": "2024-06-26T21:33:06",
"upload_time_iso_8601": "2024-06-26T21:33:06.519370Z",
"url": "https://files.pythonhosted.org/packages/e1/c0/d7148e843cae328438b341b1e76aab7391357a2f2735c99c04f4f62c1e6f/optimizely-sdk-5.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-26 21:33:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "optimizely",
"github_project": "python-sdk",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "optimizely-sdk"
}
JSON
