Simple, modern and high performance file watching and code reload in python.

These details have not been verified by PyPI

Project links

Homepage

Project description

watchfiles

Simple, modern and high performance file watching and code reload in python.

NOTICE

This package was significantly altered and renamed from watchgod to watchfiles, this files refers to the watchfiles package.

Documentation for the old version (watchgod) is available here. See issue #102 for details on the migration and its rationale.

Underlying file system notifications are handled by the Notify rust library.

Installation

watchfiles requires Python 3.7 - 3.10.

pip install watchfiles

Binaries are available for:

Linux: manylinux-x86_64, musllinux-x86_64 & manylinux-i686
MacOS: x86_64 & arm64 (except python 3.7)
Windows: amd64 & win32

Otherwise, you can install from source which requires Rust stable to be installed.

Usage

To watch for changes in a directory:

from watchfiles import watch

for changes in watch('./path/to/dir'):
    print(changes)

watch (and all other methods described below) can take multiple paths as arguments to watch.

To run a function and restart it when code changes:

from watchfiles import run_process

def foobar(a, b, c):
    ...

if __name__ == '__main__':
    run_process('./path/to/dir', target=foobar, args=(1, 2, 3))

run_process uses PythonFilter by default so only changes to python files will prompt a reload, see custom event filtering below.

If you need notifications about change events as well as to restart a process you can use the callback argument to pass a function which will be called on every file change with one argument: the set of file changes.

File changes are also available via the WATCHFILES_CHANGES environment variable which contains JSON encoded details of changes, see the CLI example below.

Asynchronous Methods

watchfiles comes with an asynchronous equivalents of watch: awatch.

import asyncio
from watchfiles import awatch

async def main():
    async for changes in awatch('/path/to/dir'):
        print(changes)

asyncio.run(main())

There's also an asynchronous equivalents of run_process: arun_process which in turn uses awatch:

import asyncio
from watchfiles import arun_process

def foobar(a, b, c):
    ...

async def main():
    await arun_process('./path/to/dir', target=foobar, args=(1, 2, 3))

if __name__ == '__main__':
    asyncio.run(main())

The signature of arun_process is almost identical to run_process except that the optional callback argument may be a coroutine.

Custom Filters

The watch_filter argument to the above methods allows you to specify which file system events watchfiles should react to (either yield or reload code). watch_filter should just be a callable which takes a change (either "added", "modified" or "deleted") and a path (as a string) and should return whether or not that change should be registered.

watchfiles comes with the following classes, instances of which can be with watch_filter:

DefaultFilter The watcher used by default by watch and awatch, commonly ignored files like *.swp, *.pyc and *~ are ignored along with directories like .git.
PythonFilter Specific to python files, only *.py, *.pyx and *.pyd files are watched.
BaseFilter, used by DefaultFilter and PythonFilter, useful for defining your own filters which leverage the same logic

Here's an example of a custom filter which extends DefaultFilter to only notice changes to common web files:

from watchfiles import Change, DefaultFilter, watch


class WebFilter(DefaultFilter):
    allowed_extensions = '.html', '.css', '.js'

    def __call__(self, change: Change, path: str) -> bool:
        return super().__call__(change, path) and path.endswith(self.allowed_extensions)

for changes in watch('my/web/project', watch_filter=WebFilter()):
    print (changes)

Here's an example of a customer filter which is a simple callable that ignores changes unless they represent a new file being created:

from watchfiles import Change, watch

def only_added(change: Change, path: str) -> bool:
    return change == Change.added

for changes in watch('my/project', watch_filter=only_added):
    print (changes)

For more details, checkout filters.py, it's pretty simple.

CLI

watchfiles also comes with a CLI for running and reloading python code.

Let's say you have foobar.py (this is a very simple web server using aiohttp) which gets details about recent file changes from the WATCHFILES_CHANGES environment variable and returns them as JSON.

import os, json
from aiohttp import web

async def handle(request):
    # get the most recent file changes and return them
    changes = os.getenv('WATCHFILES_CHANGES', '[]')
    changes = json.loads(changes)
    return web.json_response(dict(changes=changes))

app = web.Application()
app.router.add_get('/', handle)

def main():
    web.run_app(app, port=8000)

You could run this and reload it when any file in the current directory changes with:

watchfiles foobar.main

Run watchfiles --help for more options.

The CLI can also be used via python -m watchfiles ....

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

0.24.0

Aug 28, 2024

0.23.0

Aug 7, 2024

0.22.0

May 27, 2024

0.21.0

Oct 13, 2023

0.20.0

Aug 24, 2023

0.19.0

Mar 27, 2023

0.18.1

Nov 7, 2022

0.18.0

Oct 19, 2022

0.17.0

Sep 11, 2022

0.16.1

Jul 25, 2022

0.16.0

Jul 21, 2022

0.15.0

Jun 17, 2022

0.15.0a1 pre-release

Jun 3, 2022

0.14.1

May 17, 2022

0.14

May 16, 2022

0.13

Apr 9, 2022

0.12

Apr 1, 2022

This version

0.11

Mar 30, 2022

0.10

Mar 23, 2022

0.0.0a1 pre-release

Mar 15, 2022

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

watchfiles-0.11.tar.gz (19.5 kB view details)

Uploaded Mar 30, 2022 Source

Built Distributions

watchfiles-0.11-cp310-cp310-win_amd64.whl (204.5 kB view details)

Uploaded Mar 30, 2022 CPython 3.10 Windows x86-64

watchfiles-0.11-cp310-cp310-win32.whl (198.4 kB view details)

Uploaded Mar 30, 2022 CPython 3.10 Windows x86

watchfiles-0.11-cp310-cp310-manylinux_2_24_x86_64.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.10 manylinux: glibc 2.24+ x86-64

watchfiles-0.11-cp310-cp310-manylinux_2_24_i686.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.10 manylinux: glibc 2.24+ i686

watchfiles-0.11-cp310-cp310-macosx_11_0_arm64.whl (275.3 kB view details)

Uploaded Mar 30, 2022 CPython 3.10 macOS 11.0+ ARM64

watchfiles-0.11-cp310-cp310-macosx_10_9_x86_64.whl (286.5 kB view details)

Uploaded Mar 30, 2022 CPython 3.10 macOS 10.9+ x86-64

watchfiles-0.11-cp39-cp39-win_amd64.whl (204.6 kB view details)

Uploaded Mar 30, 2022 CPython 3.9 Windows x86-64

watchfiles-0.11-cp39-cp39-win32.whl (198.5 kB view details)

Uploaded Mar 30, 2022 CPython 3.9 Windows x86

watchfiles-0.11-cp39-cp39-manylinux_2_24_x86_64.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.9 manylinux: glibc 2.24+ x86-64

watchfiles-0.11-cp39-cp39-manylinux_2_24_i686.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.9 manylinux: glibc 2.24+ i686

watchfiles-0.11-cp39-cp39-macosx_11_0_arm64.whl (275.4 kB view details)

Uploaded Mar 30, 2022 CPython 3.9 macOS 11.0+ ARM64

watchfiles-0.11-cp39-cp39-macosx_10_9_x86_64.whl (286.5 kB view details)

Uploaded Mar 30, 2022 CPython 3.9 macOS 10.9+ x86-64

watchfiles-0.11-cp38-cp38-win_amd64.whl (204.0 kB view details)

Uploaded Mar 30, 2022 CPython 3.8 Windows x86-64

watchfiles-0.11-cp38-cp38-win32.whl (198.3 kB view details)

Uploaded Mar 30, 2022 CPython 3.8 Windows x86

watchfiles-0.11-cp38-cp38-manylinux_2_24_x86_64.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.8 manylinux: glibc 2.24+ x86-64

watchfiles-0.11-cp38-cp38-manylinux_2_24_i686.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.8 manylinux: glibc 2.24+ i686

watchfiles-0.11-cp38-cp38-macosx_11_0_arm64.whl (275.3 kB view details)

Uploaded Mar 30, 2022 CPython 3.8 macOS 11.0+ ARM64

watchfiles-0.11-cp38-cp38-macosx_10_9_x86_64.whl (286.9 kB view details)

Uploaded Mar 30, 2022 CPython 3.8 macOS 10.9+ x86-64

watchfiles-0.11-cp37-cp37m-win_amd64.whl (204.0 kB view details)

Uploaded Mar 30, 2022 CPython 3.7m Windows x86-64

watchfiles-0.11-cp37-cp37m-win32.whl (198.3 kB view details)

Uploaded Mar 30, 2022 CPython 3.7m Windows x86

watchfiles-0.11-cp37-cp37m-manylinux_2_24_x86_64.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.7m manylinux: glibc 2.24+ x86-64

watchfiles-0.11-cp37-cp37m-manylinux_2_24_i686.whl (1.1 MB view details)

Uploaded Mar 30, 2022 CPython 3.7m manylinux: glibc 2.24+ i686

watchfiles-0.11-cp37-cp37m-macosx_10_9_x86_64.whl (286.9 kB view details)

Uploaded Mar 30, 2022 CPython 3.7m macOS 10.9+ x86-64

File details

Details for the file watchfiles-0.11.tar.gz.

File metadata

Download URL: watchfiles-0.11.tar.gz
Upload date: Mar 30, 2022
Size: 19.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for watchfiles-0.11.tar.gz
Algorithm	Hash digest
SHA256	`928dc85658a2e3142124d9848e85b4e283f4c579ba0bff43e7ec8892eddf2ebd`
MD5	`f260b6f298490fa4fab08a93d0db79a7`
BLAKE2b-256	`beceaa2ac02eaf308154a24f1d4f6e960a10b88d03721d7cff2ea233e2d4455e`

Algorithm	Hash digest
SHA256	`c59c5af1c7aa31d6f052370562601dfc72fac8000c0c58b456c87fe021b19940`
MD5	`107da6bd73eab916186291c0cb4503fa`
BLAKE2b-256	`be5c9daf08136ae686a01c000446d4b9d67ddfd5aa9fd34223e5162a03af10cc`

Algorithm	Hash digest
SHA256	`d268901007c68246cfd46fc2242d5845136ad7c94b6a3cf625c5464e14067765`
MD5	`531e24129e698deb4f2459c8da6fe135`
BLAKE2b-256	`2176007b1acc47d228ccc87cb30c22cdc0094708e3db1bdcb3b8e67197867c18`

Algorithm	Hash digest
SHA256	`9097e76813c62e0edaaa5d5d94b8431ce13db59324faecf4f09cee86ceb0ed1c`
MD5	`f40f4314ef6e12f818883121fe03db49`
BLAKE2b-256	`58156ae851959c8265a1333a28c4c632143fb27c5d633649c30d67785c7ea25e`

Algorithm	Hash digest
SHA256	`86e395ce5be40564022199fd8816a70b992100713cf6381cd92004551b937c75`
MD5	`81069d337b4ccb1ea396790023580afb`
BLAKE2b-256	`50d7babeaf907efa161d05e705f76a8e2ab5a0b8b53248e04666b1eaf3c2e2d5`

Algorithm	Hash digest
SHA256	`9a9bc393dbb41a8b53c2e349275cb49f3d9d8d945be9a1a49660a1393366d32e`
MD5	`5df071ec8d4fed8fbfc22dc3e179f548`
BLAKE2b-256	`c1977ea010154a59b5679cd9deaa46e828b54a6e70f51203636adac21480f9f1`

Algorithm	Hash digest
SHA256	`96eba8bea75d6de64a6f4fad17014cf1bf06568be4649caee0c7ab0d21acc222`
MD5	`906c6b4ec9e3d7d63a423616d33122f3`
BLAKE2b-256	`f8d6f748c764a3828af0e45b9e043fed845c3588a365274e5f1920607e384f9b`

Algorithm	Hash digest
SHA256	`7bec62ef305d4365497752256893619acb9b80a27f708beb074113495e38e506`
MD5	`be83fa662a645260816e1f2b6b583431`
BLAKE2b-256	`1a4e00cf54a451ef7a098252f0f123c265289afa1f76e9d0e2515e5b4485052c`

Algorithm	Hash digest
SHA256	`607358fc5670422c1c5d421eb2527fdde3d75d49a4aba4d81e93d94d2a107cc4`
MD5	`4fd2e63c07728e75968f6a03645f76aa`
BLAKE2b-256	`8084ac996be60a7ef67a76bf32ed7b144ba1dd3d710d992e028dab581848e18c`

Algorithm	Hash digest
SHA256	`c6e9a670e64353dd870c40d8532172effea489d6d0fdeea36954743c38ce3de7`
MD5	`85bccdc8cc9fe5c78fe7478e00a629bf`
BLAKE2b-256	`9d3669f1f5bb5e2df06b60e65ce8b580ad5a2eb6c5a97479328a8c04c20270d0`

Algorithm	Hash digest
SHA256	`937a624ad1f3f86380b5916e3003b807dfaa692be15018de0aacac5e0b2954bd`
MD5	`7d94321a81cdb8fdc7c4036e9f8237cb`
BLAKE2b-256	`13eec52baffb5590f7f7defba164617622638b40278c61155338797592afc970`

Algorithm	Hash digest
SHA256	`69f3115eeddd3096dc61484b02e4fcfda0be6b781c0a4935aab03f99307f0d45`
MD5	`a67bfd11ed0f625d9a0d05e91e481d25`
BLAKE2b-256	`bace2e61348408b5345628bad3eb5a8568f874cb923da7259d3d5f96dcf14560`

Algorithm	Hash digest
SHA256	`19bf282f5b1939e873083a02390e5f5f18d97e20e8c2f996dbacffb9d43725c5`
MD5	`6524cb9bdf9966291be1f3a3e39beb84`
BLAKE2b-256	`f53647717e1fe28f32777a3fa13ebae328520bebb0a92fffea1fdc65b7fb26f1`

Algorithm	Hash digest
SHA256	`c1334548a4e19c0330ef4f8e634e53d21d3ea5e70b3f427d41852c10bec5b818`
MD5	`82eac9afb211318bf4074ec7efe00673`
BLAKE2b-256	`1b7d78f6796ff7c4fc66838eec636d734d698a1e19071913ef25671f6558c914`

Algorithm	Hash digest
SHA256	`808311e97bc6e9c26fdc3c15d04aa567782048e6b90955b96d3c53f740609a0a`
MD5	`8a7485359b5d070e1d7f0404e26be183`
BLAKE2b-256	`f3af610644ec08153e0bb4d344c73bd0db9d01c3cdf7ae5f72156494190e79e6`

Algorithm	Hash digest
SHA256	`81941ca4f661f9e88dfcf63dbca082a57d882c25dd0c0298ef140141683b7734`
MD5	`75ab63cb2ea5300291f95f630311aab0`
BLAKE2b-256	`33eeeee1b72fb65c98f712427f55b6dffedbf963db73903ee7287a92fb3f9e7f`

Algorithm	Hash digest
SHA256	`d9b8cc4bc830bc66c94ec85714dffbd0ce36f4275459ee099b1af2a4966d20c4`
MD5	`1c52d9acd801b9af718fdc51c7a067de`
BLAKE2b-256	`1814b6ba53ddb9ec005b3c2702dcbdee41bbf79f933bdf4a8493682e0ad4b79f`

Algorithm	Hash digest
SHA256	`2da15ea0fb97842dd6773323f05d487eddecdf07d8f84156db3fc9285798562d`
MD5	`77d99e5c6fd81d9ce7c24e16e7cbc961`
BLAKE2b-256	`5f9f2590d554aa60182100c7c3f33b2def155c0e25321f54d586ac43b389292d`

Algorithm	Hash digest
SHA256	`bc3242bc220a3df45dcaa37d0d8b4ac59a9329ff68b7db520b97b13285c7b269`
MD5	`6c2f875420d1eefefb4bf00804435101`
BLAKE2b-256	`0dda832b05444e9a3fd84850a0e9584911f4ba2b8366536cb34cc38d796daeca`

Algorithm	Hash digest
SHA256	`1cec9d1818268da93c9502d548533090ead9ea6beb3c9fae99ab2c7fafad217d`
MD5	`5a7598ddca1c33df7200ca706e33f3d5`
BLAKE2b-256	`01ec5945ffdff661242aec6a8506362ae6d8616346db7007776a924dbe11078e`

Algorithm	Hash digest
SHA256	`ece8af194aeabdd07433219663d94544f249a1d08fb8da1e8a9293b71b1bfa1c`
MD5	`dcb2456153aef30dff7d4048439a9b46`
BLAKE2b-256	`f1d083c1b6a1a29d749bcf7f7da2adac9204a3e02262da6f4fe0f601378d19c0`

watchfiles 0.11

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

watchfiles

NOTICE

Installation

Usage

Asynchronous Methods

Custom Filters

CLI

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

Algorithm	Hash digest
SHA256	`0ff3b307d024fbedde5be842fb64be301904809ea98571f94d2e5f112ee5bc1d`
MD5	`372da1811fa1e70b11ee6a83233c0577`
BLAKE2b-256	`d8d6691147c003cffe13ef7fd3ddeba4d7962cdb599380525c32f76a625ae2be`

Algorithm	Hash digest
SHA256	`6365db13e7f58028f132f03a4de29d2c2543f8b62afdaa2970f2089e634e6e7c`
MD5	`c16419068b8b9e262c0d1a403d287b36`
BLAKE2b-256	`cb4a847d7c64b82710f428c4f0d3c0555d4a1fbaec18e7d059e450c872079e4f`

Algorithm	Hash digest
SHA256	`bcc7e748c1dc1c87fcd164a4506762f46e5a64c4892166e83aeb73d53963728f`
MD5	`ff6d9c13744d9a98c2592807425ef0a9`
BLAKE2b-256	`b62b8018e5687f71ea9d3d0b54eaa47764821381a96e02e9e25b16dcabb6bdcd`