Deprecate the fsevents2 module (#909)

gorakhargosh · Jul 26, 2022 · e8c20a4 · e8c20a4
1 parent 0800dba
commit e8c20a4
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 0 deletions.
diff --git a/changelog.rst b/changelog.rst
@@ -9,6 +9,7 @@ Changelog
 2022-xx-xx • `full history <https://github.com/gorakhargosh/watchdog/compare/v2.1.9...HEAD>`__
 
 - [documentation] HTML documentation builds are now tested for errors.
+- [fsevents2] The fsevents2 observer is now deprecated.
 - Thanks to our beloved contributors: @kurtmckee
 
 2.1.9

diff --git a/src/watchdog/observers/fsevents2.py b/src/watchdog/observers/fsevents2.py
@@ -24,6 +24,7 @@
 import logging
 import queue
 import unicodedata
+import warnings
 from threading import Thread
 
 from watchdog.events import (
@@ -77,6 +78,10 @@
 
 logger = logging.getLogger(__name__)
 
+message = "watchdog.observers.fsevents2 is deprecated and will be removed in a future release."
+warnings.warn(message, DeprecationWarning)
+logger.warning(message)
+
 
 class FSEventsQueue(Thread):
     """ Low level FSEvents client. """