feat: added testing decorator for switcher mocks

[petruki]

This pull request introduces a new decorator-based testing API for feature flag mocking in the Switcher Client SDK for Python, along with updates to documentation and comprehensive tests. The main goal is to simplify and improve the safety of mocking feature flags in test scenarios, making it easier to isolate and clean up mocks automatically after each test, including support for both synchronous and asynchronous test functions.

Key changes:

Decorator-Based Test Mocking API:

• Added a new switcher_client/testing.py module with the assume_test builder and switcher_test decorator, enabling test-scoped, fluent, and safe mocking of feature flags with automatic cleanup, even on errors or in async tests. This ensures mocks do not leak between tests and supports advanced mocking rules and metadata.
• Exported assume_test and switcher_test from the SDK’s main module (switcher_client/__init__.py) for easy import by users. [1] [2]

Documentation Updates:

• Updated the README.md to describe the new decorator-based mocking approach, including usage examples, behavior, and limitations, and clarified the mocking feature description. [1] [2] [3] [4]

Testing and Validation:

• Added a new test file tests/test_switcher_stub_decorator.py with comprehensive unit tests covering all aspects of the new decorator API, including error handling, cleanup, support for metadata, multiple mocks, context isolation, and async test support.

Minor Improvements:

• Fixed import order to allow LoadSnapshotOptions to be imported from the main SDK entrypoint.

These changes collectively make feature flag mocking for testing more robust, convenient, and less error-prone for SDK users.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud