PHP 8.2.30
Preview: feature_flags.py Size: 2.18 KB
/opt/hc_python/lib/python3.12/site-packages/sentry_sdk/feature_flags.py

import copy
import sentry_sdk
from sentry_sdk._lru_cache import LRUCache
from threading import Lock

from typing import TYPE_CHECKING, Any

if TYPE_CHECKING:
    from typing import TypedDict

    FlagData = TypedDict("FlagData", {"flag": str, "result": bool})


DEFAULT_FLAG_CAPACITY = 100


class FlagBuffer:
    def __init__(self, capacity):
        # type: (int) -> None
        self.capacity = capacity
        self.lock = Lock()

        # Buffer is private. The name is mangled to discourage use. If you use this attribute
        # directly you're on your own!
        self.__buffer = LRUCache(capacity)

    def clear(self):
        # type: () -> None
        self.__buffer = LRUCache(self.capacity)

    def __deepcopy__(self, memo):
        # type: (dict[int, Any]) -> FlagBuffer
        with self.lock:
            buffer = FlagBuffer(self.capacity)
            buffer.__buffer = copy.deepcopy(self.__buffer, memo)
            return buffer

    def get(self):
        # type: () -> list[FlagData]
        with self.lock:
            return [
                {"flag": key, "result": value} for key, value in self.__buffer.get_all()
            ]

    def set(self, flag, result):
        # type: (str, bool) -> None
        if isinstance(result, FlagBuffer):
            # If someone were to insert `self` into `self` this would create a circular dependency
            # on the lock. This is of course a deadlock. However, this is far outside the expected
            # usage of this class. We guard against it here for completeness and to document this
            # expected failure mode.
            raise ValueError(
                "FlagBuffer instances can not be inserted into the dictionary."
            )

        with self.lock:
            self.__buffer.set(flag, result)


def add_feature_flag(flag, result):
    # type: (str, bool) -> None
    """
    Records a flag and its value to be sent on subsequent error events.
    We recommend you do this on flag evaluations. Flags are buffered per Sentry scope.
    """
    flags = sentry_sdk.get_isolation_scope().flags
    flags.set(flag, result)

    span = sentry_sdk.get_current_span()
    if span:
        span.set_flag(f"flag.evaluation.{flag}", result)

Directory Contents

Dirs: 5 × Files: 33

Name Size Perms Modified Actions
ai DIR
- drwxr-xr-x 2025-12-03 08:02:53
Edit Download
crons DIR
- drwxr-xr-x 2025-12-03 08:02:53
Edit Download
- drwxr-xr-x 2025-12-03 08:02:53
Edit Download
profiler DIR
- drwxr-xr-x 2025-12-03 08:02:53
Edit Download
- drwxr-xr-x 2025-12-03 08:02:53
Edit Download
14.92 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
3.04 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
41.11 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
52.47 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
1019 B lrw-r--r-- 2025-12-03 08:02:53
Edit Download
10.23 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
2.18 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
25.14 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
2.73 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
2.00 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
3.55 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
0 B lrw-r--r-- 2025-12-03 08:02:53
Edit Download
63.89 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
5.92 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
13.22 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
5.46 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
8.96 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
8.47 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
50.53 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
39.59 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
31.13 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
1.24 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
62.40 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
4.36 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
3.04 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
2.50 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
5.37 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
1.20 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
4.92 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
10.99 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
10.18 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
3.65 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download
1.38 KB lrw-r--r-- 2025-12-03 08:02:53
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).