⚠️ drop support for Python 3.6 & clarify version policy (#1606)

* drop support for python 3.6 and clarify version policy

* remove some docs

* update docs

* update example

* fix typo

* update example

Author: xavdid-stripe

.github/workflows/ci.yml

@@ -77,6 +77,8 @@ jobs:
       fail-fast: false
       matrix:
         python_version:
+          # The last ~5 versions, once we're on schedule
+          # https://docs.stripe.com/sdks/versioning?server=python#stripe-sdk-language-version-support-policy
           - "3.7"
           - "3.8"
           - "3.9"
@@ -88,6 +90,7 @@ jobs:
           - "pypy-3.8"
           - "pypy-3.9"
           - "pypy-3.10"
+          - "pypy-3.11"
     name: Test (${{ matrix.python_version }})
     steps:
       - uses: extractions/setup-just@v2

README.md

@@ -9,28 +9,31 @@ classes for API resources that initialize themselves dynamically from API
 responses which makes it compatible with a wide range of versions of the Stripe
 API.
 
-## Documentation
+## API Documentation
 
 See the [Python API docs](https://stripe.com/docs/api?lang=python).
 
 ## Installation
 
-You don't need this source code unless you want to modify the package. If you just
-want to use the package, just run:
+This package is available on PyPI:
 
 ```sh
 pip install --upgrade stripe
 ```
 
-Install from source with:
+Alternatively, install from source with:
 
 ```sh
 python -m pip install .
 ```
 
 ### Requirements
 
--   Python 3.6+ (PyPy supported)
+Per our [Language Version Support Policy](https://docs.stripe.com/sdks/versioning?server=python#stripe-sdk-language-version-support-policy), we currently support **Python 3.7+**.
+
+Support for Python 3.7 and 3.8 is deprecated and will be removed in an upcoming major version. Read more and see the full schedule in the docs: https://docs.stripe.com/sdks/versioning?server=python#stripe-sdk-language-version-support-policy
+
+#### Extended Support
 
 #### Python 2.7 deprecation
 

examples/webhooks.py

@@ -1,14 +1,10 @@
 import os
 
-from stripe import StripeClient, Webhook, SignatureVerificationError
-
+from stripe import Webhook, SignatureVerificationError
 from flask import Flask, request
 
-
-client = StripeClient(
-    api_key=os.environ["STRIPE_SECRET_KEY"],
-    client_id=os.environ.get("STRIPE_CLIENT_ID"),
-)
+# this is for handling v1-style Snapshot Events.
+# To handle v2-style Events, see `event_notification_webhook_handler.py`
 
 webhook_secret = os.environ.get("WEBHOOK_SECRET")
 
@@ -21,7 +17,9 @@ def webhooks():
     received_sig = request.headers.get("Stripe-Signature", None)
 
     try:
-        event = Webhook.construct_event(payload, received_sig, webhook_secret)
+        event = Webhook.construct_event(
+            payload, received_sig, webhook_secret, api_key="sk_test_..."
+        )
     except ValueError:
         print("Error while decoding event!")
         return "Bad payload", 400

pyproject.toml

@@ -6,7 +6,7 @@ description = "Python bindings for the Stripe API"
 authors = [{ name = "Stripe", email = "[email protected]" }]
 license-files = ["LICENSE"]
 keywords = ["stripe", "api", "payments"]
-requires-python = ">=3.6"
+requires-python = ">=3.7"
 dependencies = [
   "typing_extensions <= 4.2.0, > 3.7.2; python_version < '3.7'",
   # The best typing support comes from 4.5.0+ but we can support down to
@@ -22,7 +22,6 @@ classifiers = [
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.6",
   "Programming Language :: Python :: 3.7",
   "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",