updates

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

@@ -0,0 +1,71 @@
+from typing import Optional
+from stripe import _util
+from urllib.parse import quote_plus
+
+
+# TODO(major): 1704.
+@_util.deprecated(
+    "the custom_method class decorator will be removed in a future version of stripe-python. Define custom methods directly and use StripeObject._static_request within."
+)
+def custom_method(
+    name: str,
+    http_verb: str,
+    http_path: Optional[str] = None,
+    is_streaming=False,
+):
+    if http_verb not in ["get", "post", "delete"]:
+        raise ValueError(
+            "Invalid http_verb: %s. Must be one of 'get', 'post' or 'delete'"
+            % http_verb
+        )
+    if http_path is None:
+        http_path = name
+
+    def wrapper(cls):
+        def custom_method_request(cls, sid, **params):
+            url = "%s/%s/%s" % (
+                cls.class_url(),
+                quote_plus(sid),
+                http_path,
+            )
+            obj = cls._static_request(http_verb, url, params=params)
+
+            # For list objects, we have to attach the parameters so that they
+            # can be referenced in auto-pagination and ensure consistency.
+            if "object" in obj and obj.object == "list":
+                obj._retrieve_params = params
+
+            return obj
+
+        def custom_method_request_stream(cls, sid, **params):
+            url = "%s/%s/%s" % (
+                cls.class_url(),
+                quote_plus(sid),
+                http_path,
+            )
+            return cls._static_request_stream(http_verb, url, params=params)
+
+        if is_streaming:
+            class_method_impl = classmethod(custom_method_request_stream)
+        else:
+            class_method_impl = classmethod(custom_method_request)
+
+        existing_method = getattr(cls, name, None)
+        if existing_method is None:
+            setattr(cls, name, class_method_impl)
+        else:
+            # If a method with the same name we want to use already exists on
+            # the class, we assume it's an instance method. In this case, the
+            # new class method is prefixed with `_cls_`, and the original
+            # instance method is decorated with `util.class_method_variant` so
+            # that the new class method is called when the original method is
+            # called as a class method.
+            setattr(cls, "_cls_" + name, class_method_impl)
+            instance_method = _util.class_method_variant("_cls_" + name)(
+                existing_method
+            )
+            setattr(cls, name, instance_method)
+
+        return cls
+
+    return wrapper