FeatureManagement 1.0.0__tar.gz

featuremanagement-1.0.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Release History
+
+## 1.0.0 (06/26/2024)
+
+Updated version to 1.0.0.
+
+## 1.0.0b1 (05/22/2024)
+
+New Feature Management library.
+
+Provides the ability to manage feature flags in a project. Enables:
+
+* Loading of feature flags from a file, see: https://github.com/Azure/AppConfiguration/blob/main/docs/FeatureManagement/FeatureManagement.v2.0.0.schema.json
+* Loading of feature flags from Azure App Configuration.
+* Checking if a feature is enabled.
+* Default feature filters: TimeWindowFilter, TargetingFilter.
+* Custom feature filters.

featuremanagement-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,9 @@
+# Microsoft Open Source Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+
+Resources:
+
+- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
+- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
+- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns

featuremanagement-1.0.0/FeatureManagement.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.1
+Name: FeatureManagement
+Version: 1.0.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
+        
+            Copyright (c) Microsoft Corporation.
+        
+            Permission is hereby granted, free of charge, to any person obtaining a copy
+            of this software and associated documentation files (the "Software"), to deal
+            in the Software without restriction, including without limitation the rights
+            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+            copies of the Software, and to permit persons to whom the Software is
+            furnished to do so, subject to the following conditions:
+        
+            The above copyright notice and this permission notice shall be included in all
+            copies or substantial portions of the Software.
+        
+            THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+            SOFTWARE
+        
+Project-URL: Homepage, https://github.com/microsoft/FeatureManagement-Python
+Project-URL: Issues, https://github.com/microsoft/FeatureManagement-Python/issues
+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: License :: OSI Approved :: MIT License
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: appinsights
+Requires-Dist: azure-monitor-opentelemetry<2.0.0,>=1.3.0; extra == "appinsights"
+Requires-Dist: azure-monitor-events-extension<2.0.0; extra == "appinsights"
+
+# Microsoft Feature Management for Python
+
+[![FeatureManagement](https://img.shields.io/pypi/v/FeatureManagement?label=FeatureManagement)](https://pypi.org/project/FeatureManagement/)
+
+Feature management provides a way to develop and expose application functionality based on features. Many applications have special requirements when a new feature is developed such as when the feature should be enabled and under what conditions. This library provides a way to define these relationships, and also integrates into common Python code patterns to make exposing these features possible.
+
+## Get Started
+
+[Quickstart](https://learn.microsoft.com/azure/azure-app-configuration/quickstart-feature-flag-python): A quickstart guide is available to learn how to integrate feature flags from Azure App Configuration into your Python applications.
+
+[API Reference](https://microsoft.github.io/FeatureManagement-Python/): This API reference details the API surface of the libraries contained within this repository.
+
+## Examples
+
+* [Python Application](https://github.com/microsoft/FeatureManagement-Python/blob/main/samples/feature_flag_sample.py)
+* [Python Application with Azure App Configuration](https://github.com/microsoft/FeatureManagement-Python/blob/main/samples/feature_flag_with_azure_app_configuration_sample.py)
+* [Django Application](https://github.com/Azure/AppConfiguration/tree/main/examples/Python/python-django-webapp-sample)
+* [Flask Application](https://github.com/Azure/AppConfiguration/tree/main/examples/Python/python-flask-webapp-sample)
+
+## Contributing
+
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
+trademarks or logos is subject to and must follow 
+[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
+Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
+Any use of third-party trademarks or logos are subject to those third-party's policies.

featuremanagement-1.0.0/FeatureManagement.egg-info/SOURCES.txt

@@ -0,0 +1,41 @@
+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
+featuremanagement/_defaultfilters.py
+featuremanagement/_featurefilters.py
+featuremanagement/_featuremanager.py
+featuremanagement/_version.py
+featuremanagement/py.typed
+featuremanagement/_models/__init__.py
+featuremanagement/_models/_constants.py
+featuremanagement/_models/_evaluation_event.py
+featuremanagement/_models/_feature_conditions.py
+featuremanagement/_models/_feature_flag.py
+featuremanagement/_models/_targeting_context.py
+featuremanagement/aio/__init__.py
+featuremanagement/aio/_defaultfilters.py
+featuremanagement/aio/_featurefilters.py
+featuremanagement/aio/_featuremanager.py
+samples/feature_flag_sample.py
+samples/feature_flag_with_azure_app_configuration_sample.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
+tests/test_feature_manager_async.py
+tests/test_feature_manager_refresh.py
+tests/validation_tests/test_json_validations.py

featuremanagement-1.0.0/FeatureManagement.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

featuremanagement-1.0.0/FeatureManagement.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,4 @@
+
+[AppInsights]
+azure-monitor-opentelemetry<2.0.0,>=1.3.0
+azure-monitor-events-extension<2.0.0

featuremanagement-1.0.0/FeatureManagement.egg-info/top_level.txt

@@ -0,0 +1 @@
+featuremanagement

featuremanagement-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

featuremanagement-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+recursive-include tests *.py
+include *.md
+include LICENSE
+include featuremanagement/*.py
+include featuremanagement/aio/*.py
+recursive-include samples *.py *.json

featuremanagement-1.0.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.1
+Name: FeatureManagement
+Version: 1.0.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
+        
+            Copyright (c) Microsoft Corporation.
+        
+            Permission is hereby granted, free of charge, to any person obtaining a copy
+            of this software and associated documentation files (the "Software"), to deal
+            in the Software without restriction, including without limitation the rights
+            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+            copies of the Software, and to permit persons to whom the Software is
+            furnished to do so, subject to the following conditions:
+        
+            The above copyright notice and this permission notice shall be included in all
+            copies or substantial portions of the Software.
+        
+            THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+            SOFTWARE
+        
+Project-URL: Homepage, https://github.com/microsoft/FeatureManagement-Python
+Project-URL: Issues, https://github.com/microsoft/FeatureManagement-Python/issues
+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: License :: OSI Approved :: MIT License
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: appinsights
+Requires-Dist: azure-monitor-opentelemetry<2.0.0,>=1.3.0; extra == "appinsights"
+Requires-Dist: azure-monitor-events-extension<2.0.0; extra == "appinsights"
+
+# Microsoft Feature Management for Python
+
+[![FeatureManagement](https://img.shields.io/pypi/v/FeatureManagement?label=FeatureManagement)](https://pypi.org/project/FeatureManagement/)
+
+Feature management provides a way to develop and expose application functionality based on features. Many applications have special requirements when a new feature is developed such as when the feature should be enabled and under what conditions. This library provides a way to define these relationships, and also integrates into common Python code patterns to make exposing these features possible.
+
+## Get Started
+
+[Quickstart](https://learn.microsoft.com/azure/azure-app-configuration/quickstart-feature-flag-python): A quickstart guide is available to learn how to integrate feature flags from Azure App Configuration into your Python applications.
+
+[API Reference](https://microsoft.github.io/FeatureManagement-Python/): This API reference details the API surface of the libraries contained within this repository.
+
+## Examples
+
+* [Python Application](https://github.com/microsoft/FeatureManagement-Python/blob/main/samples/feature_flag_sample.py)
+* [Python Application with Azure App Configuration](https://github.com/microsoft/FeatureManagement-Python/blob/main/samples/feature_flag_with_azure_app_configuration_sample.py)
+* [Django Application](https://github.com/Azure/AppConfiguration/tree/main/examples/Python/python-django-webapp-sample)
+* [Flask Application](https://github.com/Azure/AppConfiguration/tree/main/examples/Python/python-flask-webapp-sample)
+
+## Contributing
+
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
+trademarks or logos is subject to and must follow 
+[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
+Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
+Any use of third-party trademarks or logos are subject to those third-party's policies.

featuremanagement-1.0.0/README.md

@@ -0,0 +1,40 @@
+# Microsoft Feature Management for Python
+
+[![FeatureManagement](https://img.shields.io/pypi/v/FeatureManagement?label=FeatureManagement)](https://pypi.org/project/FeatureManagement/)
+
+Feature management provides a way to develop and expose application functionality based on features. Many applications have special requirements when a new feature is developed such as when the feature should be enabled and under what conditions. This library provides a way to define these relationships, and also integrates into common Python code patterns to make exposing these features possible.
+
+## Get Started
+
+[Quickstart](https://learn.microsoft.com/azure/azure-app-configuration/quickstart-feature-flag-python): A quickstart guide is available to learn how to integrate feature flags from Azure App Configuration into your Python applications.
+
+[API Reference](https://microsoft.github.io/FeatureManagement-Python/): This API reference details the API surface of the libraries contained within this repository.
+
+## Examples
+
+* [Python Application](https://github.com/microsoft/FeatureManagement-Python/blob/main/samples/feature_flag_sample.py)
+* [Python Application with Azure App Configuration](https://github.com/microsoft/FeatureManagement-Python/blob/main/samples/feature_flag_with_azure_app_configuration_sample.py)
+* [Django Application](https://github.com/Azure/AppConfiguration/tree/main/examples/Python/python-django-webapp-sample)
+* [Flask Application](https://github.com/Azure/AppConfiguration/tree/main/examples/Python/python-flask-webapp-sample)
+
+## Contributing
+
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
+trademarks or logos is subject to and must follow 
+[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
+Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
+Any use of third-party trademarks or logos are subject to those third-party's policies.

featuremanagement-1.0.0/SECURITY.md

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.9 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) and [Xamarin](https://github.com/xamarin).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/security.md/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).
+
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/security.md/msrc/pgp).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/security.md/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

featuremanagement-1.0.0/SUPPORT.md

@@ -0,0 +1,25 @@
+# TODO: The maintainer of this repo has not yet edited this file
+
+**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
+
+- **No CSS support:** Fill out this template with information about how to file issues and get help.
+- **Yes CSS support:** Fill out an intake form at [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS will work with/help you to determine next steps.
+- **Not sure?** Fill out an intake as though the answer were "Yes". CSS will help you decide.
+
+*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
+
+# Support
+
+## How to file issues and get help  
+
+This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
+issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
+feature request as a new Issue.
+
+For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
+FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
+CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
+
+## Microsoft Support Policy  
+
+Support for this **PROJECT or PRODUCT** is limited to the resources listed above.

featuremanagement-1.0.0/featuremanagement/__init__.py

@@ -0,0 +1,20 @@
+# ------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# -------------------------------------------------------------------------
+from ._featuremanager import FeatureManager
+from ._featurefilters import FeatureFilter
+from ._defaultfilters import TimeWindowFilter, TargetingFilter
+from ._models import TargetingContext
+
+from ._version import VERSION
+
+__version__ = VERSION
+__all__ = [
+    "FeatureManager",
+    "TimeWindowFilter",
+    "TargetingFilter",
+    "FeatureFilter",
+    "TargetingContext",
+]

featuremanagement-1.0.0/featuremanagement/_defaultfilters.py

@@ -0,0 +1,162 @@
+# ------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# -------------------------------------------------------------------------
+import logging
+import hashlib
+
+from datetime import datetime, timezone
+from email.utils import parsedate_to_datetime
+
+from ._featurefilters import FeatureFilter
+
+FEATURE_FLAG_NAME_KEY = "feature_name"
+ROLLOUT_PERCENTAGE_KEY = "RolloutPercentage"
+DEFAULT_ROLLOUT_PERCENTAGE_KEY = "DefaultRolloutPercentage"
+PARAMETERS_KEY = "parameters"
+
+# Time Window Constants
+START_KEY = "Start"
+END_KEY = "End"
+
+# Targeting kwargs
+TARGETED_USER_KEY = "user"
+TARGETED_GROUPS_KEY = "groups"
+
+# Targeting Constants
+AUDIENCE_KEY = "Audience"
+USERS_KEY = "Users"
+GROUPS_KEY = "Groups"
+EXCLUSION_KEY = "Exclusion"
+FEATURE_FILTER_NAME_KEY = "Name"
+IGNORE_CASE_KEY = "ignore_case"
+
+
+class TargetingException(Exception):
+    """
+    Exception raised when the targeting filter is not configured correctly.
+    """
+
+
+@FeatureFilter.alias("Microsoft.TimeWindow")
+class TimeWindowFilter(FeatureFilter):
+    """
+    Feature Filter that determines if the current time is within the time window.
+    """
+
+    def evaluate(self, context, **kwargs):
+        """
+        Determine if the feature flag is enabled for the given context.
+
+        :keyword Mapping context: Mapping with the Start and End time for the feature flag.
+        :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)
+
+        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__)
+            return False
+
+        start_time = parsedate_to_datetime(start) if start else None
+        end_time = parsedate_to_datetime(end) if end else None
+
+        return (start_time is None or start_time <= current_time) and (end_time is None or current_time < end_time)
+
+
+@FeatureFilter.alias("Microsoft.Targeting")
+class TargetingFilter(FeatureFilter):
+    """
+    Feature Filter that determines if the user is targeted for the feature flag.
+    """
+
+    @staticmethod
+    def _is_targeted(context_id, rollout_percentage):
+        """Determine if the user is targeted for the given context"""
+        # Always return true if rollout percentage is 100
+        if rollout_percentage == 100:
+            return True
+
+        hashed_context_id = hashlib.sha256(context_id.encode()).digest()
+        context_marker = int.from_bytes(hashed_context_id[:4], byteorder="little", signed=False)
+
+        percentage = (context_marker / (2**32 - 1)) * 100
+        return percentage < rollout_percentage
+
+    def _target_group(self, target_user, target_group, group, feature_flag_name):
+        group_rollout_percentage = group.get(ROLLOUT_PERCENTAGE_KEY, 0)
+        if not target_user:
+            target_user = ""
+        audience_context_id = target_user + "\n" + feature_flag_name + "\n" + target_group
+
+        return self._is_targeted(audience_context_id, group_rollout_percentage)
+
+    def evaluate(self, context, **kwargs):
+        """
+        Determine if the feature flag is enabled for the given context.
+
+        :keyword Mapping context: Context for evaluating the user/group.
+        :return: True if the user is targeted for the feature flag.
+        :rtype: bool
+        """
+        target_user = kwargs.get(TARGETED_USER_KEY, None)
+        target_groups = kwargs.get(TARGETED_GROUPS_KEY, [])
+
+        if not target_user and not (target_groups and len(target_groups) > 0):
+            logging.warning("%s: Name or Groups are required parameters", TargetingFilter.__name__)
+            return False
+
+        audience = context.get(PARAMETERS_KEY, {}).get(AUDIENCE_KEY, None)
+        feature_flag_name = context.get(FEATURE_FLAG_NAME_KEY, None)
+
+        if not audience:
+            raise TargetingException("Audience is required for " + TargetingFilter.__name__)
+
+        groups = audience.get(GROUPS_KEY, [])
+        default_rollout_percentage = audience.get(DEFAULT_ROLLOUT_PERCENTAGE_KEY, 0)
+
+        self._validate(groups, default_rollout_percentage)
+
+        # Check if the user is excluded
+        if target_user in audience.get(EXCLUSION_KEY, {}).get(USERS_KEY, []):
+            return False
+
+        # Check if the user is in an excluded group
+        for group in audience.get(EXCLUSION_KEY, {}).get(GROUPS_KEY, []):
+            if group in target_groups:
+                return False
+
+        # Check if the user is targeted
+        if target_user in audience.get(USERS_KEY, []):
+            return True
+
+        # Check if the user is in a targeted group
+        for group in groups:
+            for target_group in target_groups:
+                group_name = group.get(FEATURE_FILTER_NAME_KEY, "")
+                if kwargs.get(IGNORE_CASE_KEY, False):
+                    target_group = target_group.lower()
+                    group_name = group_name.lower()
+                if group_name == target_group:
+                    if self._target_group(target_user, target_group, group, feature_flag_name):
+                        return True
+
+        if not target_user:
+            target_user = ""
+        # Check if the user is in the default rollout
+        context_id = target_user + "\n" + feature_flag_name
+        return self._is_targeted(context_id, default_rollout_percentage)
+
+    @staticmethod
+    def _validate(groups, default_rollout_percentage):
+        # Validate the audience settings
+        if default_rollout_percentage < 0 or default_rollout_percentage > 100:
+            raise TargetingException("DefaultRolloutPercentage must be between 0 and 100")
+
+        for group in groups:
+            if group.get(ROLLOUT_PERCENTAGE_KEY) < 0 or group.get(ROLLOUT_PERCENTAGE_KEY) > 100:
+                raise TargetingException("RolloutPercentage must be between 0 and 100")

featuremanagement-1.0.0/featuremanagement/_featurefilters.py

@@ -0,0 +1,48 @@
+# ------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# -------------------------------------------------------------------------
+from abc import ABC, abstractmethod
+
+
+class FeatureFilter(ABC):
+    """
+    Parent class for all feature filters.
+    """
+
+    @abstractmethod
+    def evaluate(self, context, **kwargs):
+        """
+        Determine if the feature flag is enabled for the given context.
+
+        :param Mapping context: Context for the feature flag.
+        """
+
+    @property
+    def name(self):
+        """
+        Get the name of the filter.
+
+        :return: Name of the filter, or alias if it exists.
+        :rtype: str
+        """
+        if hasattr(self, "_alias"):
+            return self._alias
+        return self.__class__.__name__
+
+    @staticmethod
+    def alias(alias):
+        """
+        Decorator to set the alias for the filter.
+
+        :param str alias: Alias for the filter.
+        :return: Decorator.
+        :rtype: callable
+        """
+
+        def wrapper(cls):
+            cls._alias = alias  # pylint: disable=protected-access
+            return cls
+
+        return wrapper