python-pq 0.6.0__tar.gz → 0.6.1__tar.gz

{python_pq-0.6.0 → python_pq-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pq
-Version: 0.6.0
+Version: 0.6.1
 Summary: Postgres-backed job queue for Python
 Keywords: postgres,job-queue,task-queue,background-jobs,worker
 Author: ricwo
@@ -248,6 +248,18 @@ pq.run_worker(pre_execute=setup_tracing, post_execute=flush_tracing)
 
 Hooks run in the forked child, making them safe for fork-unsafe resources like OpenTelemetry.
 
+## Logging
+
+pq uses [loguru](https://github.com/Delgan/loguru) internally and does **not** configure the logger on import. This means it inherits whatever logging setup the host application has already established.
+
+If you are running pq as a standalone script and want pq's default log format, call `configure_logging()` explicitly during startup:
+
+```python
+from pq.logging import configure_logging
+
+configure_logging()
+```
+
 ## Serialization
 
 Arguments are serialized automatically:

{python_pq-0.6.0 → python_pq-0.6.1}/README.md

@@ -212,6 +212,18 @@ pq.run_worker(pre_execute=setup_tracing, post_execute=flush_tracing)
 
 Hooks run in the forked child, making them safe for fork-unsafe resources like OpenTelemetry.
 
+## Logging
+
+pq uses [loguru](https://github.com/Delgan/loguru) internally and does **not** configure the logger on import. This means it inherits whatever logging setup the host application has already established.
+
+If you are running pq as a standalone script and want pq's default log format, call `configure_logging()` explicitly during startup:
+
+```python
+from pq.logging import configure_logging
+
+configure_logging()
+```
+
 ## Serialization
 
 Arguments are serialized automatically:

{python_pq-0.6.0 → python_pq-0.6.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-pq"
-version = "0.6.0"
+version = "0.6.1"
 description = "Postgres-backed job queue for Python"
 readme = "README.md"
 authors = [

{python_pq-0.6.0 → python_pq-0.6.1}/src/pq/__init__.py

@@ -1,13 +1,11 @@
 """PQ - Postgres-backed task queue."""
 
-import pq.logging  # noqa: F401 - configures loguru on import
-
 from pq.client import PQ
 from pq.models import Periodic, Task, TaskStatus
 from pq.priority import Priority
 from pq.worker import PostExecuteHook, PreExecuteHook, TaskTimeoutError
 
-__version__ = "0.6.0"
+__version__ = "0.6.1"
 
 __all__ = [
     "PQ",

{python_pq-0.6.0 → python_pq-0.6.1}/src/pq/logging.py

@@ -8,7 +8,10 @@ from loguru import logger
 def configure_logging() -> None:
     """Configure loguru with a clean, aligned format.
 
-    Called automatically when pq is imported.
+    This is an opt-in helper for applications that want pq's default log
+    format. Call it explicitly during application startup. pq itself never
+    calls this function so it will not interfere with an existing loguru
+    configuration.
     """
     # Remove default handler
     logger.remove()
@@ -21,7 +24,3 @@ def configure_logging() -> None:
         level="DEBUG",
         colorize=True,
     )
-
-
-# Auto-configure on import
-configure_logging()