Add overload annotation for stripe DeletableAPIResource delete classmethod

[yejia-stripe]

Fixes stripe/stripe-python#770

stripe's DeletableAPIResource.delete instance method has a wrapper that effectively overloads the method to add a class method version.

Both

s = stripe.Subscription.create(...)
s.delete()

and

s = stripe.Subscription.create(...)
stripe.Subscription.delete(s.id)

should work, but the latter raises a type error.

[JelleZijlstra]

I fixed the lint error, but it looks like pytype is unhappy about having @classmethod on only one of the two overloads. Could you rewrite this so the decorators are consistent?

[JelleZijlstra]

Actually there's another lint error too—you should use _typeshed.Self.

[yejia-stripe]

I fixed the lint error, but it looks like pytype is unhappy about having @classmethod on only one of the two overloads. Could you rewrite this so the decorators are consistent?

@JelleZijlstra I want to fake having a class method and an instance method with the same name, which is weird and it makes sense that pytype complains about it. I'm not sure how to both express that without using @classmethod for just one of the overloads. Do you have suggestions? Thanks!

[JelleZijlstra]

Would annotating it as only a classmethod work? Classmethods can still be called on instances.

[srittau]

I think it's easiest to add the following to @tests/stripe/stubtest_allowlist.txt to fix CI: stripe\..*\.delete (untested).