deprecate stuff

Author: khvn26

flag_engine/engine.py

@@ -1,4 +1,5 @@
 import typing
+import warnings
 
 from flag_engine.context.mappers import (
     map_environment_identity_to_context,
@@ -28,6 +29,10 @@ def get_environment_feature_states(
 
     :param environment: the environment model object
     """
+    warnings.warn(
+        "`get_environment_feature_states` is deprecated, use `get_evaluation_result` instead.",
+        DeprecationWarning,
+    )
     if environment.get_hide_disabled_flags():
         return [fs for fs in environment.feature_states if fs.enabled]
     return environment.feature_states
@@ -42,6 +47,10 @@ def get_environment_feature_state(
     :param environment: the environment model object
     :param feature_name: the name of the feature to get the feature state for
     """
+    warnings.warn(
+        "`get_environment_feature_state` is deprecated, use `get_evaluation_result` instead.",
+        DeprecationWarning,
+    )
     try:
         return next(
             filter(lambda f: f.feature.name == feature_name, environment.feature_states)
@@ -65,6 +74,10 @@ def get_identity_feature_states(
     :return: list of feature state models based on the environment, any matching
         segments and any specific identity overrides
     """
+    warnings.warn(
+        "`get_identity_feature_states` is deprecated, use `get_evaluation_result` instead.",
+        DeprecationWarning,
+    )
     context = map_environment_identity_to_context(
         environment=environment,
         identity=identity,
@@ -96,6 +109,10 @@ def get_identity_feature_state(
     :return: feature state model based on the environment, any matching
         segments and any specific identity overrides
     """
+    warnings.warn(
+        "`get_identity_feature_state` is deprecated, use `get_evaluation_result` instead.",
+        DeprecationWarning,
+    )
     context = map_environment_identity_to_context(
         environment=environment,
         identity=identity,

flag_engine/segments/evaluator.py

@@ -1,6 +1,7 @@
 import operator
 import re
 import typing
+import warnings
 from contextlib import suppress
 from functools import partial, wraps
 
@@ -32,12 +33,16 @@ def get_identity_segments(
     environment: EnvironmentModel,
 ) -> typing.List[SegmentModel]:
     """
-    Get a list of segments for a given identity in a given environment.
+    DEPRECATED: Get a list of segments for a given identity in a given environment.
 
     :param identity: the identity model object to get the segments for
     :param environment: the environment model object the identity belongs to
     :return: list of segments that the identity belongs to in the environment
     """
+    warnings.warn(
+        "`get_identity_feature_states` is deprecated, use `get_evaluation_result` instead.",
+        DeprecationWarning,
+    )
     context = map_environment_identity_to_context(
         environment=environment,
         identity=identity,
@@ -53,11 +58,15 @@ def get_context_segments(
     context: EvaluationContext,
 ) -> typing.List[SegmentResult]:
     """
-    Get a list of segments for a given evaluation context.
+    DEPRECATED: Get a list of segments for a given evaluation context.
 
     :param context: the evaluation context
     :return: list of segments that match the context
     """
+    warnings.warn(
+        "`get_context_segments` is deprecated, use `get_evaluation_result` instead.",
+        DeprecationWarning,
+    )
     return get_evaluation_result(context)["segments"]