feat(feature_flags): add modulo range condition for segmented experimentation support

[ajwad-shaikh]

Issue number: #2003

Summary

Adds Support for Modulo Range Condition in Feature Flags Utility

Changes

Please provide a summary of what's being changed

• Added a Rule Action - MODULO_RANGE
• Refactored time_conditions.py to comparators.py
• Added Validation for the new Rule Action
• Added Test Cases for Validation and functional tests for the new Rule Action
• Added Documentation for Modulo Range Experiment Segmentation

User experience

Please share what the user experience looks like before and after this change

• Users will be able to run segmented experiments using feature flag utility.
• Users can also enable an experiment for a certain percentage of users and scaling the experiment incrementally.

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change? No.

RFC issue number: #2003

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[leandrodamascena]

Hello @ajwad-shaikh! Thank you for submitting the PR! We are planning to start the review in the next week.

[codecov-commenter]

Codecov Report

Patch coverage: 100.00% and project coverage change: +0.01 🎉

Comparison is base (decee59) 97.16% compared to head (1946c2f) 97.18%.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #2331      +/-   ##
===========================================
+ Coverage    97.16%   97.18%   +0.01%     
===========================================
  Files          155      155              
  Lines         7067     7093      +26     
  Branches       515      520       +5     
===========================================
+ Hits          6867     6893      +26     
  Misses         157      157              
  Partials        43       43              

Impacted Files	Coverage Δ
..._powertools/utilities/feature_flags/comparators.py	94.44% <100.00%> (ø)
...owertools/utilities/feature_flags/feature_flags.py	100.00% <100.00%> (ø)
...ambda_powertools/utilities/feature_flags/schema.py	97.44% <100.00%> (+0.25%)	⬆️

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[rubenfonseca]

Looking at this now

[rubenfonseca]

Congratulations for this awesome PR. I loved how you added documentation in the right places, and how you highlighted real use cases and samples in the documentation. This is stellar work!