chore: bump to 1.1.0 (logging-discipline audit)

Signed-off-by: disqualifier <dev@disqualifier.me>

README.md

@@ -13,16 +13,16 @@ send to the core — inheriting rotation, proxy, retry, and result for free.
 ## Install
 
 ```
-aiowebhooks @ git+ssh://git@git.rethinkstudios.io/rethink-public/aiowebhooks.git@v0.1.8
+aiowebhooks @ git+ssh://git@git.rethinkstudios.io/rethink-public/aiowebhooks.git@v1.0.2
 # discord embeds / identity helpers need the extra:
-aiowebhooks[discord] @ git+ssh://git@git.rethinkstudios.io/rethink-public/aiowebhooks.git@v0.1.8
+aiowebhooks[discord] @ git+ssh://git@git.rethinkstudios.io/rethink-public/aiowebhooks.git@v1.0.2
 ```
 
 The base pulls `aiohttp` and `commons` (for the retry/backoff engine). Only
 `aiowebhooks[discord]` adds `discord.py` (>=2.3, mainline, not discord.py-self), and
 only for `DiscordWebhook`.
 
-Drop the `@v0.1.8` suffix from the line above to install the latest unpinned.
+Drop the `@v1.0.2` suffix from the line above to install the latest unpinned.
 
 ## Core sender
 

pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "aiowebhooks"
-version = "0.1.8"
+version = "1.1.0"
 description = "async webhook sender (aiohttp) with round-robin urls, retry, and proxy rotation; optional discord.py embeds"
 requires-python = ">=3.10"
 dependencies = [
     "aiohttp>=3.9",
-    "commons @ git+ssh://git@git.rethinkstudios.io/rethink-public/commons.git@v0.2.1",
+    "commons @ git+https://git.rethinkstudios.io/rethink-public/commons.git@v1.0.0",
 ]
 
 [project.optional-dependencies]

src/aiowebhooks/sender.py

@@ -141,8 +141,10 @@ class Webhook:
         except _Retryable as exhausted:
             return exhausted.result
         except Exception as error:
-            # never-raises net: anything else (closed session, bad proxy url, ...) -> failed result
+            # never-raises net: anything else (closed session, bad proxy url, ...) -> failed result.
-            log.warning("webhook send failed unexpectedly on %s: %s", url, error, exc_info=True)
+            # ERROR: an UNEXPECTED failure is swallowed here into a failed result (op failed, result
+            # lost, a human may need to act) - the lib is the last code that sees this exception.
+            log.error("webhook send failed unexpectedly on %s: %s", url, error, exc_info=True)
             return WebhookResult(
                 ok=False, status=None, url=url, attempts=counter[0] or 1,
                 error=f"{type(error).__name__}: {error}",
@@ -165,7 +167,8 @@ class Webhook:
             if pending_wait[0] is not None:
                 wait = pending_wait[0]
                 pending_wait[0] = None
-                log.warning("webhook 429 on %s; honoring retry_after %.3fs", url, wait)
+                log.warning("webhook 429 on %s; honoring retry_after %.3fs (attempt %d/%d)",
+                            url, wait, counter[0] + 1, self.max_retries + 1)
                 await asyncio.sleep(wait)
             counter[0] += 1
             attempts = counter[0]
@@ -174,9 +177,11 @@ class Webhook:
                 try:
                     proxy_dict = self._proxies.get()
                 except Exception:
-                    # duck-typed provider: any get() error means no proxy available
+                    # duck-typed provider: any get() error means no proxy available.
-                    log.warning("webhook: proxy get() failed; no proxy available",
+                    # ERROR: swallowed into a failed result (op failed, result lost) - the
-                                exc_info=True)
+                    # provider fault vanishes here unless it is logged loudly.
+                    log.error("webhook: proxy get() failed; no proxy available",
+                              exc_info=True)
                     return WebhookResult(
                         ok=False, status=None, url=url, attempts=attempts,
                         error="proxies unavailable", proxy=last_proxy,
@@ -209,7 +214,8 @@ class Webhook:
                         if wait is not None:
                             pending_wait[0] = wait
                         else:
-                            log.warning("webhook 429 on %s; no retry_after, backing off", url)
+                            log.warning("webhook 429 on %s; no retry_after, backing off (attempt %d/%d)",
+                                        url, attempts, self.max_retries + 1)
                         raise _Retryable(result)
                     if status >= 500:
                         raise _Retryable(result)
@@ -241,7 +247,9 @@ class Webhook:
             self._proxies.burn(proxy)
             return True
         except Exception:
-            log.warning("webhook: proxy burn failed; ending rotation", exc_info=True)
+            # ERROR: an unexpected provider fault (burn() raising) is swallowed here and ends
+            # rotation, failing the send - it must be loud, not a quiet WARNING.
+            log.error("webhook: proxy burn failed; ending rotation", exc_info=True)
             return False
 
     @staticmethod