Skip to main content

fs-watchdog

GitHub PyPI Version License Buy Me A Coffee

File system Watchdog wrapper (CLI). Monitors a directory and logs events.

Install

From PyPI:

pip install fs-watchdog

(Recommended for CLI tools)

pipx install fs-watchdog

Usage

fs-watchdog <DIRECTORY_PATH>

Examples:

Windows:

fs-watchdog "C:\Users\User\Documents"

macOS / Linux:

fs-watchdog /Users/user/Documents

You can also run as a module:

python -m file_watchdog <DIRECTORY_PATH>

Output

  • Events are logged to the console in the following format:

    [HEX_TIMESTAMP] event_type: path/to/file
    
  • Events are also saved to a log file named watchdog_events_<timestamp>.log.

  • The log file is created in the current working directory.

  • Log file entries use ISO timestamp format (UTC, Z suffix):

    [2024-04-02T12:34:56.789012Z] event_type: path/to/file
    

Finishing up

Press Ctrl+C to stop monitoring.

See also

My other small but snappy Python tools and automation,

  • github-stargazers – Python 3.13 – Github Stargazer Scraper.
  • img2pdf_helper – Simplify img2pdf configuration and usage.
  • fs-watchdog – Python 3.14 – file system Watchdog wrapper.

Tim Abdiukov

Release files for fs-watchdog 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fs-watchdog 0.1.4
File Size Uploaded
fs_watchdog-0.1.4.tar.gz 8.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fs-watchdog 0.1.4
File Interpreter ABI Platform
fs_watchdog-0.1.4-py3-none-any.whl Python 3 none any Details

Total release size: 16.8 kB

Release files / fs_watchdog-0.1.4.tar.gz

Download URL fs_watchdog-0.1.4.tar.gz
Size 8.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2c9f7455ea03e4dde2d5376ab5c5a2aaf0c683a41474cdf2ea6d40c116f2f6a5
BLAKE2b-256 checksum
How to use checksums
5661d1e3f8d4d8860049b59ce1c2587ba8ded5fceb54ef8a59ea77ac64caf2fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.2

Release files / fs_watchdog-0.1.4-py3-none-any.whl

Download URL fs_watchdog-0.1.4-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c52d9bc63189ef840a903f2e2569793e331436776354dacde88108c08395084e
BLAKE2b-256 checksum
How to use checksums
87f64f31652d473d642d30c471b291799171275a4d394b8c12baf2e7cfd78c49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.2

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page