plain.jobs 0.36.2__py3-none-any.whl → 0.37.0__py3-none-any.whl

plain/jobs/CHANGELOG.md

@@ -1,5 +1,26 @@
 # plain-jobs changelog
 
+## [0.37.0](https://github.com/dropseed/plain/releases/plain-jobs@0.37.0) (2025-10-22)
+
+### What's changed
+
+- Added `JobMiddleware` abstract base class for creating custom job middleware ([29e5c6df1a](https://github.com/dropseed/plain/commit/29e5c6df1a))
+- Changed "preparing to execute job" log message from `logger.info` to `logger.debug` to reduce log noise ([8e25856639](https://github.com/dropseed/plain/commit/8e25856639))
+
+### Upgrade instructions
+
+- If you have custom job middleware, update them to inherit from `JobMiddleware` and implement the `process_job()` method instead of `__call__()`
+
+## [0.36.3](https://github.com/dropseed/plain/releases/plain-jobs@0.36.3) (2025-10-20)
+
+### What's changed
+
+- Added garbage collection back to worker processes after job completion to help manage memory usage ([aafe3ace02](https://github.com/dropseed/plain/commit/aafe3ace02))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.36.2](https://github.com/dropseed/plain/releases/plain-jobs@0.36.2) (2025-10-20)
 
 ### What's changed

plain/jobs/__init__.py

@@ -1,4 +1,5 @@
 from .jobs import Job
+from .middleware import JobMiddleware
 from .registry import register_job
 
-__all__ = ["Job", "register_job"]
+__all__ = ["Job", "JobMiddleware", "register_job"]

plain/jobs/middleware.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from abc import ABC, abstractmethod
 from collections.abc import Callable
 from typing import TYPE_CHECKING
 
@@ -9,11 +10,32 @@ if TYPE_CHECKING:
     from .models import JobProcess, JobResult
 
 
-class AppLoggerMiddleware:
-    def __init__(self, run_job: Callable[[JobProcess], JobResult]) -> None:
+class JobMiddleware(ABC):
+    """
+    Abstract base class for job middleware.
+
+    Subclasses must implement process_job() to handle the job execution cycle.
+
+    Example:
+        class MyJobMiddleware(JobMiddleware):
+            def process_job(self, job: JobProcess) -> JobResult:
+                # Pre-processing
+                result = self.run_job(job)
+                # Post-processing
+                return result
+    """
+
+    def __init__(self, run_job: Callable[[JobProcess], JobResult]):
         self.run_job = run_job
 
-    def __call__(self, job: JobProcess) -> JobResult:
+    @abstractmethod
+    def process_job(self, job: JobProcess) -> JobResult:
+        """Process the job and return a result. Must be implemented by subclasses."""
+        ...
+
+
+class AppLoggerMiddleware(JobMiddleware):
+    def process_job(self, job: JobProcess) -> JobResult:
         with app_logger.include_context(
             job_request_uuid=str(job.job_request_uuid), job_process_uuid=str(job.uuid)
         ):

plain/jobs/workers.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import gc
 import logging
 import multiprocessing
 import os
@@ -143,7 +144,7 @@ class Worker:
                     time.sleep(1)
                     continue
 
-                logger.info(
+                logger.debug(
                     'Preparing to execute job job_class=%s job_request_uuid=%s job_priority=%s job_source="%s" job_queues="%s"',
                     job_request.job_class,
                     job_request.uuid,
@@ -326,7 +327,7 @@ def process_job(job_process_uuid: str) -> None:
         for middleware_path in reversed(settings.JOBS_MIDDLEWARE):
             middleware_class = import_string(middleware_path)
             middleware_instance = middleware_class(middleware_chain)
-            middleware_chain = middleware_instance
+            middleware_chain = middleware_instance.process_job
 
         job_result = middleware_chain(job_process)
 
@@ -353,3 +354,4 @@ def process_job(job_process_uuid: str) -> None:
         logger.exception(e)
     finally:
         request_finished.send(sender=None)
+        gc.collect()

{plain_jobs-0.36.2.dist-info → plain_jobs-0.37.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.jobs
-Version: 0.36.2
+Version: 0.37.0
 Summary: Process background jobs with a database-driven job queue.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE

{plain_jobs-0.36.2.dist-info → plain_jobs-0.37.0.dist-info}/RECORD

@@ -1,18 +1,18 @@
-plain/jobs/CHANGELOG.md,sha256=jCOSyuP7LrxP-tkEk4YgHbESlUNjsHhsnrL_Yk7fvqs,12604
+plain/jobs/CHANGELOG.md,sha256=NWsCgXUWmrbBni77ILNwuF0HYJOkbf02JunTu09syF0,13534
 plain/jobs/README.md,sha256=Xuhz2Q48G9WeGCh5OWGVBlaSea4eKCqWzcTAtZRrS0I,6835
-plain/jobs/__init__.py,sha256=p2ATql3HyPzPTV34gJQ04caT7tcNQLbBGM6uIoDPbjo,92
+plain/jobs/__init__.py,sha256=yN6m5CxQuzB5tKVXVPwGSSh2jtwQybVDHj1V4M3z2F0,147
 plain/jobs/admin.py,sha256=t1UEchq1-Eews_wPsVUofaqbzPaYpb-8H1bUlA59JGI,6785
 plain/jobs/chores.py,sha256=oyVU-BfcJxMM3eK2_umn38N2mBsNpcDrZfpeEQju_DA,528
 plain/jobs/cli.py,sha256=PPoT7xjl818BZnmI0yA_UCLEQkzl_Tv1_hiuJW9UE-Q,5911
 plain/jobs/config.py,sha256=PQsl-LxWsWLnjC98f0mvtdcCOuXvXKDMjrCRf1fq44Y,550
 plain/jobs/default_settings.py,sha256=r_95ucg_KY1XW1jarZy8VO3p-ylbllKMUrHzOPJiX6U,227
 plain/jobs/jobs.py,sha256=-tBt_5V2KwGui7OpBcq1gANVn3YvKEoBJn0MXNlnKlo,7761
-plain/jobs/middleware.py,sha256=bz8aPBY0RbtLS4kic8mzPOd3EyQFCVRQ2uTCttT3RpE,573
+plain/jobs/middleware.py,sha256=iQbVPnQz91OpkfNFsDh6-G0RLWW7KxYssUKdk7JEdNE,1228
 plain/jobs/models.py,sha256=TYOjMT0dSF69uzfY2m13ZPwo6G0WOVJUbgJvsDFxBhI,15889
 plain/jobs/parameters.py,sha256=t9PwEZgwNCJx3YobsT-jfaVZdfMBS54XJcBrT9Wnsg0,6313
 plain/jobs/registry.py,sha256=Rwn5Htll10e549vD2Mu0oyoDynyHhE0bGYZ2bq9uzPU,1679
 plain/jobs/scheduling.py,sha256=fqpFnVoIIV-muf82WzuLyioSmiilfZ76KFjXzt8grIk,7851
-plain/jobs/workers.py,sha256=q8bixbv1m5iZMiQRYVfGGzlDF80T12zm0QNE1EUatj4,13514
+plain/jobs/workers.py,sha256=eqaFqHRtpzh2QBdQ0dfUSMXMzpoxZOUlxw-7N661cUs,13558
 plain/jobs/migrations/0001_initial.py,sha256=EIgIEMVyTsStyx9dmKM8Jb_hwn694Yo31-74DZkNTqo,9452
 plain/jobs/migrations/0002_job_span_id_job_trace_id_jobrequest_span_id_and_more.py,sha256=ph5BwwOAwdfjdNh9RItYmX_IA29lO-Dd9GymYzvChXQ,1953
 plain/jobs/migrations/0003_rename_job_jobprocess_and_more.py,sha256=EdLucHxiH_QshLL2peIcMULRCQyFMPxh476AxCxW5Wk,2615
@@ -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.36.2.dist-info/METADATA,sha256=sGER074rn4FofXat4ApF4UQK3G2In_Tl7J3-_zf_Br8,7162
-plain_jobs-0.36.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_jobs-0.36.2.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
-plain_jobs-0.36.2.dist-info/RECORD,,
+plain_jobs-0.37.0.dist-info/METADATA,sha256=geJ8q9B-FRjIjkx069lyjHp8vnaN2KrbZ3hpJ3Y9IEE,7162
+plain_jobs-0.37.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_jobs-0.37.0.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
+plain_jobs-0.37.0.dist-info/RECORD,,