updates

Backend/venv/lib/python3.12/site-packages/stripe/_stripe_context.py

@@ -0,0 +1,40 @@
+from typing import List, Optional
+
+
+class StripeContext:
+    """
+    The StripeContext class provides an immutable container and convenience methods for interacting with the `Stripe-Context` header. All methods return a new instance of StripeContext.
+
+    You can use it whenever you're initializing a `StripeClient` or sending `stripe_context` with a request. It's also found in the `EventNotification.context` property.
+    """
+
+    def __init__(self, segments: Optional[List[str]] = None):
+        self._segments = segments or []
+
+    def push(self, segment: str) -> "StripeContext":
+        return StripeContext(self._segments + [segment])
+
+    def pop(self) -> "StripeContext":
+        if not self._segments:
+            raise ValueError("Cannot pop from an empty StripeContext")
+
+        return StripeContext(self._segments[:-1])
+
+    def __str__(self) -> str:
+        return "/".join(self._segments)
+
+    def __repr__(self) -> str:
+        return f"StripeContext({self._segments!r})"
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, StripeContext):
+            return False
+        return self._segments == other._segments
+
+    @staticmethod
+    def parse(context_str: str) -> "StripeContext":
+        if not context_str:
+            return StripeContext()
+
+        segments = context_str.split("/")
+        return StripeContext(segments)