duck.contrib.reloader.ducksight

Ducksight Reloader

Watches for file changes in Duck framework projects and restarts the webserver in DEBUG mode whenever relevant .py files change.

Module Contents

Classes

DuckSightReloader	Monitors the project directory for Python file changes and triggers reloads.
Handler	Handles filesystem events and triggers debounced full server reloads.

API

class duck.contrib.reloader.ducksight.DuckSightReloader(watch_dir: str)

Monitors the project directory for Python file changes and triggers reloads.

Initialization

run()

Start the observer loop; ensures single reloader process is active.

… admonition:: Notes

This method is blocking.

stop()

Stops the reloader.

class duck.contrib.reloader.ducksight.Handler(debounce_interval=0.6)

Bases: watchdog.events.FileSystemEventHandler

Handles filesystem events and triggers debounced full server reloads.

Initialization

_trigger_restart()

Trigger the real restart.

on_any_event(event)

Called on any filesystem event; filters .py files and schedules reload.

restart_webserver(changed_file: str)

Perform the actual server reload.

Parameters:

changed_file – This is the path to the file which triggered this reload.