feat(flags): add Unleash feature flagging integration

[aliu39]

Adds an integration for tracking flag evaluations from Unleash customers.

Implementation
Unleash has no native support for evaluation hooks/listeners, unless the user opts in for each flag. Therefore we decided to patch the is_enabled and get_variant methods on the UnleashClient class. The methods are wrapped and the only side effect is writing to Sentry scope, so users shouldn't see any change in behavior.

We patch one UnleashClient instance instead of the whole class. The reasons for this are described in

• ref(flags): allow OpenFeature integration to track a single client #3895

It's also safer to not modify the unleash import.

References

• https://develop.sentry.dev/sdk/expected-features/#feature-flags
• https://docs.getunleash.io/reference/sdks/python for methods we're patching/wrapping

[codecov]

❌ 1 Tests Failed:

Tests completed	Failed	Passed	Skipped
13815	1	13814	4140

View the top 1 failed tests by shortest run time

tests.integrations.launchdarkly.test_launchdarkly test_launchdarkly_integration_threaded

Stack Traces | 0.113s run time

.../integrations/launchdarkly/test_launchdarkly.py:90: in test_launchdarkly_integration_threaded
    assert len(events) == 3
E   AssertionError: assert 5 == 3
E    +  where 5 = len([{'breadcrumbs': {'values': []}, 'contexts': {'flags': {'values': [{'flag': 'hello', 'result': True}, {'flag': 'world', 'result': False}]}, 'runtime': {'build': '3.12.8 (main, Dec  4 2024, 06:20:10) [GCC 9.4.0]', 'name': 'CPython', 'version': '3.12.8'}, 'trace': {'parent_span_id': None, 'span_id': 'a438de914ef4df07', 'trace_id': 'f866dac9f19441b086d82351ab420acb'}}, 'environment': 'production', 'event_id': '96f0d44cc36846478eec9f67f4819998', ...}, {'breadcrumbs': {'values': []}, 'contexts': {'runtime': {'build': '3.12.8 (main, Dec  4 2024, 06:20:10) [GCC 9.4.0]', 'name': 'CPython', 'version': '3.12.8'}, 'trace': {'parent_span_id': None, 'span_id': 'accefc5ba7509f4c', 'trace_id': 'e9c98b5b272e4d2fb389d0c9c9696007'}}, 'environment': 'production', 'event_id': 'ba881380d851456f8fc16a4278bcc0f1', ...}, {'breadcrumbs': {'values': []}, 'contexts': {'runtime': {'build': '3.12.8 (main, Dec  4 2024, 06:20:10) [GCC 9.4.0]', 'name': 'CPython', 'version': '3.12.8'}, 'trace': {'parent_span_id': None, 'span_id': 'accefc5ba7509f4c', 'trace_id': 'e9c98b5b272e4d2fb389d0c9c9696007'}}, 'environment': 'production', 'event_id': '054f1cf36bb74e8bbb0b4efd57e8999e', ...}, {'breadcrumbs': {'values': []}, 'contexts': {'flags': {'values': [{'flag': 'hello', 'result': True}, {'flag': 'other', 'result': False}]}, 'runtime': {'build': '3.12.8 (main, Dec  4 2024, 06:20:10) [GCC 9.4.0]', 'name': 'CPython', 'version': '3.12.8'}, 'trace': {'parent_span_id': None, 'span_id': 'a438de914ef4df07', 'trace_id': 'f866dac9f19441b086d82351ab420acb'}}, 'environment': 'production', 'event_id': 'af8ddef4e0c444ad82de4cd78cc672ff', ...}, {'breadcrumbs': {'values': []}, 'contexts': {'flags': {'values': [{'flag': 'hello', 'result': True}]}, 'runtime': {'build': '3.12.8 (main, Dec  4 2024, 06:20:10) [GCC 9.4.0]', 'name': 'CPython', 'version': '3.12.8'}, 'trace': {'parent_span_id': None, 'span_id': 'a438de914ef4df07', 'trace_id': 'f866dac9f19441b086d82351ab420acb'}}, 'environment': 'production', 'event_id': '2113cb8a9748455f93e3e56fe088452a', ...}])

To view more test analytics, go to the Test Analytics Dashboard
📢 Thoughts on this report? Let us know!

[antonpirker]

Hey @aliu39 ! Thanks for the integration. This will be reviewed after the holiday season.

[aliu39]

Todo:

• verify w manual test
• threading and asyncio tests
• determine if variant payload should factor into tracking (no, track every feature)
• docs w/ sample verification code