Finish the Python 2.7 and 3.4 drops and prepare for the upcoming v1.0.0

Author: BoboTiG

.gitignore

@@ -19,10 +19,6 @@ __MACOSX__
 *.egg-info/
 *.egg
 .installed.cfg
-bin/
-bin25/
-bin26/
-bin27/
 build/
 develop-eggs/
 dist/

.travis.yml

@@ -50,66 +50,78 @@ jobs:
       install:
         - unset PYENV_ROOT
         - curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
-        - export PATH="$HOME/.pyenv/bin:$PATH"
         - eval "$(pyenv init -)"
         - pyenv install --skip-existing 3.5.10
         - pyenv global 3.5.10
-      env: TOXENV=py35
+      env:
+        - TOXENV=py35
+        - PYENV_ROOT="$HOME/.pyenv/versions/3.5.10"
+        - PATH="$PYENV_ROOT/bin:$PATH"
     - name: Python 3.6 on macOS
       os: osx
       language: shell
       install:
         - unset PYENV_ROOT
         - curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
-        - export PATH="$HOME/.pyenv/bin:$PATH"
         - eval "$(pyenv init -)"
         - pyenv install --skip-existing 3.6.12
-        - pyenv global system 3.6.12
-      env: TOXENV=py36
+        - pyenv global 3.6.12
+      env:
+        - TOXENV=py36
+        - PYENV_ROOT="$HOME/.pyenv/versions/3.6.12"
+        - PATH="$PYENV_ROOT/bin:$PATH"
     - name: Python 3.7 on macOS
       os: osx
       language: shell
       install:
         - unset PYENV_ROOT
         - curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
-        - export PATH="$HOME/.pyenv/bin:$PATH"
         - eval "$(pyenv init -)"
         - pyenv install --skip-existing 3.7.9
         - pyenv global system 3.7.9
-      env: TOXENV=py37
+      env:
+        - TOXENV=py37
+        - PYENV_ROOT="$HOME/.pyenv/versions/3.7.9"
+        - PATH="$PYENV_ROOT/bin:$PATH"
     - name: Python 3.8 on macOS
       os: osx
       language: shell
       install:
         - unset PYENV_ROOT
         - curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
-        - export PATH="$HOME/.pyenv/bin:$PATH"
         - eval "$(pyenv init -)"
         - pyenv install --skip-existing 3.8.6
         - pyenv global system 3.8.6
-      env: TOXENV=py38
+      env:
+        - TOXENV=py38
+        - PYENV_ROOT="$HOME/.pyenv/versions/3.8.6"
+        - PATH="$PYENV_ROOT/bin:$PATH"
     - name: Python 3.9 on macOS
       os: osx
       language: shell
       install:
         - unset PYENV_ROOT
         - curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
-        - export PATH="$HOME/.pyenv/bin:$PATH"
         - eval "$(pyenv init -)"
-        - pyenv install --skip-existing 3.9-dev
-        - pyenv global system 3.9-dev
-      env: TOXENV=py39
+        - pyenv install --skip-existing 3.9.0
+        - pyenv global system 3.9.0
+      env:
+        - TOXENV=py39
+        - PYENV_ROOT="$HOME/.pyenv/versions/3.9.0"
+        - PATH="$PYENV_ROOT/bin:$PATH"
     - name: Python 3.10 on macOS
       os: osx
       language: shell
       install:
         - unset PYENV_ROOT
         - curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash
-        - export PATH="$HOME/.pyenv/bin:$PATH"
         - eval "$(pyenv init -)"
         - pyenv install --skip-existing 3.10-dev
         - pyenv global system 3.10-dev
-      env: TOXENV=py310
+      env:
+        - TOXENV=py310
+        - PYENV_ROOT="$HOME/.pyenv/versions/3.10-dev"
+        - PATH="$PYENV_ROOT/bin:$PATH"
     - name: Python 3.5 on Windows
       os: windows
       language: shell
@@ -160,6 +172,7 @@ jobs:
         - export PATH="/c/Python310:/c/Python310/Scripts:$PATH"
 
 before_script:
+  - python -V
   - python -m pip install -U pip tox
   - python -m tox --notest  # Note: keep it!
 

COPYING

@@ -1,5 +1,5 @@
 Copyright 2011 Yesudeep Mangalapilly <[email protected]>
-Copyright 2012 Google, Inc.
+Copyright 2012 Google, Inc & contributors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

README.rst

@@ -6,10 +6,14 @@ Watchdog
 
 Python API and shell utilities to monitor file system events.
 
-Works on Python 2.7 and 3.4+. If you want to use an old version of Python, you should stick with watchdog < 0.10.0.
+Works on 3.5+.
+
+If you want to use Python 2.6, you should stick with watchdog < 0.10.0.
+If you want to use Python 2.7 or 3.4, you should stick with watchdog < 1.0.0.
 
 Example API Usage
 -----------------
+
 A simple program that uses watchdog to monitor directories specified
 as command-line arguments and logs events generated:
 
@@ -40,6 +44,7 @@ as command-line arguments and logs events generated:
 
 Shell Utilities
 ---------------
+
 Watchdog comes with an *optional* utility script called ``watchmedo``.
 Please type ``watchmedo --help`` at the shell prompt to
 know more about this tool.
@@ -76,6 +81,7 @@ Please see the help information for these commands by typing:
 
 About ``watchmedo`` Tricks
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 ``watchmedo`` can read ``tricks.yaml`` files and execute tricks within them in
 response to file system events. Tricks are actually event handlers that
 subclass ``watchdog.tricks.Trick`` and are written by plugin authors. Trick
@@ -112,20 +118,16 @@ The directory containing the ``tricks.yaml`` file will be monitored. Each trick
 class is initialized with its corresponding keys in the ``tricks.yaml`` file as
 arguments and events are fed to an instance of this class as they arrive.
 
-Tricks will be included in the 0.5.0 release. I need community input about them.
-Please file enhancement requests at the `issue tracker`_.
-
-
 Installation
 ------------
 Install from PyPI using ``pip``:
 
 .. code-block:: bash
 
-    $ python -m pip install watchdog
+    $ python -m pip install -U watchdog
 
     # or to install the watchmedo utility:
-    $ python -m pip install watchdog[watchmedo]
+    $ python -m pip install -U watchdog[watchmedo]
 
 Install from source:
 
@@ -139,6 +141,7 @@ Install from source:
 
 Installation Caveats
 ~~~~~~~~~~~~~~~~~~~~
+
 The ``watchmedo`` script depends on PyYAML_ which links with LibYAML_,
 which brings a performance boost to the PyYAML parser. However, installing
 LibYAML_ is optional but recommended. On Mac OS X, you can use homebrew_
@@ -153,31 +156,34 @@ do it on Ubuntu:
 
 .. code-block:: bash
 
-    $ sudo aptitude install libyaml-dev
+    $ sudo apt install libyaml-dev
 
 On Windows, please install PyYAML_ using the binaries they provide.
 
 Documentation
 -------------
+
 You can browse the latest release documentation_ online.
 
 Contribute
 ----------
+
 Fork the `repository`_ on GitHub and send a pull request, or file an issue
 ticket at the `issue tracker`_. For general help and questions use the official
 `mailing list`_ or ask on `stackoverflow`_ with tag `python-watchdog`.
 
 Create and activate your virtual environment, then::
 
     python -m pip install pytest pytest-cov
-    python -m pip install -e .[watchmedo]
+    python -m pip install -e ".[watchmedo]"
     python -m pytest tests
 
 If you are making a substantial change, add an entry to the "Unreleased" section
 of the `changelog`_.
 
 Supported Platforms
 -------------------
+
 * Linux 2.6 (inotify)
 * Mac OS X (FSEvents, kqueue)
 * FreeBSD/BSD (kqueue)
@@ -206,6 +212,7 @@ files.
 
 About using watchdog with editors like Vim
 ------------------------------------------
+
 Vim does not modify files unless directed to do so.
 It creates backup files and then swaps them in to replace
 the files you are editing on the disk. This means that
@@ -217,6 +224,7 @@ this feature.
 
 About using watchdog with CIFS
 ------------------------------
+
 When you want to watch changes in CIFS, you need to explicitly tell watchdog to
 use ``PollingObserver``, that is, instead of letting watchdog decide an
 appropriate observer like in the example above, do::
@@ -226,25 +234,28 @@ appropriate observer like in the example above, do::
 
 Dependencies
 ------------
-1. Python 3.4 or above.
+
+1. Python 3.5 or above.
 3. XCode_ (only on Mac OS X)
 4. PyYAML_ (only for ``watchmedo`` script)
 5. argh_ (only for ``watchmedo`` script)
 
 
 Licensing
 ---------
+
 Watchdog is licensed under the terms of the `Apache License, version 2.0`_.
 
 Copyright 2011 `Yesudeep Mangalapilly`_.
 
-Copyright 2012 Google, Inc.
+Copyright 2012 Google, Inc & contributors.
 
 Project `source code`_ is available at Github. Please report bugs and file
 enhancement requests at the `issue tracker`_.
 
 Why Watchdog?
 -------------
+
 Too many people tried to do the same thing and none did what I needed Python
 to do:
 

changelog.rst

@@ -3,15 +3,17 @@
 Changelog
 ---------
 
-0.10.5
-~~~~~~
+1.0.0
+~~~~~
 
 2021-xx-xx • `full history <https://github.com/gorakhargosh/watchdog/compare/v0.10.4...master>`__
 
-- Allow file paths on Unix that don't follow the file system encoding (`# <https://github.com/gorakhargosh/watchdog/pull/703>`_)
-- Drop support for Python 2.7 (`# <https://github.com/gorakhargosh/watchdog/pull/703>`_)
-- Thanks to our beloved contributors: @SamSchott
-- Use `pathlib` from the standard library, instead of pathtools: @bstaletic
+- Versioning is now following `semver <https://semver.org/>`_
+- Drop support for Python 2.7 and 3.4
+- Allow file paths on Unix that don't follow the file system encoding (`#703 <https://github.com/gorakhargosh/watchdog/pull/703>`_)
+- Use ``pathlib`` from the standard library, instead of pathtools (`#556 <https://github.com/gorakhargosh/watchdog/pull/556>`_)
+- Removed the long-time deprecated ``events.LoggingFileSystemEventHandler`` class, use ``LoggingEventHandler`` instead
+- Thanks to our beloved contributors: @SamSchott, @bstaletic, @BoboTiG
 
 
 0.10.4

docs/_fsevents.pyx

@@ -1,5 +1,4 @@
-#!/usr/bin/env cython
-# -*- coding: utf-8 -*-
+# coding: utf-8
 
 cdef extern from "CoreFoundation/CoreFoundation.h":
     struct dummy:

docs/echo.py.txt

@@ -75,7 +75,7 @@ full_monty(x='spam', y='eggs', z='more spam', extra='even more spam')
 
 You can echo functions in a class by decorating them.
 
->>> class Example(object):
+>>> class Example:
 ...     @echo.echo
 ...     def __init__(self): pass
 ...     @echo.echo
@@ -110,7 +110,7 @@ sm()
 Alternatively, don't decorate the methods you want to echo up front,
 retrospectively decorate the whole class.
 
->>> class YetAnotherExample(object):
+>>> class YetAnotherExample:
 ...     def __init__(self): pass
 ...     def m(self, x, y): pass
 ...     @classmethod
@@ -130,7 +130,7 @@ sm(x='echo', y='echo')
 
 Private methods are echoed as well.
 
->>> class Privates(object):
+>>> class Privates:
 ... 	def __myob(self): pass
 ... 	def do_something(self): self.__myob()
 ...

docs/source/conf.py

@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# coding: utf-8
 #
 # watchdog documentation build configuration file, created by
 # sphinx-quickstart on Tue Nov 30 00:43:58 2010.

docs/source/examples/logger.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
+# coding: utf-8
 
 import sys
 import time

docs/source/examples/patterns.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
+# coding: utf-8
 
 import sys
 import time

docs/source/examples/simple.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
+# coding: utf-8
 
 import logging
 import sys

docs/source/global.rst.inc

@@ -2,9 +2,9 @@
 
 .. |author_name| replace:: Yesudeep Mangalapilly
 .. |author_email| replace:: [email protected]
-.. |copyright| replace:: Copyright 2012 Google, Inc.
+.. |copyright| replace:: Copyright 2012 Google, Inc & contributors.
 .. |project_name| replace:: ``watchdog``
-.. |project_version| replace:: 0.9.0
+.. |project_version| replace:: 1.0.0
 
 .. _issue tracker: http://github.com/gorakhargosh/watchdog/issues
 .. _code repository: http://github.com/gorakhargosh/watchdog

docs/source/index.rst

@@ -11,7 +11,10 @@ Watchdog
 
 Python API library and shell utilities to monitor file system events.
 
-Works on Python 3.4+. If you want to use an old version of Python, you should stick with watchdog < 0.10.0.
+Works on 3.5+.
+
+If you want to use Python 2.6, you should stick with watchdog < 0.10.0.
+If you want to use Python 2.7 or 3.4, you should stick with watchdog < 1.0.0.
 
 Directory monitoring made easy with
 -----------------------------------
@@ -26,7 +29,7 @@ Easy installation
 -----------------
 You can use pip_ to install |project_name| quickly and easily::
 
-    $ pip install watchdog
+    $ python -m pip install -U watchdog
 
 Need more help with installing? See :ref:`installation`.
 
@@ -44,6 +47,7 @@ User's Guide
 
 Contribute
 ==========
+
 Found a bug in or want a feature added to |project_name|?
 You can fork the official `code repository`_ or file an issue ticket
 at the `issue tracker`_. You can also ask questions at the official