FeatureManagement 2.0.0b3__tar.gz → 2.2.0__tar.gz

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0/FeatureManagement.egg-info}/PKG-INFO

@@ -1,9 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: FeatureManagement
-Version: 2.0.0b3
+Version: 2.2.0
 Summary: A library for enabling/disabling features at runtime.
-Home-page: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/feature-management
-Author: Microsoft Corporation
 Author-email: Microsoft Corporation <appconfig@microsoft.com>
 License:     MIT License
         
@@ -33,16 +31,33 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: License :: OSI Approved :: MIT License
-Requires-Python: >=3.6
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: azuremonitor
-Requires-Dist: azure-monitor-events-extension<2.0.0; extra == "azuremonitor"
+Requires-Dist: opentelemetry-sdk~=1.20; extra == "azuremonitor"
+Provides-Extra: test
+Requires-Dist: azure-monitor-opentelemetry<2.0.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest<10.0.0,>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov<8.0.0,>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio<2.0.0,>=0.21.0; extra == "dev"
+Requires-Dist: black<27.0.0,>=23.0.0; extra == "dev"
+Requires-Dist: pylint<5.0.0,>=3.0.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.0.0; extra == "dev"
+Requires-Dist: sphinx<10.0.0,>=7.0.0; extra == "dev"
+Requires-Dist: sphinx_rtd_theme<4.0.0,>=2.0.0; extra == "dev"
+Requires-Dist: sphinx-toolbox<5.0.0,>=3.0.0; extra == "dev"
+Requires-Dist: myst_parser<6.0.0,>=2.0.0; extra == "dev"
+Requires-Dist: opentelemetry-api~=1.20; extra == "dev"
+Requires-Dist: opentelemetry-sdk~=1.20; extra == "dev"
+Dynamic: license-file
 
 # Microsoft Feature Management for Python
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/FeatureManagement.egg-info/SOURCES.txt

@@ -1,16 +1,9 @@
-CHANGELOG.md
-CODE_OF_CONDUCT.md
 LICENSE
-MANIFEST.in
 README.md
-SECURITY.md
-SUPPORT.md
 pyproject.toml
-setup.py
 FeatureManagement.egg-info/PKG-INFO
 FeatureManagement.egg-info/SOURCES.txt
 FeatureManagement.egg-info/dependency_links.txt
-FeatureManagement.egg-info/not-zip-safe
 FeatureManagement.egg-info/requires.txt
 FeatureManagement.egg-info/top_level.txt
 featuremanagement/__init__.py
@@ -31,18 +24,16 @@ featuremanagement/_models/_telemetry.py
 featuremanagement/_models/_variant.py
 featuremanagement/_models/_variant_assignment_reason.py
 featuremanagement/_models/_variant_reference.py
+featuremanagement/_time_window_filter/__init__.py
+featuremanagement/_time_window_filter/_models.py
+featuremanagement/_time_window_filter/_recurrence_evaluator.py
+featuremanagement/_time_window_filter/_recurrence_validator.py
 featuremanagement/aio/__init__.py
 featuremanagement/aio/_defaultfilters.py
 featuremanagement/aio/_featurefilters.py
 featuremanagement/aio/_featuremanager.py
 featuremanagement/azuremonitor/__init__.py
 featuremanagement/azuremonitor/_send_telemetry.py
-samples/feature_flag_sample.py
-samples/feature_flag_with_azure_app_configuration_sample.py
-samples/feature_variant_sample.py
-samples/feature_variant_sample_with_telemetry.py
-samples/formatted_feature_flags.json
-samples/random_filter.py
 tests/test_default_feature_flags.py
 tests/test_default_feature_flags_async.py
 tests/test_feature_manager.py
@@ -50,5 +41,4 @@ tests/test_feature_manager_async.py
 tests/test_feature_manager_refresh.py
 tests/test_feature_variants.py
 tests/test_feature_variants_async.py
-tests/test_send_telemetry_appinsights.py
-tests/validation_tests/test_json_validations.py
+tests/test_send_telemetry_appinsights.py

featuremanagement-2.2.0/FeatureManagement.egg-info/requires.txt

@@ -0,0 +1,20 @@
+
+[AzureMonitor]
+opentelemetry-sdk~=1.20
+
+[dev]
+pytest<10.0.0,>=7.0.0
+pytest-cov<8.0.0,>=4.0.0
+pytest-asyncio<2.0.0,>=0.21.0
+black<27.0.0,>=23.0.0
+pylint<5.0.0,>=3.0.0
+mypy<2.0.0,>=1.0.0
+sphinx<10.0.0,>=7.0.0
+sphinx_rtd_theme<4.0.0,>=2.0.0
+sphinx-toolbox<5.0.0,>=3.0.0
+myst_parser<6.0.0,>=2.0.0
+opentelemetry-api~=1.20
+opentelemetry-sdk~=1.20
+
+[test]
+azure-monitor-opentelemetry<2.0.0

{featuremanagement-2.0.0b3/FeatureManagement.egg-info → featuremanagement-2.2.0}/PKG-INFO

@@ -1,9 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: FeatureManagement
-Version: 2.0.0b3
+Version: 2.2.0
 Summary: A library for enabling/disabling features at runtime.
-Home-page: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/feature-management
-Author: Microsoft Corporation
 Author-email: Microsoft Corporation <appconfig@microsoft.com>
 License:     MIT License
         
@@ -33,16 +31,33 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: License :: OSI Approved :: MIT License
-Requires-Python: >=3.6
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: azuremonitor
-Requires-Dist: azure-monitor-events-extension<2.0.0; extra == "azuremonitor"
+Requires-Dist: opentelemetry-sdk~=1.20; extra == "azuremonitor"
+Provides-Extra: test
+Requires-Dist: azure-monitor-opentelemetry<2.0.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest<10.0.0,>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov<8.0.0,>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio<2.0.0,>=0.21.0; extra == "dev"
+Requires-Dist: black<27.0.0,>=23.0.0; extra == "dev"
+Requires-Dist: pylint<5.0.0,>=3.0.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.0.0; extra == "dev"
+Requires-Dist: sphinx<10.0.0,>=7.0.0; extra == "dev"
+Requires-Dist: sphinx_rtd_theme<4.0.0,>=2.0.0; extra == "dev"
+Requires-Dist: sphinx-toolbox<5.0.0,>=3.0.0; extra == "dev"
+Requires-Dist: myst_parser<6.0.0,>=2.0.0; extra == "dev"
+Requires-Dist: opentelemetry-api~=1.20; extra == "dev"
+Requires-Dist: opentelemetry-sdk~=1.20; extra == "dev"
+Dynamic: license-file
 
 # Microsoft Feature Management for Python
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/__init__.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Feature management library for Python."""
+
 from ._featuremanager import FeatureManager
 from ._featurefilters import FeatureFilter
 from ._defaultfilters import TimeWindowFilter, TargetingFilter

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_defaultfilters.py

@@ -3,12 +3,15 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Built-in feature filter implementations."""
+
 import logging
 import hashlib
 from datetime import datetime, timezone
 from email.utils import parsedate_to_datetime
 from typing import cast, List, Mapping, Optional, Dict, Any
 from ._featurefilters import FeatureFilter
+from ._time_window_filter import Recurrence, is_match, TimeWindowFilterSettings
 
 FEATURE_FLAG_NAME_KEY = "feature_name"
 ROLLOUT_PERCENTAGE_KEY = "RolloutPercentage"
@@ -18,6 +21,15 @@ PARAMETERS_KEY = "parameters"
 # Time Window Constants
 START_KEY = "Start"
 END_KEY = "End"
+TIME_WINDOW_FILTER_SETTING_RECURRENCE = "Recurrence"
+
+# Time Window Exceptions
+TIME_WINDOW_FILTER_INVALID = (
+    "{}: The {} feature filter is not valid for feature {}. It must specify either {}, {}, or both."
+)
+TIME_WINDOW_FILTER_INVALID_RECURRENCE = (
+    "{}: The {} feature filter is not valid for feature {}. It must specify both {} and {} when Recurrence is not None."
+)
 
 # Targeting kwargs
 TARGETED_USER_KEY = "user"
@@ -31,6 +43,8 @@ EXCLUSION_KEY = "Exclusion"
 FEATURE_FILTER_NAME_KEY = "Name"
 IGNORE_CASE_KEY = "ignore_case"
 
+logger = logging.getLogger(__name__)
+
 
 class TargetingException(Exception):
     """
@@ -52,19 +66,35 @@ class TimeWindowFilter(FeatureFilter):
         :return: True if the current time is within the time window.
         :rtype: bool
         """
-        start = context.get(PARAMETERS_KEY, {}).get(START_KEY)
-        end = context.get(PARAMETERS_KEY, {}).get(END_KEY)
+        start = context.get(PARAMETERS_KEY, {}).get(START_KEY, None)
+        end = context.get(PARAMETERS_KEY, {}).get(END_KEY, None)
+        recurrence_data = context.get(PARAMETERS_KEY, {}).get(TIME_WINDOW_FILTER_SETTING_RECURRENCE, None)
+        recurrence = None
 
         current_time = datetime.now(timezone.utc)
 
         if not start and not end:
-            logging.warning("%s: At least one of Start or End is required.", TimeWindowFilter.__name__)
+            logger.warning(
+                TIME_WINDOW_FILTER_INVALID,
+                TimeWindowFilter.__name__,
+                context.get(FEATURE_FLAG_NAME_KEY),
+                START_KEY,
+                END_KEY,
+            )
             return False
 
-        start_time = parsedate_to_datetime(start) if start else None
-        end_time = parsedate_to_datetime(end) if end else None
+        start_time: Optional[datetime] = parsedate_to_datetime(start) if start else None
+        end_time: Optional[datetime] = parsedate_to_datetime(end) if end else None
+
+        if (start_time is None or start_time <= current_time) and (end_time is None or current_time < end_time):
+            return True
+
+        if recurrence_data:
+            recurrence = Recurrence(recurrence_data)
+            settings = TimeWindowFilterSettings(start_time, end_time, recurrence)
+            return is_match(settings, current_time)
 
-        return (start_time is None or start_time <= current_time) and (end_time is None or current_time < end_time)
+        return False
 
 
 @FeatureFilter.alias("Microsoft.Targeting")

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_featurefilters.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Base class for feature filters."""
+
 from abc import ABC, abstractmethod
 from typing import Mapping, Callable, Any, Optional
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_featuremanager.py

@@ -3,7 +3,10 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
-from typing import cast, overload, Any, Optional, Dict, Mapping, List
+"""Synchronous feature manager implementation."""
+
+import logging
+from typing import cast, overload, Any, Optional, Dict, Mapping, List, Tuple
 from ._defaultfilters import TimeWindowFilter, TargetingFilter
 from ._featurefilters import FeatureFilter
 from ._models import EvaluationEvent, Variant, TargetingContext
@@ -14,6 +17,8 @@ from ._featuremanagerbase import (
     FEATURE_FILTER_NAME,
 )
 
+logger = logging.getLogger(__name__)
+
 
 class FeatureManager(FeatureManagerBase):
     """
@@ -23,6 +28,8 @@ class FeatureManager(FeatureManagerBase):
     :keyword list[FeatureFilter] feature_filters: Custom filters to be used for evaluating feature flags.
     :keyword Callable[EvaluationEvent] on_feature_evaluated: Callback function to be called when a feature flag is
     evaluated.
+    :keyword Callable[[], TargetingContext] targeting_context_accessor: Callback function to get the current targeting
+    context if one isn't provided.
     """
 
     def __init__(self, configuration: Mapping[str, Any], **kwargs: Any):
@@ -56,7 +63,7 @@ class FeatureManager(FeatureManagerBase):
         :return: True if the feature flag is enabled for the given context.
         :rtype: bool
         """
-        targeting_context = self._build_targeting_context(args)
+        targeting_context: TargetingContext = self._build_targeting_context(args)
 
         result = self._check_feature(feature_flag_id, targeting_context, **kwargs)
         if (
@@ -89,7 +96,7 @@ class FeatureManager(FeatureManagerBase):
         :return: Variant instance.
         :rtype: Variant
         """
-        targeting_context = self._build_targeting_context(args)
+        targeting_context: TargetingContext = self._build_targeting_context(args)
 
         result = self._check_feature(feature_flag_id, targeting_context, **kwargs)
         if (
@@ -102,6 +109,21 @@ class FeatureManager(FeatureManagerBase):
             self._on_feature_evaluated(result)
         return result.variant
 
+    def _build_targeting_context(self, args: Tuple[Any]) -> TargetingContext:
+        targeting_context = super()._build_targeting_context(args)
+        if targeting_context:
+            return targeting_context
+        if not targeting_context and self._targeting_context_accessor and callable(self._targeting_context_accessor):
+            targeting_context = self._targeting_context_accessor()
+            if targeting_context and isinstance(targeting_context, TargetingContext):
+                return targeting_context
+            logger.warning(
+                "targeting_context_accessor did not return a TargetingContext. Received type %s.",
+                type(targeting_context),
+            )
+
+        return TargetingContext()
+
     def _check_feature_filters(
         self, evaluation_event: EvaluationEvent, targeting_context: TargetingContext, **kwargs: Any
     ) -> None:

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_featuremanagerbase.py

@@ -3,13 +3,14 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Base class for feature manager implementations."""
+
 import hashlib
 import logging
 from abc import ABC
-from typing import List, Optional, Dict, Tuple, Any, Mapping
+from typing import List, Optional, Dict, Tuple, Any, Mapping, Callable, cast
 from ._models import FeatureFlag, Variant, VariantAssignmentReason, TargetingContext, EvaluationEvent, VariantReference
 
-
 FEATURE_MANAGEMENT_KEY = "feature_management"
 FEATURE_FLAG_KEY = "feature_flags"
 
@@ -21,48 +22,7 @@ REQUIREMENT_TYPE_ANY = "Any"
 FEATURE_FILTER_PARAMETERS = "parameters"
 
 
-def _get_feature_flag(configuration: Mapping[str, Any], feature_flag_name: str) -> Optional[FeatureFlag]:
-    """
-    Gets the FeatureFlag json from the configuration, if it exists it gets converted to a FeatureFlag object.
-
-    :param Mapping configuration: Configuration object.
-    :param str feature_flag_name: Name of the feature flag.
-    :return: FeatureFlag
-    :rtype: FeatureFlag
-    """
-    feature_management = configuration.get(FEATURE_MANAGEMENT_KEY)
-    if not feature_management or not isinstance(feature_management, Mapping):
-        return None
-    feature_flags = feature_management.get(FEATURE_FLAG_KEY)
-    if not feature_flags or not isinstance(feature_flags, list):
-        return None
-
-    for feature_flag in feature_flags:
-        if feature_flag.get("id") == feature_flag_name:
-            return FeatureFlag.convert_from_json(feature_flag)
-
-    return None
-
-
-def _list_feature_flag_names(configuration: Mapping[str, Any]) -> List[str]:
-    """
-    List of all feature flag names.
-
-    :param Mapping configuration: Configuration object.
-    :return: List of feature flag names.
-    """
-    feature_flag_names = []
-    feature_management = configuration.get(FEATURE_MANAGEMENT_KEY)
-    if not feature_management or not isinstance(feature_management, Mapping):
-        return []
-    feature_flags = feature_management.get(FEATURE_FLAG_KEY)
-    if not feature_flags or not isinstance(feature_flags, list):
-        return []
-
-    for feature_flag in feature_flags:
-        feature_flag_names.append(feature_flag.get("id"))
-
-    return feature_flag_names
+logger = logging.getLogger(__name__)
 
 
 class FeatureManagerBase(ABC):
@@ -77,6 +37,9 @@ class FeatureManagerBase(ABC):
         self._cache: Dict[str, Optional[FeatureFlag]] = {}
         self._copy = configuration.get(FEATURE_MANAGEMENT_KEY)
         self._on_feature_evaluated = kwargs.pop("on_feature_evaluated", None)
+        self._targeting_context_accessor: Optional[Callable[[], TargetingContext]] = kwargs.pop(
+            "targeting_context_accessor", None
+        )
 
     @staticmethod
     def _assign_default_disabled_variant(evaluation_event: EvaluationEvent) -> None:
@@ -218,7 +181,7 @@ class FeatureManagerBase(ABC):
                 return Variant(variant_reference.name, variant_reference.configuration_value)
         return None
 
-    def _build_targeting_context(self, args: Tuple[Any]) -> TargetingContext:
+    def _build_targeting_context(self, args: Tuple[Any]) -> Optional[TargetingContext]:
         """
         Builds a TargetingContext, either returns a provided context, takes the provided user_id to make a context, or
         returns an empty context.
@@ -229,10 +192,12 @@ class FeatureManagerBase(ABC):
         if len(args) == 1:
             arg = args[0]
             if isinstance(arg, str):
+                # If the user_id is provided, return a TargetingContext with the user_id
                 return TargetingContext(user_id=arg, groups=[])
             if isinstance(arg, TargetingContext):
+                # If a TargetingContext is provided, return it
                 return arg
-        return TargetingContext()
+        return None
 
     def _assign_allocation(self, evaluation_event: EvaluationEvent, targeting_context: TargetingContext) -> None:
         feature_flag = evaluation_event.feature
@@ -264,14 +229,14 @@ class FeatureManagerBase(ABC):
             self._copy = self._configuration.get(FEATURE_MANAGEMENT_KEY)
 
         if not self._cache.get(feature_flag_id):
-            feature_flag = _get_feature_flag(self._configuration, feature_flag_id)
+            feature_flag = self._get_feature_flag(feature_flag_id)
             self._cache[feature_flag_id] = feature_flag
         else:
             feature_flag = self._cache.get(feature_flag_id)
 
         evaluation_event = EvaluationEvent(feature_flag)
         if not feature_flag:
-            logging.warning("Feature flag %s not found", feature_flag_id)
+            logger.warning("Feature flag %s not found", feature_flag_id)
             # Unknown feature flags are disabled by default
             return evaluation_event, True
 
@@ -291,4 +256,41 @@ class FeatureManagerBase(ABC):
         """
         List of all feature flag names.
         """
-        return _list_feature_flag_names(self._configuration)
+        feature_flag_names: Dict[str, None] = {}
+        for feature_flag in self._get_feature_flags():
+            feature_flag_name = feature_flag.get("id")
+            # Only include entries with a valid string id; duplicates are listed once.
+            if isinstance(feature_flag_name, str):
+                feature_flag_names[feature_flag_name] = None
+
+        return list(feature_flag_names)
+
+    def _get_feature_flag(self, feature_flag_name: str) -> Optional[FeatureFlag]:
+        """
+        Gets the FeatureFlag json from the configuration, if it exists it gets converted to a FeatureFlag object.
+
+        :param str feature_flag_name: Name of the feature flag.
+        :return: FeatureFlag
+        :rtype: FeatureFlag
+        """
+        for feature_flag in reversed(self._get_feature_flags()):
+            # If multiple feature flags share the same id, the last one defined wins.
+            if feature_flag.get("id") == feature_flag_name:
+                return FeatureFlag.convert_from_json(feature_flag)
+
+        return None
+
+    def _get_feature_flags(self) -> List[Any]:
+        """
+        Gets the list of raw feature flag definitions from the configuration.
+
+        :return: List of feature flag definitions, or an empty list if none are configured.
+        :rtype: list
+        """
+        feature_management = self._configuration.get(FEATURE_MANAGEMENT_KEY)
+        if not feature_management or not isinstance(feature_management, Mapping):
+            return []
+        feature_flags = feature_management.get(FEATURE_FLAG_KEY)
+        if not feature_flags or not isinstance(feature_flags, list):
+            return []
+        return cast(List[Any], feature_flags)

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/__init__.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Data models for feature management."""
+
 from ._feature_flag import FeatureFlag
 from ._variant import Variant
 from ._evaluation_event import EvaluationEvent

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_allocation.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Allocation model for feature variant assignment."""
+
 from typing import cast, List, Optional, Mapping, Dict, Any, Union
 from dataclasses import dataclass
 from ._constants import DEFAULT_WHEN_ENABLED, DEFAULT_WHEN_DISABLED, USER, GROUP, PERCENTILE, SEED

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_constants.py

@@ -3,6 +3,7 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Constants used by feature management models."""
 
 # Feature Flag
 FEATURE_FLAG_ID = "id"

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_evaluation_event.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Evaluation event model for feature flag telemetry."""
+
 from dataclasses import dataclass
 from typing import Optional
 from ._feature_flag import FeatureFlag

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_feature_conditions.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Feature flag condition models."""
+
 from collections.abc import Mapping
 from typing import Any, Dict, List
 from ._constants import (

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_feature_flag.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Feature flag model."""
+
 from typing import cast, List, Union, Optional, Mapping, Any
 from ._feature_conditions import FeatureConditions
 from ._allocation import Allocation

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_targeting_context.py

@@ -3,6 +3,7 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # --------------------------------------------------------------------------
+"""Targeting context model for user and group targeting."""
 
 from typing import NamedTuple, List
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_telemetry.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Telemetry metadata model."""
+
 from typing import Dict
 from dataclasses import dataclass, field
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_variant.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Variant model representing a feature flag variant."""
+
 from typing import Any
 
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_variant_assignment_reason.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Enum for variant assignment reasons."""
+
 from enum import Enum
 
 

{featuremanagement-2.0.0b3 → featuremanagement-2.2.0}/featuremanagement/_models/_variant_reference.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Variant reference model."""
+
 from dataclasses import dataclass
 from typing import Optional, Mapping, Any
 from ._constants import VARIANT_REFERENCE_NAME, CONFIGURATION_VALUE, STATUS_OVERRIDE

featuremanagement-2.2.0/featuremanagement/_time_window_filter/__init__.py

@@ -0,0 +1,11 @@
+# ------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# -------------------------------------------------------------------------
+"""Time window filter with recurrence support."""
+
+from ._recurrence_evaluator import is_match
+from ._models import Recurrence, TimeWindowFilterSettings
+
+__all__ = ["is_match", "Recurrence", "TimeWindowFilterSettings"]