diff --git a/changelog.rst b/changelog.rst index 69a1d335..1d45b13e 100644 --- a/changelog.rst +++ b/changelog.rst @@ -9,6 +9,7 @@ Changelog 2022-xx-xx • `full history `__ - [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 index 52352123..da2bcabd 100644 --- 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. """