watchdiff-core 0.2.2__tar.gz → 0.2.3__tar.gz

{watchdiff_core-0.2.2 → watchdiff_core-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: watchdiff-core
-Version: 0.2.2
+Version: 0.2.3
 Summary: Lightweight web change monitoring library - clean diffs, AI summaries, file/API/SSL/DB monitoring, structured alerts.
 Author: WatchDiff Contributors
 License: BSD-2-Clause
@@ -91,6 +91,7 @@ WatchDiff watches web pages, files, APIs, databases, and SSL certificates - then
 | Confirm change before alerting | `confirm_after=30` (flapping detection) |
 | Monitor a sitemap for URL changes | `.watch_sitemap("https://example.com/sitemap.xml")` |
 | Watch one JSON field only | `json_path="$.data.price"` |
+| Monitor authenticated pages | `cookies={"session": "abc123", "csrftoken": "xyz"}` |
 | Send email on change | `alert=AlertConfig(email=EmailConfig(to="...", smtp=SmtpConfig(...)))` |
 | AI summary of changes | `ai_summary=True, ai_provider=AiProvider(type="gemini", api_key="...")` |
 | Customize the AI prompt | `ai_prompt="Summarize in French."` or `ai_prompt=lambda r: ...` |
@@ -146,6 +147,7 @@ WatchDiff watches web pages, files, APIs, databases, and SSL certificates - then
   - [Flapping detection](#flapping-detection)
   - [Sitemap monitoring](#sitemap-monitoring)
   - [JSON path targeting](#json-path-targeting)
+  - [Cookie-based authentication](#cookie-based-authentication)
   - [Email alerts](#email-alerts)
 - [API reference](#api-reference)
   - [`.watch()`](#watchurl--)
@@ -1395,6 +1397,29 @@ value = extract_json_path('{"data": {"price": 42.5}}', "$.data.price")
 # "42.5"
 ```
 
+## Cookie-based authentication
+
+Pass cookies with every request to monitor pages that require a login session. Cookies are merged into the outgoing `Cookie` header on top of any `headers` you supply.
+
+```python
+wd.watch("https://app.example.com/dashboard",
+         cookies={"session": "your-session-token", "csrftoken": "your-csrf-token"},
+         interval=300,
+         on_change=lambda r: print(r.changes))
+```
+
+Combine `cookies` with `headers` — the cookie string is appended to any existing `Cookie` header:
+
+```python
+wd.watch_api("https://api.example.com/account",
+             headers={"Authorization": "Bearer token123"},
+             cookies={"_ga": "GA1.1.0000000000.0000000000"},
+             json_path="$.balance",
+             interval=60)
+```
+
+> Tip: copy cookie values from your browser's DevTools → Network tab → Request Headers.
+
 ## Email alerts
 
 Send email notifications via SMTP when a change is detected. Uses Python stdlib `smtplib` — no extra dependency required.
@@ -1480,6 +1505,7 @@ Register a URL to monitor. All keyword arguments are optional. Returns `self` (c
 | `on_spike` | `Callable \| None` | `None` | Called with `SpikeInfo` when spike is detected |
 | `alert_on_status_change` | `bool` | `False` | Alert when HTTP status code changes (200→503, etc.) |
 | `on_status_change` | `Callable \| None` | `None` | Called with `StatusChangeInfo` on status code change |
+| `cookies` | `dict[str, str]` | `{}` | Cookies sent with every request — merged into the `Cookie` header (e.g. `{"session": "abc"}`) |
 | `alert` | `AlertConfig \| None` | `None` | Full alert config — use instead of `on_change`/`webhooks` to include email or fine-tune retries |
 | `alert_if` | `Callable[[DiffReport], bool] \| None` | `None` | Custom gate - only alert when this function returns `True` |
 | `expected_status` | `int \| None` | `None` | Fire `on_error` when actual HTTP status differs from this value |

{watchdiff_core-0.2.2 → watchdiff_core-0.2.3}/README.md

@@ -43,6 +43,7 @@ WatchDiff watches web pages, files, APIs, databases, and SSL certificates - then
 | Confirm change before alerting | `confirm_after=30` (flapping detection) |
 | Monitor a sitemap for URL changes | `.watch_sitemap("https://example.com/sitemap.xml")` |
 | Watch one JSON field only | `json_path="$.data.price"` |
+| Monitor authenticated pages | `cookies={"session": "abc123", "csrftoken": "xyz"}` |
 | Send email on change | `alert=AlertConfig(email=EmailConfig(to="...", smtp=SmtpConfig(...)))` |
 | AI summary of changes | `ai_summary=True, ai_provider=AiProvider(type="gemini", api_key="...")` |
 | Customize the AI prompt | `ai_prompt="Summarize in French."` or `ai_prompt=lambda r: ...` |
@@ -98,6 +99,7 @@ WatchDiff watches web pages, files, APIs, databases, and SSL certificates - then
   - [Flapping detection](#flapping-detection)
   - [Sitemap monitoring](#sitemap-monitoring)
   - [JSON path targeting](#json-path-targeting)
+  - [Cookie-based authentication](#cookie-based-authentication)
   - [Email alerts](#email-alerts)
 - [API reference](#api-reference)
   - [`.watch()`](#watchurl--)
@@ -1347,6 +1349,29 @@ value = extract_json_path('{"data": {"price": 42.5}}', "$.data.price")
 # "42.5"
 ```
 
+## Cookie-based authentication
+
+Pass cookies with every request to monitor pages that require a login session. Cookies are merged into the outgoing `Cookie` header on top of any `headers` you supply.
+
+```python
+wd.watch("https://app.example.com/dashboard",
+         cookies={"session": "your-session-token", "csrftoken": "your-csrf-token"},
+         interval=300,
+         on_change=lambda r: print(r.changes))
+```
+
+Combine `cookies` with `headers` — the cookie string is appended to any existing `Cookie` header:
+
+```python
+wd.watch_api("https://api.example.com/account",
+             headers={"Authorization": "Bearer token123"},
+             cookies={"_ga": "GA1.1.0000000000.0000000000"},
+             json_path="$.balance",
+             interval=60)
+```
+
+> Tip: copy cookie values from your browser's DevTools → Network tab → Request Headers.
+
 ## Email alerts
 
 Send email notifications via SMTP when a change is detected. Uses Python stdlib `smtplib` — no extra dependency required.
@@ -1432,6 +1457,7 @@ Register a URL to monitor. All keyword arguments are optional. Returns `self` (c
 | `on_spike` | `Callable \| None` | `None` | Called with `SpikeInfo` when spike is detected |
 | `alert_on_status_change` | `bool` | `False` | Alert when HTTP status code changes (200→503, etc.) |
 | `on_status_change` | `Callable \| None` | `None` | Called with `StatusChangeInfo` on status code change |
+| `cookies` | `dict[str, str]` | `{}` | Cookies sent with every request — merged into the `Cookie` header (e.g. `{"session": "abc"}`) |
 | `alert` | `AlertConfig \| None` | `None` | Full alert config — use instead of `on_change`/`webhooks` to include email or fine-tune retries |
 | `alert_if` | `Callable[[DiffReport], bool] \| None` | `None` | Custom gate - only alert when this function returns `True` |
 | `expected_status` | `int \| None` | `None` | Fire `on_error` when actual HTTP status differs from this value |

{watchdiff_core-0.2.2 → watchdiff_core-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "watchdiff-core"
-version = "0.2.2"
+version = "0.2.3"
 description = "Lightweight web change monitoring library - clean diffs, AI summaries, file/API/SSL/DB monitoring, structured alerts."
 readme = "README.md"
 requires-python = ">=3.9"

{watchdiff_core-0.2.2 → watchdiff_core-0.2.3}/watchdiff/fetcher/fetcher.py

@@ -85,6 +85,10 @@ class Fetcher:
             FetchError: after all retries are exhausted.
         """
         headers = {**_DEFAULT_ACCEPT_HEADERS, "User-Agent": _pick_ua(config), **config.headers}
+        if config.cookies:
+            existing = headers.get("Cookie", "")
+            cookie_str = "; ".join(f"{k}={v}" for k, v in config.cookies.items())
+            headers["Cookie"] = f"{existing}; {cookie_str}" if existing else cookie_str
         proxy   = _pick_proxy(config)
 
         client_kwargs: dict = {"timeout": config.timeout, "follow_redirects": True}
@@ -133,6 +137,10 @@ class AsyncFetcher:
             FetchError: after all retries are exhausted.
         """
         headers = {**_DEFAULT_ACCEPT_HEADERS, "User-Agent": _pick_ua(config), **config.headers}
+        if config.cookies:
+            existing = headers.get("Cookie", "")
+            cookie_str = "; ".join(f"{k}={v}" for k, v in config.cookies.items())
+            headers["Cookie"] = f"{existing}; {cookie_str}" if existing else cookie_str
         proxy   = _pick_proxy(config)
 
         client_kwargs: dict = {"timeout": config.timeout, "follow_redirects": True}

{watchdiff_core-0.2.2 → watchdiff_core-0.2.3}/watchdiff/models.py

@@ -53,6 +53,7 @@ class WatchConfig:
     interval: int                    = 300       # seconds between checks
     label: str | None                = None      # human-readable name for this watch
     headers: dict[str, str]          = field(default_factory=dict)
+    cookies: dict[str, str]          = field(default_factory=dict)
     timeout: int                     = 15        # HTTP timeout in seconds
     ignore_selectors: list[str]      = field(default_factory=list)
     ignore_patterns: list[str]       = field(default_factory=list)