plain.jobs 0.33.0__tar.gz → 0.34.0__tar.gz

{plain_jobs-0.33.0 → plain_jobs-0.34.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.jobs
-Version: 0.33.0
+Version: 0.34.0
 Summary: Process background jobs with a database-driven job queue.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE
@@ -66,15 +66,17 @@ plain migrate
 
 ## Local development
 
-In development, you will typically want to run the worker alongside your app. With [`plain.dev`](/plain-dev/plain/dev/README.md) you can do this by adding it to the `[tool.plain.dev.run]` section of your `pyproject.toml` file. Currently, you will need to use something like [watchfiles](https://pypi.org/project/watchfiles/) to add auto-reloading to the worker.
+In development, you will typically want to run the worker alongside your app with auto-reloading enabled. With [`plain.dev`](/plain-dev/plain/dev/README.md) you can do this by adding it to the `[tool.plain.dev.run]` section of your `pyproject.toml` file.
 
 ```toml
 # pyproject.toml
 [tool.plain.dev.run]
-worker = {cmd = "watchfiles --filter python \"plain jobs worker --stats-every 0 --max-processes 2\" ."}
-worker-slow = {cmd = "watchfiles --filter python \"plain jobs worker --queue slow --stats-every 0 --max-processes 2\" ."}
+worker = {cmd = "plain jobs worker --reload --stats-every 0 --max-processes 2"}
+worker-slow = {cmd = "plain jobs worker --reload --queue slow --stats-every 0 --max-processes 2"}
 ```
 
+The `--reload` flag will automatically watch `.py` and `.env*` files for changes and restart the worker when changes are detected.
+
 ## Job parameters
 
 When calling `run_in_worker()`, you can specify several parameters to control job execution:

{plain_jobs-0.33.0 → plain_jobs-0.34.0}/plain/jobs/CHANGELOG.md

@@ -1,5 +1,16 @@
 # plain-jobs changelog
 
+## [0.34.0](https://github.com/dropseed/plain/releases/plain-jobs@0.34.0) (2025-10-13)
+
+### What's changed
+
+- Added `--reload` flag to `plain jobs worker` command for automatic reloading when code changes are detected ([f3db87e9aa](https://github.com/dropseed/plain/commit/f3db87e9aa))
+- Worker reloader now only watches `.py` and `.env*` files, not HTML files ([f2f31c288b](https://github.com/dropseed/plain/commit/f2f31c288b))
+
+### Upgrade instructions
+
+- Custom autoreloaders for development are no longer needed -- use the built-in `--reload` flag instead
+
 ## [0.33.0](https://github.com/dropseed/plain/releases/plain-jobs@0.33.0) (2025-10-10)
 
 ### What's changed

{plain_jobs-0.33.0 → plain_jobs-0.34.0}/plain/jobs/README.md

@@ -55,15 +55,17 @@ plain migrate
 
 ## Local development
 
-In development, you will typically want to run the worker alongside your app. With [`plain.dev`](/plain-dev/plain/dev/README.md) you can do this by adding it to the `[tool.plain.dev.run]` section of your `pyproject.toml` file. Currently, you will need to use something like [watchfiles](https://pypi.org/project/watchfiles/) to add auto-reloading to the worker.
+In development, you will typically want to run the worker alongside your app with auto-reloading enabled. With [`plain.dev`](/plain-dev/plain/dev/README.md) you can do this by adding it to the `[tool.plain.dev.run]` section of your `pyproject.toml` file.
 
 ```toml
 # pyproject.toml
 [tool.plain.dev.run]
-worker = {cmd = "watchfiles --filter python \"plain jobs worker --stats-every 0 --max-processes 2\" ."}
-worker-slow = {cmd = "watchfiles --filter python \"plain jobs worker --queue slow --stats-every 0 --max-processes 2\" ."}
+worker = {cmd = "plain jobs worker --reload --stats-every 0 --max-processes 2"}
+worker-slow = {cmd = "plain jobs worker --reload --queue slow --stats-every 0 --max-processes 2"}
 ```
 
+The `--reload` flag will automatically watch `.py` and `.env*` files for changes and restart the worker when changes are detected.
+
 ## Job parameters
 
 When calling `run_in_worker()`, you can specify several parameters to control job execution:

{plain_jobs-0.33.0 → plain_jobs-0.34.0}/plain/jobs/cli.py

@@ -62,35 +62,80 @@ def cli() -> None:
     type=int,
     envvar="PLAIN_JOBS_WORKER_STATS_EVERY",
 )
+@click.option(
+    "--reload",
+    is_flag=True,
+    help="Watch files and auto-reload worker on changes",
+)
 def worker(
     queues: tuple[str, ...],
     max_processes: int | None,
     max_jobs_per_process: int | None,
     max_pending_per_process: int,
     stats_every: int,
+    reload: bool,
 ) -> None:
     """Run the job worker."""
     jobs_schedule = load_schedule(settings.JOBS_SCHEDULE)
 
-    worker = Worker(
-        queues=list(queues),
-        jobs_schedule=jobs_schedule,
-        max_processes=max_processes,
-        max_jobs_per_process=max_jobs_per_process,
-        max_pending_per_process=max_pending_per_process,
-        stats_every=stats_every,
-    )
-
-    def _shutdown(signalnum: int, _: Any) -> None:
-        logger.info("Job worker shutdown signal received signalnum=%s", signalnum)
-        worker.shutdown()
-
-    # Allow the worker to be stopped gracefully on SIGTERM
-    signal.signal(signal.SIGTERM, _shutdown)
-    signal.signal(signal.SIGINT, _shutdown)
-
-    # Start processing jobs
-    worker.run()
+    if reload:
+        from plain.internal.reloader import Reloader
+
+        # Track whether we should continue restarting
+        should_restart = {"value": True}
+        current_worker = {"instance": None}
+
+        def file_changed(filename: str) -> None:
+            if current_worker["instance"]:
+                current_worker["instance"].shutdown()
+
+        def signal_shutdown(signalnum: int, _: Any) -> None:
+            should_restart["value"] = False
+            if current_worker["instance"]:
+                current_worker["instance"].shutdown()
+
+        # Allow the worker to be stopped gracefully on SIGTERM/SIGINT
+        signal.signal(signal.SIGTERM, signal_shutdown)
+        signal.signal(signal.SIGINT, signal_shutdown)
+
+        # Start file watcher once, outside the loop
+        reloader = Reloader(callback=file_changed, watch_html=False)
+        reloader.start()
+
+        while should_restart["value"]:
+            worker = Worker(
+                queues=list(queues),
+                jobs_schedule=jobs_schedule,
+                max_processes=max_processes,
+                max_jobs_per_process=max_jobs_per_process,
+                max_pending_per_process=max_pending_per_process,
+                stats_every=stats_every,
+            )
+            current_worker["instance"] = worker
+
+            # Start processing jobs (blocks until shutdown)
+            worker.run()
+
+    else:
+        worker = Worker(
+            queues=list(queues),
+            jobs_schedule=jobs_schedule,
+            max_processes=max_processes,
+            max_jobs_per_process=max_jobs_per_process,
+            max_pending_per_process=max_pending_per_process,
+            stats_every=stats_every,
+        )
+
+        def _shutdown(signalnum: int, _: Any) -> None:
+            logger.info("Job worker shutdown signal received signalnum=%s", signalnum)
+            worker.shutdown()
+
+        # Allow the worker to be stopped gracefully on SIGTERM
+        signal.signal(signal.SIGTERM, _shutdown)
+        signal.signal(signal.SIGINT, _shutdown)
+
+        # Start processing jobs
+        worker.run()
 
 
 @cli.command()

{plain_jobs-0.33.0 → plain_jobs-0.34.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plain.jobs"
-version = "0.33.0"
+version = "0.34.0"
 description = "Process background jobs with a database-driven job queue."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 readme = "README.md"