chore: Update supported Python versions (drop 3.7, add 3.12) (#1017)

* tox.ini: Update supported versions

as described at https://devguide.python.org/versions/

Fixes: GH-971

* Update more stuff to say 3.8+ instead of 3.7+

* tox.ini: Remove py312

It seems tox doesn't support it yet.

* .github/workflows/tests.yml: Remove "3.7"

* Revert "tox.ini: Remove py312"

This reverts commit 75c3edf.

* .github/workflows/tests.yml: Add "3.12"

* Update changelog.rst

---------

Co-authored-by: Mickaël Schoentgen <contact@tiger-222.fr>

.github/workflows/tests.yml

@@ -41,11 +41,11 @@ jobs:
             emoji: 🪟
             runs-on: [windows-latest]
         python:
-          - "3.7"
           - "3.8"
           - "3.9"
           - "3.10"
           - "3.11"
+          - "3.12"
           - "pypy-3.8"
           - "pypy-3.9"
         include:

README.rst

@@ -6,7 +6,7 @@ Watchdog
 
 Python API and shell utilities to monitor file system events.
 
-Works on 3.7+.
+Works on 3.8+.
 
 Example API Usage
 -----------------
@@ -213,7 +213,7 @@ appropriate observer like in the example above, do::
 Dependencies
 ------------
 
-1. Python 3.7 or above.
+1. Python 3.8 or above.
 2. XCode_ (only on macOS when installing from sources)
 3. PyYAML_ (only for ``watchmedo``)
 

changelog.rst

@@ -8,6 +8,8 @@ Changelog
 
 2023-xx-xx • `full history <https://github.com/gorakhargosh/watchdog/compare/v3.0.0...HEAD>`__
 
+- Drop support for Python 3.7.
+- Add support for Python 3.12.
 - [snapshot] Add typing to ``dirsnapshot`` (`#1012 <https://github.com/gorakhargosh/watchdog/pull/1012>`__)
 - [snapshot] Added ``DirectorySnapshotDiff.ContextManager`` (`#1011 <https://github.com/gorakhargosh/watchdog/pull/1011>`__)
 - [events] ``FileSystemEvent``, and subclasses, are now ``dataclass``es, and their ``repr()`` has changed

docs/source/index.rst

@@ -11,7 +11,7 @@ Watchdog
 
 Python API library and shell utilities to monitor file system events.
 
-Works on 3.7+.
+Works on 3.8+.
 
 Directory monitoring made easy with
 -----------------------------------

docs/source/installation.rst

@@ -4,7 +4,7 @@
 
 Installation
 ============
-|project_name| requires 3.7+ to work. See a list of :ref:`installation-dependencies`.
+|project_name| requires 3.8+ to work. See a list of :ref:`installation-dependencies`.
 
 Installing from PyPI using pip
 ------------------------------

setup.py

@@ -129,11 +129,11 @@
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
         "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: Implementation :: PyPy",
         "Programming Language :: C",
         "Topic :: Software Development :: Libraries",
@@ -154,6 +154,6 @@
             "watchmedo = watchdog.watchmedo:main [watchmedo]",
         ]
     },
-    python_requires=">=3.7",
+    python_requires=">=3.8",
     zip_safe=False,
 )

tox.ini

@@ -1,6 +1,6 @@
 [tox]
 envlist =
-    py{311,310,39,38,37,36,py3}
+    py{312,311,310,39,38,py3}
     docs
     mypy
 skip_missing_interpreters = True