plain.jobs 0.33.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

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/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/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.dist-info → plain_jobs-0.34.0.dist-info}/METADATA

@@ -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.dist-info → plain_jobs-0.34.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
-plain/jobs/CHANGELOG.md,sha256=OWHFWE2xIcsfdhYTK999K06ilx6Ioc0sP4_2EzfMML8,8823
-plain/jobs/README.md,sha256=mzaGucJn54gBG4bobjjIj0hHUAYXz-0SsQZIRd503nI,6858
+plain/jobs/CHANGELOG.md,sha256=6jaE6mdMVx7jX9UFk5eEqT31LC0CgRVTJHGrwObeES4,9384
+plain/jobs/README.md,sha256=Xuhz2Q48G9WeGCh5OWGVBlaSea4eKCqWzcTAtZRrS0I,6835
 plain/jobs/__init__.py,sha256=p2ATql3HyPzPTV34gJQ04caT7tcNQLbBGM6uIoDPbjo,92
 plain/jobs/admin.py,sha256=IhB6nkHKHB5CJfwPEoNW4pQKUi_4ewpNGkOCo4XwO0g,6719
 plain/jobs/chores.py,sha256=5WdLlCDPppX78yfS4LczIG7UeVR9DAoJsJHTT2Codd4,483
-plain/jobs/cli.py,sha256=gDkyMBeKsv-vE1vnZdIsg1wv2PDSWwOYr2GHtgbQIlg,4087
+plain/jobs/cli.py,sha256=KnazGup1JumjrSjhoMO2FwgLBATRW70YewkdMcLzsrI,5683
 plain/jobs/config.py,sha256=PQsl-LxWsWLnjC98f0mvtdcCOuXvXKDMjrCRf1fq44Y,550
 plain/jobs/default_settings.py,sha256=r_95ucg_KY1XW1jarZy8VO3p-ylbllKMUrHzOPJiX6U,227
 plain/jobs/jobs.py,sha256=IPQ2vlhfLm5gvdZTR52WINDAWRUPN0Mjc_EhKjqYhAk,7843
@@ -21,7 +21,7 @@ plain/jobs/migrations/0005_rename_constraints_and_indexes.py,sha256=PDGpOw6__tVf
 plain/jobs/migrations/0006_alter_jobprocess_table_alter_jobrequest_table_and_more.py,sha256=FY0_pcw0mL8MkUSatpDXWtA_xQw0kTZBGIyjLcmYeJE,546
 plain/jobs/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/jobs/templates/admin/plainqueue/jobresult_detail.html,sha256=Ybp1s_dARo_bFDcLEzEfETheP8SzqHHE_NNSKhv_eh8,198
-plain_jobs-0.33.0.dist-info/METADATA,sha256=0GquVURZJxnR44lGpSrgYSg2LxKvXaXz7URnpSQjCCk,7185
-plain_jobs-0.33.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_jobs-0.33.0.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
-plain_jobs-0.33.0.dist-info/RECORD,,
+plain_jobs-0.34.0.dist-info/METADATA,sha256=8uXilZ1ZfAqKsipubMNFgbcBY6KD2JLa7eGqavgtZTk,7162
+plain_jobs-0.34.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_jobs-0.34.0.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
+plain_jobs-0.34.0.dist-info/RECORD,,