feat: add decide api

.travis.yml

@@ -8,6 +8,9 @@ python:
 # - "3.8" is handled in 'Test' job using xenial as Python 3.8 is not available for trusty.
   - "pypy"
   - "pypy3"
+before_install:
+  - sudo apt-get --auto-remove --yes remove python-openssl
+  - sudo pip install pyOpenSSL
 install: "pip install -r requirements/core.txt;pip install -r requirements/test.txt"
 script: "pytest --cov=optimizely"
 after_success:

optimizely/decision/__init__.py

@@ -0,0 +1,12 @@
+# Copyright 2020, Optimizely
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

optimizely/decision/decide_option.py

@@ -0,0 +1,20 @@
+# Copyright 2020, Optimizely
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class DecideOption(object):
+    DISABLE_DECISION_EVENT = 'DISABLE_DECISION_EVENT'
+    ENABLED_FLAGS_ONLY = 'ENABLED_FLAGS_ONLY'
+    IGNORE_USER_PROFILE_SERVICE = 'IGNORE_USER_PROFILE_SERVICE'
+    INCLUDE_REASONS = 'INCLUDE_REASONS'
+    EXCLUDE_VARIABLES = 'EXCLUDE_VARIABLES'

optimizely/decision/decision.py

@@ -0,0 +1,24 @@
+# Copyright 2020, Optimizely
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class Decision(object):
+    def __init__(self, variation_key=None, enabled=None,
+                 variables=None, rule_key=None, flag_key=None, user_context=None, reasons=None):
+        self.variation_key = variation_key
+        self.enabled = enabled or False
+        self.variables = variables or {}
+        self.rule_key = rule_key
+        self.flag_key = flag_key
+        self.user_context = user_context
+        self.reasons = reasons or []

optimizely/decision/decision_message.py

@@ -0,0 +1,18 @@
+# Copyright 2020, Optimizely
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class DecisionMessage(object):
+    SDK_NOT_READY = 'Optimizely SDK not configured properly yet.'
+    FLAG_KEY_INVALID = 'No flag was found for key "%s".'
+    VARIABLE_VALUE_INVALID = 'Variable value for key "%s" is invalid or wrong type.'

optimizely/decision_service.py

@@ -301,6 +301,7 @@ def get_variation_for_rollout(self, project_config, rollout, user_id, attributes
       rollout: Rollout for which we are getting the variation.
       user_id: ID for user.
       attributes: Dict representing user attributes.
+      ignore_user_profile: True if we should bypass the user profile service
 
     Returns:
       Decision namedtuple consisting of experiment and variation for the user.
@@ -390,14 +391,15 @@ def get_experiment_in_group(self, project_config, group, bucketing_id):
 
         return None
 
-    def get_variation_for_feature(self, project_config, feature, user_id, attributes=None):
+    def get_variation_for_feature(self, project_config, feature, user_id, attributes=None, ignore_user_profile=False):
         """ Returns the experiment/variation the user is bucketed in for the given feature.
 
     Args:
       project_config: Instance of ProjectConfig.
       feature: Feature for which we are determining if it is enabled or not for the given user.
       user_id: ID for user.
       attributes: Dict representing user attributes.
+      ignore_user_profile: True if you want to bypass the user profile service
 
     Returns:
       Decision namedtuple consisting of experiment and variation for the user.
@@ -411,7 +413,7 @@ def get_variation_for_feature(self, project_config, feature, user_id, attributes
             if group:
                 experiment = self.get_experiment_in_group(project_config, group, bucketing_id)
                 if experiment and experiment.id in feature.experimentIds:
-                    variation = self.get_variation(project_config, experiment, user_id, attributes)
+                    variation = self.get_variation(project_config, experiment, user_id, attributes, ignore_user_profile)
 
                     if variation:
                         return Decision(experiment, variation, enums.DecisionSources.FEATURE_TEST)
@@ -423,7 +425,7 @@ def get_variation_for_feature(self, project_config, feature, user_id, attributes
             # If an experiment is not in a group, then the feature can only be associated with one experiment
             experiment = project_config.get_experiment_from_id(feature.experimentIds[0])
             if experiment:
-                variation = self.get_variation(project_config, experiment, user_id, attributes)
+                variation = self.get_variation(project_config, experiment, user_id, attributes, ignore_user_profile)
 
                 if variation:
                     return Decision(experiment, variation, enums.DecisionSources.FEATURE_TEST)