FeatureManagement 2.1.0__tar.gz → 2.2.0__tar.gz

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

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: FeatureManagement
-Version: 2.1.0
+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,20 +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"
-Dynamic: author
-Dynamic: home-page
+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
-Dynamic: requires-python
 
 # Microsoft Feature Management for Python
 

{featuremanagement-2.1.0 → 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
@@ -41,15 +34,6 @@ 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_targeting_accessor.py
-samples/feature_variant_sample_with_telemetry.py
-samples/formatted_feature_flags.json
-samples/quarty_sample.py
-samples/random_filter.py
-tests/__init__.py
 tests/test_default_feature_flags.py
 tests/test_default_feature_flags_async.py
 tests/test_feature_manager.py
@@ -57,8 +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/time_window_filter/test_recurrence_evaluator.py
-tests/time_window_filter/test_recurrence_validator.py
-tests/time_window_filter/test_time_window_filter_models.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.1.0 → featuremanagement-2.2.0}/FeatureManagement.egg-info/top_level.txt

@@ -1,2 +1 @@
 featuremanagement
-tests

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

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: FeatureManagement
-Version: 2.1.0
+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,20 +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"
-Dynamic: author
-Dynamic: home-page
+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
-Dynamic: requires-python
 
 # Microsoft Feature Management for Python
 

{featuremanagement-2.1.0 → 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.1.0 → featuremanagement-2.2.0}/featuremanagement/_defaultfilters.py

@@ -3,6 +3,8 @@
 # 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

{featuremanagement-2.1.0 → 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.1.0 → featuremanagement-2.2.0}/featuremanagement/_featuremanager.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Synchronous feature manager implementation."""
+
 import logging
 from typing import cast, overload, Any, Optional, Dict, Mapping, List, Tuple
 from ._defaultfilters import TimeWindowFilter, TargetingFilter

{featuremanagement-2.1.0 → 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, Callable
+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"
 
@@ -24,50 +25,6 @@ FEATURE_FILTER_PARAMETERS = "parameters"
 logger = logging.getLogger(__name__)
 
 
-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
-
-
 class FeatureManagerBase(ABC):
     """
     Base class for Feature Manager. This class is responsible for all shared logic between the sync and async.
@@ -272,7 +229,7 @@ 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)
@@ -299,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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → 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.1.0 → featuremanagement-2.2.0}/featuremanagement/_time_window_filter/__init__.py

@@ -3,6 +3,8 @@
 # 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
 

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/_time_window_filter/_models.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Data models for the time window filter."""
+
 from enum import Enum
 from typing import Dict, Any, Optional, List
 from datetime import datetime

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/_time_window_filter/_recurrence_evaluator.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Recurrence evaluation logic for the time window filter."""
+
 from datetime import datetime, timedelta
 from typing import Optional
 from ._models import RecurrencePatternType, RecurrenceRangeType, TimeWindowFilterSettings, OccurrenceInfo, Recurrence

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/_time_window_filter/_recurrence_validator.py

@@ -3,11 +3,12 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Validation logic for recurrence settings."""
+
 from datetime import datetime, timedelta
 from typing import List
 from ._models import RecurrencePatternType, RecurrenceRangeType, Recurrence, RecurrencePattern, RecurrenceRange
 
-
 DAYS_PER_WEEK = 7
 TEN_YEARS = 3650
 RECURRENCE_PATTERN = "Pattern"

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/_version.py

@@ -3,5 +3,6 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Package version."""
 
-VERSION = "2.1.0"
+VERSION = "2.2.0"

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/aio/__init__.py

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

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/aio/_defaultfilters.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Built-in async feature filter implementations."""
+
 from typing import Mapping, Any
 from ._featurefilters import FeatureFilter
 from .._defaultfilters import (

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/aio/_featurefilters.py

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

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/aio/_featuremanager.py

@@ -3,6 +3,8 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
+"""Async feature manager implementation."""
+
 import inspect
 import logging
 from typing import cast, overload, Any, Optional, Dict, Mapping, List, Tuple

{featuremanagement-2.1.0 → featuremanagement-2.2.0}/featuremanagement/azuremonitor/__init__.py

@@ -3,8 +3,9 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # -------------------------------------------------------------------------
-from ._send_telemetry import publish_telemetry, track_event, TargetingSpanProcessor
+"""Azure Monitor telemetry integration for feature management."""
 
+from ._send_telemetry import publish_telemetry, track_event, TargetingSpanProcessor
 
 __all__ = [
     "publish_telemetry",