clean up dropping of py38

Author: fselmo

.circleci/config.yml

@@ -221,7 +221,7 @@ workflows:
       - common:
           matrix:
             parameters:
-              python_minor_version: ["9", "10", "11", "12", "13"]
+              python_minor_version: ["8", "9", "10", "11", "12", "13"]
               tox_env: [
                 "lint",
                 "core",
@@ -234,7 +234,7 @@ workflows:
       - geth:
           matrix:
             parameters:
-              python_minor_version: ["9", "10", "11", "12", "13"]
+              python_minor_version: ["8", "9", "10", "11", "12", "13"]
               tox_env: [
                 "integration-goethereum-ipc",
                 "integration-goethereum-ipc_async",

README.md

@@ -10,7 +10,7 @@
 
 web3.py allows you to interact with the Ethereum blockchain using Python, enabling you to build decentralized applications, interact with smart contracts, and much more.
 
-- Python 3.9+ support
+- Python 3.8+ support
 
 ## Installation
 

docs/migration.rst

@@ -1,31 +1,6 @@
 Migration Guide
 ===============
 
-.. _migrating_v7_to_v8:
-
-Migrating from v7 to v8
------------------------
-
-web3.py follows `Semantic Versioning <http://semver.org>`_, which means that
-version 8 introduced backwards-incompatible changes. If you're upgrading from
-web3.py ``v7``, you can expect to need to make some changes. Refer
-to this guide for a summary of breaking changes when updating from ``v7`` to
-``v8``. If you are more than one major version behind, you should also review
-the migration guides for the versions in between.
-
-Dependency Updates
-~~~~~~~~~~~~~~~~~~
-
-websockets
-``````````
-
-The ``websockets`` library has been updated to version 15+. This version
-drops support for Python 3.8 and below. If you are using Python 3.8 or below,
-you will need to upgrade to Python 3.9 or above to use web3.py ``v8``. Additionally,
-the minimum required version of ``websockets`` has been bumped to ``15.0.0``. If you
-are using a version of ``websockets`` below ``15.0.0``, you will need to upgrade to
-``15.0.0`` or above to use web3.py ``v8``.
-
 .. _migrating_v6_to_v7:
 
 Migrating from v6 to v7

newsfragments/3641.breaking.rst

@@ -0,0 +1 @@
+Bump ``websockets`` upper range to ``<16``. For now, use legacy paths to deprecated classes in order to open up new version compatibility without breaking changes.

newsfragments/3653.misc.rst

@@ -78,10 +78,10 @@
         "requests>=2.23.0",
         "typing-extensions>=4.0.1",
         "types-requests>=2.0.0",
-        "websockets>=15.0.0,<16.0.0",
+        "websockets>=10.0.0,<16.0.0",
         "pyunormalize>=15.0.0",
     ],
-    python_requires=">=3.9, <4",
+    python_requires=">=3.8, <4",
     extras_require=extras_require,
     py_modules=["web3", "ens"],
     license="MIT",
@@ -95,6 +95,7 @@
         "License :: OSI Approved :: MIT License",
         "Natural Language :: English",
         "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",

setup.py

@@ -45,6 +45,7 @@ passenv =
 basepython =
     docs: python
     windows-wheel: python
+    py38: python3.8
     py39: python3.9
     py310: python3.10
     py311: python3.11

tox.ini

@@ -1,4 +1,5 @@
 import asyncio
+import sys
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -47,8 +48,20 @@
 
 T = TypeVar("T")
 
+# TODO: This is an ugly hack for python 3.8. Remove this after we drop support for it
+#  and use `asyncio.Queue[T]` type directly in the `TaskReliantQueue` class.
+if sys.version_info >= (3, 9):
 
-class TaskReliantQueue(asyncio.Queue[T], Generic[T]):
+    class _TaskReliantQueue(asyncio.Queue[T], Generic[T]):
+        pass
+
+else:
+
+    class _TaskReliantQueue(asyncio.Queue, Generic[T]):  # type: ignore
+        pass
+
+
+class TaskReliantQueue(_TaskReliantQueue[T]):
     """
     A queue that relies on a task to be running to process items in the queue.
     """