Package Health Score

88 / 100

security
No known security issues
popularity
Key ecosystem project
maintenance
Healthy
community
Sustainable

Explore Similar Packages

watchdog
94

Popularity

Key ecosystem project

GitHub Stars: 1.83K
Forks: 108
Contributors: 50

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package watchfiles, we found that it has been starred 1,833 times.

Security

No known security issues

Security and license risk for latest version

Release Date: Dec 10, 2024
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
0
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

MIT

Security Policy

We found a way for you to contribute to the project! Looks like watchfiles is missing a security policy.

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Healthy

Commit Frequency

Open Issues: 22
Open PR: 1
Last Release: 12 days ago
Last Commit: 12 days ago

Further analysis of the maintenance status of watchfiles based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Healthy.

We found that watchfiles demonstrates a positive version release cadence with at least one new version released in the past 3 months.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Community

Sustainable

Readme: Yes
Contributing.md: No
Code of Conduct: No
Contributors: 50
Funding: Yes

With more than 10 contributors for the watchfiles repository, this is possibly a sign for a growing and inviting community.

We found a way for you to contribute to the project! Looks like watchfiles is missing a Code of Conduct.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: >=3.9

Age: 3 years
Latest Release: 12 days ago
Dependencies: 0 Direct
Versions: 24
Maintainers: 1
Wheels: Linux, macOS, Musllinux, Windows

Readme

watchfiles

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

Documentation: watchfiles.helpmanual.io

Source Code: github.com/samuelcolvin/watchfiles

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

This package was previously named "watchgod", see the migration guide for more information.

Installation

watchfiles requires Python 3.8 - 3.13.

pip install watchfiles

Binaries are available for:

Linux: x86_64, aarch64, i686, armv7l, musl-x86_64 & musl-aarch64
MacOS: x86_64 & arm64
Windows: amd64 & win32

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

Usage

Here are some examples of what watchfiles can do:

`watch` Usage

from watchfiles import watch

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

See watch docs for more details.

`awatch` Usage

import asyncio
from watchfiles import awatch

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

asyncio.run(main())

See awatch docs for more details.

`run_process` Usage

from watchfiles import run_process

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

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

See run_process docs for more details.

`arun_process` Usage

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())

See arun_process docs for more details.

CLI

watchfiles also comes with a CLI for running and reloading code. To run some command when files in src change:

watchfiles "some command" src

For more information, see the CLI docs.

Or run

watchfiles --help

FAQs

What is watchfiles?

Simple, modern and high performance file watching and code reload in python. Visit Snyk Advisor to see a full health score report for watchfiles, including popularity, security, maintenance & community analysis.

Is watchfiles popular?

The python package watchfiles receives a total of 2,518,890 weekly downloads. As such, watchfiles popularity was classified as a key ecosystem project. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is watchfiles well maintained?

We found that watchfiles demonstrated a healthy version release cadence and project activity. It has a community of 50 open source contributors collaborating on the project. See the full package health analysis to learn more about the package maintenance status.

Is watchfiles safe to use?

The python package watchfiles was scanned for known vulnerabilities and missing license, and no issues were found. Thus the package was deemed as safe to use. See the full health analysis review.

Last updated on 22 December-2024, at 09:31 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP

watchfiles

Simple, modern and high performance file watching and code reload in python. For more information about how to use this package see README

Ensure you're using the healthiest python packages

Package Health Score

Explore Similar Packages

Popularity

Direct Usage Popularity

Security

Security and license risk for latest version

Maintenance

Commit Frequency

Community

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Package

Readme

watchfiles

Installation

Usage

`watch` Usage

`awatch` Usage

`run_process` Usage

`arun_process` Usage

CLI

FAQs

What is watchfiles?

Is watchfiles popular?

Is watchfiles well maintained?

Is watchfiles safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Fix identified vulnerabilities

Monitor for new issues

Package Health Score

Explore Similar Packages

Direct Usage Popularity

Security and license risk for latest version

Commit Frequency

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Readme

watchfiles

Installation

Usage

watch Usage

awatch Usage

run_process Usage

arun_process Usage

CLI

FAQs

What is watchfiles?

Is watchfiles popular?

Is watchfiles well maintained?

Is watchfiles safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Source Code

Open Source

Container

Config

Fix identified vulnerabilities

Monitor for new issues

`watch` Usage

`awatch` Usage

`run_process` Usage

`arun_process` Usage