fetchnode 0.4.0__tar.gz → 0.4.2__tar.gz

fetchnode-0.4.2/PKG-INFO

@@ -0,0 +1,284 @@
+Metadata-Version: 2.5
+Name: fetchnode
+Version: 0.4.2
+Summary: Official Django and Python client SDK for FetchNode monitoring
+Project-URL: Homepage, https://fetchnode.com
+Project-URL: Documentation, https://fetchnode.com/guide/
+Project-URL: Repository, https://github.com/remcovanwijk040/fetchnode
+Project-URL: Issues, https://github.com/remcovanwijk040/fetchnode/issues
+Project-URL: Changelog, https://fetchnode.com/changelog/
+Author-email: Remco van Wijk <remcovanwijk040@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: django>=4.2
+Provides-Extra: celery
+Requires-Dist: celery>=5.0; extra == 'celery'
+Description-Content-Type: text/markdown
+
+# FetchNode Python & Django SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/fetchnode.svg)](https://pypi.org/project/fetchnode/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/fetchnode.svg)](https://pypi.org/project/fetchnode/)
+[![Django Versions](https://img.shields.io/badge/django-4.2%20%7C%205.0%20%7C%205.1%20%7C%205.2-blue.svg)](https://www.djangoproject.com/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Typing: Typed](https://img.shields.io/badge/typing-typed-green.svg)](https://peps.python.org/pep-0561/)
+
+Official Python and Django client SDK for [FetchNode](https://fetchnode.com) — the focused operations workspace for developers and teams managing multiple production Django websites.
+
+FetchNode captures unhandled exceptions, error logs, slow database queries, N+1 query patterns, Celery background tasks, and authoritative business conversions with zero bloat and privacy-safe defaults.
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quickstart (Django)](#quickstart-django)
+- [Configuration Options](#configuration-options)
+- [Telemetry & Usage](#telemetry--usage)
+  - [Conversion & Lead Tracking](#conversion--lead-tracking)
+  - [Automatic Error Monitoring](#automatic-error-monitoring)
+  - [Manual Exception Capture](#manual-exception-capture)
+  - [Celery Job Monitoring](#celery-job-monitoring)
+  - [Logging Handler](#logging-handler)
+- [Privacy & Security Defaults](#privacy--security-defaults)
+- [Testing in Development](#testing-in-development)
+- [Compatibility](#compatibility)
+- [Links & Resources](#links--resources)
+- [License](#license)
+
+---
+
+## Installation
+
+Install via `pip`:
+
+```bash
+pip install fetchnode
+```
+
+Or using `uv`:
+
+```bash
+uv add fetchnode
+```
+
+*(For Celery support, you can optionally install `fetchnode[celery]`)*
+
+---
+
+## Quickstart (Django)
+
+### 1. Add to `INSTALLED_APPS`
+
+In your Django `settings.py`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "fetchnode",
+]
+```
+
+### 2. Add the Middleware
+
+Add `FetchNodeMiddleware` near the top of your `MIDDLEWARE` list for comprehensive request, query, and exception coverage:
+
+```python
+MIDDLEWARE = [
+    "fetchnode.middleware.FetchNodeMiddleware",
+    "django.middleware.security.SecurityMiddleware",
+    # ...
+]
+```
+
+### 3. Configure `settings.FETCHNODE`
+
+```python
+FETCHNODE = {
+    "API_KEY": "fn_live_your_project_key_here",
+    "ENVIRONMENT": "production",  # e.g. "production", "staging"
+}
+```
+
+That's it! Django will automatically initialize FetchNode upon startup and capture unhandled exceptions, slow queries, and request telemetry.
+
+---
+
+## Configuration Options
+
+Configure via `settings.FETCHNODE` or environment variables:
+
+| Setting Key | Environment Variable | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `API_KEY` | `FETCHNODE_API_KEY` | `""` | **Required.** Your FetchNode project key (starts with `fn_live_` or `fn_test_`). |
+| `ENDPOINT` / `API_URL` | `FETCHNODE_ENDPOINT` | `https://monitor.fetchnode.com/api/events/ingest/` | Processing server URL. Point to your self-hosted instance if applicable. |
+| `ENVIRONMENT` | `FETCHNODE_ENVIRONMENT` | `"development"` | Active environment name (`"production"`, `"staging"`). |
+| `RELEASE` | `FETCHNODE_RELEASE` | `""` | Release tag or git commit hash (e.g. `git rev-parse HEAD`). |
+| `ENABLED` | `FETCHNODE_ENABLED` | `True` if API_KEY present | Master toggle for event sending. |
+| `CAPTURE_TRANSACTIONS` | — | `True` | Track request duration and database query counts. |
+| `CAPTURE_BODY` | — | `False` | Privacy safeguard: request bodies are excluded by default. |
+| `CAPTURE_HEADERS` | — | `False` | Privacy safeguard: request headers are excluded by default. |
+| `QUERY_SLOW_THRESHOLD_MS` | — | `100` | Minimum execution time (ms) to flag an ORM query as slow. |
+| `N_PLUS_ONE_THRESHOLD` | — | `5` | Identical SELECT query repetition threshold to flag N+1 issues. |
+| `SENSITIVE_KEYS` | — | *(built-in list)* | Extra field names to scrub from payloads (additive). |
+
+---
+
+## Telemetry & Usage
+
+### Conversion & Lead Tracking
+
+Track authoritative business events server-side (form submissions, payments, lead captures) with automatic session and visitor cookie attribution:
+
+```python
+import fetchnode
+
+def contact_view(request):
+    form = ContactForm(request.POST)
+    if form.is_valid():
+        lead = form.save()
+
+        # Track authoritative conversion
+        fetchnode.track(
+            "lead_submitted",
+            request=request,
+            idempotency_key=f"lead:{lead.id}",
+            properties={"email": lead.email},
+            conversion=True,
+        )
+        return redirect("thank_you")
+```
+
+**Why `idempotency_key` matters:** Providing an `idempotency_key` (such as the database record ID or payment provider ID) ensures that retried requests, webhook replays, or browser reloads do not inflate your conversion metrics. FetchNode securely hashes the key client-side to produce a deterministic event ID.
+
+### Automatic Error Monitoring
+
+Unhandled exceptions in Django views are caught by `FetchNodeMiddleware`, decorated with:
+* The exact failing line of code and stack trace.
+* In-app vs. framework/library frame classification.
+* Database query count and execution time during the failing request.
+* Correlated request ID and trace ID.
+
+### Manual Exception Capture
+
+Capture handled exceptions or background exceptions:
+
+```python
+import fetchnode
+
+try:
+    external_service_call()
+except ThirdPartyAPIError as exc:
+    fetchnode.capture_exception(exc, tags={"provider": "stripe"})
+```
+
+### Celery Job Monitoring
+
+FetchNode automatically instruments Celery when installed. You can also explicitly decorate tasks:
+
+```python
+from fetchnode import capture_job
+
+@capture_job(name="sync_external_inventory")
+def sync_inventory():
+    ...
+```
+
+### Logging Handler
+
+Send standard `logging.ERROR` and `logging.CRITICAL` records to FetchNode:
+
+```python
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "handlers": {
+        "fetchnode": {
+            "level": "ERROR",
+            "class": "fetchnode.handlers.FetchNodeHandler",
+        },
+    },
+    "loggers": {
+        "django": {
+            "handlers": ["fetchnode"],
+            "level": "ERROR",
+            "propagate": True,
+        },
+    },
+}
+```
+
+---
+
+## Privacy & Security Defaults
+
+FetchNode is engineered with a strict **privacy-first architecture**:
+1. **Client-side Scrubbing:** Sensitive keys (`password`, `token`, `secret`, `api_key`, `authorization`, `cookie`, `csrfmiddlewaretoken`) and any compound keys like `user_password` or `client_secret` are scrubbed before payload transmission.
+2. **Safe SQL Normalization:** Raw SQL text is stripped of literals and parameters (`SELECT * FROM user WHERE id = 123` becomes `SELECT * FROM user WHERE id = ?`).
+3. **No Unintentional PII:** Request bodies, query strings, and raw IP addresses are excluded by default.
+4. **Inspectable & Lightweight:** The entire client is open-source Python with zero compiled binaries and zero unnecessary dependencies.
+
+---
+
+## Testing in Development
+
+In your local test suite (e.g. `pytest` or `python manage.py test`), FetchNode can be disabled by omitting the API key or explicitly setting:
+
+```python
+# settings_test.py
+FETCHNODE = {
+    "ENABLED": False,
+}
+```
+
+To test that event transmission works in your staging environment, run:
+
+```python
+import fetchnode
+fetchnode.capture_message("FetchNode verification ping", level="info")
+fetchnode.flush()
+```
+
+---
+
+## Compatibility
+
+- **Python:** 3.10, 3.11, 3.12, 3.13, 3.14
+- **Django:** 4.2 LTS, 5.0, 5.1, 5.2
+- **Operating Systems:** Linux, macOS, Windows
+
+---
+
+## Links & Resources
+
+- **Website & Cloud App:** [fetchnode.com](https://fetchnode.com)
+- **Documentation & Setup Guide:** [fetchnode.com/guide/](https://fetchnode.com/guide/)
+- **Changelog:** [fetchnode.com/changelog/](https://fetchnode.com/changelog/)
+- **GitHub Repository:** [github.com/remcovanwijk040/fetchnode](https://github.com/remcovanwijk040/fetchnode)
+- **Issue Tracker:** [github.com/remcovanwijk040/fetchnode/issues](https://github.com/remcovanwijk040/fetchnode/issues)
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

fetchnode-0.4.2/README.md

@@ -0,0 +1,247 @@
+# FetchNode Python & Django SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/fetchnode.svg)](https://pypi.org/project/fetchnode/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/fetchnode.svg)](https://pypi.org/project/fetchnode/)
+[![Django Versions](https://img.shields.io/badge/django-4.2%20%7C%205.0%20%7C%205.1%20%7C%205.2-blue.svg)](https://www.djangoproject.com/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Typing: Typed](https://img.shields.io/badge/typing-typed-green.svg)](https://peps.python.org/pep-0561/)
+
+Official Python and Django client SDK for [FetchNode](https://fetchnode.com) — the focused operations workspace for developers and teams managing multiple production Django websites.
+
+FetchNode captures unhandled exceptions, error logs, slow database queries, N+1 query patterns, Celery background tasks, and authoritative business conversions with zero bloat and privacy-safe defaults.
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quickstart (Django)](#quickstart-django)
+- [Configuration Options](#configuration-options)
+- [Telemetry & Usage](#telemetry--usage)
+  - [Conversion & Lead Tracking](#conversion--lead-tracking)
+  - [Automatic Error Monitoring](#automatic-error-monitoring)
+  - [Manual Exception Capture](#manual-exception-capture)
+  - [Celery Job Monitoring](#celery-job-monitoring)
+  - [Logging Handler](#logging-handler)
+- [Privacy & Security Defaults](#privacy--security-defaults)
+- [Testing in Development](#testing-in-development)
+- [Compatibility](#compatibility)
+- [Links & Resources](#links--resources)
+- [License](#license)
+
+---
+
+## Installation
+
+Install via `pip`:
+
+```bash
+pip install fetchnode
+```
+
+Or using `uv`:
+
+```bash
+uv add fetchnode
+```
+
+*(For Celery support, you can optionally install `fetchnode[celery]`)*
+
+---
+
+## Quickstart (Django)
+
+### 1. Add to `INSTALLED_APPS`
+
+In your Django `settings.py`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "fetchnode",
+]
+```
+
+### 2. Add the Middleware
+
+Add `FetchNodeMiddleware` near the top of your `MIDDLEWARE` list for comprehensive request, query, and exception coverage:
+
+```python
+MIDDLEWARE = [
+    "fetchnode.middleware.FetchNodeMiddleware",
+    "django.middleware.security.SecurityMiddleware",
+    # ...
+]
+```
+
+### 3. Configure `settings.FETCHNODE`
+
+```python
+FETCHNODE = {
+    "API_KEY": "fn_live_your_project_key_here",
+    "ENVIRONMENT": "production",  # e.g. "production", "staging"
+}
+```
+
+That's it! Django will automatically initialize FetchNode upon startup and capture unhandled exceptions, slow queries, and request telemetry.
+
+---
+
+## Configuration Options
+
+Configure via `settings.FETCHNODE` or environment variables:
+
+| Setting Key | Environment Variable | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `API_KEY` | `FETCHNODE_API_KEY` | `""` | **Required.** Your FetchNode project key (starts with `fn_live_` or `fn_test_`). |
+| `ENDPOINT` / `API_URL` | `FETCHNODE_ENDPOINT` | `https://monitor.fetchnode.com/api/events/ingest/` | Processing server URL. Point to your self-hosted instance if applicable. |
+| `ENVIRONMENT` | `FETCHNODE_ENVIRONMENT` | `"development"` | Active environment name (`"production"`, `"staging"`). |
+| `RELEASE` | `FETCHNODE_RELEASE` | `""` | Release tag or git commit hash (e.g. `git rev-parse HEAD`). |
+| `ENABLED` | `FETCHNODE_ENABLED` | `True` if API_KEY present | Master toggle for event sending. |
+| `CAPTURE_TRANSACTIONS` | — | `True` | Track request duration and database query counts. |
+| `CAPTURE_BODY` | — | `False` | Privacy safeguard: request bodies are excluded by default. |
+| `CAPTURE_HEADERS` | — | `False` | Privacy safeguard: request headers are excluded by default. |
+| `QUERY_SLOW_THRESHOLD_MS` | — | `100` | Minimum execution time (ms) to flag an ORM query as slow. |
+| `N_PLUS_ONE_THRESHOLD` | — | `5` | Identical SELECT query repetition threshold to flag N+1 issues. |
+| `SENSITIVE_KEYS` | — | *(built-in list)* | Extra field names to scrub from payloads (additive). |
+
+---
+
+## Telemetry & Usage
+
+### Conversion & Lead Tracking
+
+Track authoritative business events server-side (form submissions, payments, lead captures) with automatic session and visitor cookie attribution:
+
+```python
+import fetchnode
+
+def contact_view(request):
+    form = ContactForm(request.POST)
+    if form.is_valid():
+        lead = form.save()
+
+        # Track authoritative conversion
+        fetchnode.track(
+            "lead_submitted",
+            request=request,
+            idempotency_key=f"lead:{lead.id}",
+            properties={"email": lead.email},
+            conversion=True,
+        )
+        return redirect("thank_you")
+```
+
+**Why `idempotency_key` matters:** Providing an `idempotency_key` (such as the database record ID or payment provider ID) ensures that retried requests, webhook replays, or browser reloads do not inflate your conversion metrics. FetchNode securely hashes the key client-side to produce a deterministic event ID.
+
+### Automatic Error Monitoring
+
+Unhandled exceptions in Django views are caught by `FetchNodeMiddleware`, decorated with:
+* The exact failing line of code and stack trace.
+* In-app vs. framework/library frame classification.
+* Database query count and execution time during the failing request.
+* Correlated request ID and trace ID.
+
+### Manual Exception Capture
+
+Capture handled exceptions or background exceptions:
+
+```python
+import fetchnode
+
+try:
+    external_service_call()
+except ThirdPartyAPIError as exc:
+    fetchnode.capture_exception(exc, tags={"provider": "stripe"})
+```
+
+### Celery Job Monitoring
+
+FetchNode automatically instruments Celery when installed. You can also explicitly decorate tasks:
+
+```python
+from fetchnode import capture_job
+
+@capture_job(name="sync_external_inventory")
+def sync_inventory():
+    ...
+```
+
+### Logging Handler
+
+Send standard `logging.ERROR` and `logging.CRITICAL` records to FetchNode:
+
+```python
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "handlers": {
+        "fetchnode": {
+            "level": "ERROR",
+            "class": "fetchnode.handlers.FetchNodeHandler",
+        },
+    },
+    "loggers": {
+        "django": {
+            "handlers": ["fetchnode"],
+            "level": "ERROR",
+            "propagate": True,
+        },
+    },
+}
+```
+
+---
+
+## Privacy & Security Defaults
+
+FetchNode is engineered with a strict **privacy-first architecture**:
+1. **Client-side Scrubbing:** Sensitive keys (`password`, `token`, `secret`, `api_key`, `authorization`, `cookie`, `csrfmiddlewaretoken`) and any compound keys like `user_password` or `client_secret` are scrubbed before payload transmission.
+2. **Safe SQL Normalization:** Raw SQL text is stripped of literals and parameters (`SELECT * FROM user WHERE id = 123` becomes `SELECT * FROM user WHERE id = ?`).
+3. **No Unintentional PII:** Request bodies, query strings, and raw IP addresses are excluded by default.
+4. **Inspectable & Lightweight:** The entire client is open-source Python with zero compiled binaries and zero unnecessary dependencies.
+
+---
+
+## Testing in Development
+
+In your local test suite (e.g. `pytest` or `python manage.py test`), FetchNode can be disabled by omitting the API key or explicitly setting:
+
+```python
+# settings_test.py
+FETCHNODE = {
+    "ENABLED": False,
+}
+```
+
+To test that event transmission works in your staging environment, run:
+
+```python
+import fetchnode
+fetchnode.capture_message("FetchNode verification ping", level="info")
+fetchnode.flush()
+```
+
+---
+
+## Compatibility
+
+- **Python:** 3.10, 3.11, 3.12, 3.13, 3.14
+- **Django:** 4.2 LTS, 5.0, 5.1, 5.2
+- **Operating Systems:** Linux, macOS, Windows
+
+---
+
+## Links & Resources
+
+- **Website & Cloud App:** [fetchnode.com](https://fetchnode.com)
+- **Documentation & Setup Guide:** [fetchnode.com/guide/](https://fetchnode.com/guide/)
+- **Changelog:** [fetchnode.com/changelog/](https://fetchnode.com/changelog/)
+- **GitHub Repository:** [github.com/remcovanwijk040/fetchnode](https://github.com/remcovanwijk040/fetchnode)
+- **Issue Tracker:** [github.com/remcovanwijk040/fetchnode/issues](https://github.com/remcovanwijk040/fetchnode/issues)
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

{fetchnode-0.4.0 → fetchnode-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fetchnode"
-version = "0.4.0"
+version = "0.4.2"
 description = "Official Django and Python client SDK for FetchNode monitoring"
 readme = "README.md"
 license = "MIT"
@@ -31,6 +31,7 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
     "Topic :: System :: Monitoring",
     "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
 ]
 dependencies = [
     "django>=4.2",
@@ -43,8 +44,10 @@ celery = [
 
 [project.urls]
 Homepage = "https://fetchnode.com"
+Documentation = "https://fetchnode.com/guide/"
 Repository = "https://github.com/remcovanwijk040/fetchnode"
 Issues = "https://github.com/remcovanwijk040/fetchnode/issues"
+Changelog = "https://fetchnode.com/changelog/"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/fetchnode", "src/fetchnode_client"]

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/apps.py

@@ -13,8 +13,10 @@ class FetchNodeConfig(AppConfig):
         # Ensure settings.fetchnode_track is available if needed by legacy code
         try:
             from django.conf import settings
-            setattr(settings, "fetchnode_track", track_event)
-            setattr(settings, "FETCHNODE_TRACK", track_event)
+            if not hasattr(settings, "fetchnode_track"):
+                setattr(settings, "fetchnode_track", track_event)
+            if not hasattr(settings, "FETCHNODE_TRACK"):
+                setattr(settings, "FETCHNODE_TRACK", track_event)
         except Exception:
             pass
 

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/conf.py

@@ -22,6 +22,7 @@ DEFAULTS = {
     "KEEP_TRANSACTION_OUTLIER_MS": 1000,
     "CAPTURE_TRANSACTIONS": True,
     "CAPTURE_JOBS": True,
+    "CAPTURE_404": True,
     "INSTRUMENT_CELERY": True,
     "INSTRUMENT_LOGGING": True,
     "INSTRUMENT_EXCEPTHOOK": True,
@@ -118,7 +119,9 @@ def get_client_settings() -> dict:
     elif "FETCHNODE_ENABLED" in os.environ:
         merged["ENABLED"] = os.environ["FETCHNODE_ENABLED"].lower() in {"1", "true", "yes"}
     else:
-        merged["ENABLED"] = bool(merged["API_KEY"])
+        import sys
+        is_testing = any(arg == "test" or "pytest" in arg for arg in sys.argv)
+        merged["ENABLED"] = bool(merged["API_KEY"]) and not is_testing
 
     # Security filters are additive: a project can protect extra business
     # fields without accidentally unprotecting cookies or authorization data.

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/handlers.py

@@ -26,6 +26,8 @@ class FetchNodeHandler(logging.Handler):
             record.levelno < logging.ERROR
             or record.name == "fetchnode"
             or record.name.startswith("fetchnode.")
+            or record.name == "fetchnode_client"
+            or record.name.startswith("fetchnode_client.")
             or getattr(record, _CAPTURED_RECORD_ATTRIBUTE, False)
         ):
             return

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/middleware.py

@@ -41,8 +41,10 @@ class ErrorCaptureMiddleware:
         try:
             from django.conf import settings
             from fetchnode.api import track_event
-            setattr(settings, "fetchnode_track", track_event)
-            setattr(settings, "FETCHNODE_TRACK", track_event)
+            if not hasattr(settings, "fetchnode_track"):
+                setattr(settings, "fetchnode_track", track_event)
+            if not hasattr(settings, "FETCHNODE_TRACK"):
+                setattr(settings, "FETCHNODE_TRACK", track_event)
         except Exception:
             pass
 
@@ -120,6 +122,8 @@ class ErrorCaptureMiddleware:
             request.path.startswith(prefix) for prefix in config["IGNORE_PATH_PREFIXES"]
         ):
             return
+        if not config.get("CAPTURE_404", True) and status_code == 404:
+            return
         resolver_match = getattr(request, "resolver_match", None)
         auth_user = getattr(request, "user", None)
         user_identifier = ""

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/query.py

@@ -39,7 +39,7 @@ def application_stack_location() -> str:
     """Return the nearest application callsite without local variables or values."""
     for frame in reversed(traceback.extract_stack(limit=30)[:-1]):
         filename = frame.filename.replace("\\", "/")
-        if any(marker in filename for marker in ("/django/", "/site-packages/", "/fetchnode/")):
+        if any(marker in filename for marker in ("/django/", "/site-packages/", "/fetchnode/", "/fetchnode_client/")):
             continue
         return f"{frame.filename}:{frame.lineno} in {frame.name}"[:1024]
     return ""

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/scrub.py

@@ -8,7 +8,13 @@ MAX_VALUE_LENGTH = 4000
 
 def is_sensitive_key(key: str, sensitive_keys: list[str]) -> bool:
     normalized = (key or "").replace("-", "_").lower()
-    return normalized in {(item or "").replace("-", "_").lower() for item in sensitive_keys}
+    norm_set = {(item or "").replace("-", "_").lower() for item in (sensitive_keys or []) if item}
+    if normalized in norm_set:
+        return True
+    for item in norm_set:
+        if normalized.startswith(f"{item}_") or normalized.endswith(f"_{item}") or f"_{item}_" in normalized:
+            return True
+    return False
 
 
 def scrub_value(value, *, key: str = "", sensitive_keys: list[str] | None = None, depth: int = 0):

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/sender.py

@@ -63,6 +63,7 @@ def _deliver(payload: dict, config: dict) -> bool:
     headers = {
         "Content-Type": "application/json",
         "Authorization": f"Bearer {config['API_KEY']}",
+        "User-Agent": f"fetchnode-python/{SDK_VERSION}",
     }
     if config.get("COMPRESS_PAYLOADS", True) and len(data) >= int(config.get("COMPRESSION_THRESHOLD_BYTES", 1024)):
         data = gzip.compress(data, compresslevel=5)

{fetchnode-0.4.0 → fetchnode-0.4.2}/src/fetchnode/version.py

@@ -1,3 +1,3 @@
 """FetchNode Python SDK version shared by package metadata and telemetry."""
 
-SDK_VERSION = "0.4.0"
+SDK_VERSION = "0.4.2"

fetchnode-0.4.0/PKG-INFO

@@ -1,166 +0,0 @@
-Metadata-Version: 2.5
-Name: fetchnode
-Version: 0.4.0
-Summary: Official Django and Python client SDK for FetchNode monitoring
-Project-URL: Homepage, https://fetchnode.com
-Project-URL: Repository, https://github.com/remcovanwijk040/fetchnode
-Project-URL: Issues, https://github.com/remcovanwijk040/fetchnode/issues
-Author-email: Remco van Wijk <remcovanwijk040@users.noreply.github.com>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Framework :: Django
-Classifier: Framework :: Django :: 4.2
-Classifier: Framework :: Django :: 5.0
-Classifier: Framework :: Django :: 5.1
-Classifier: Framework :: Django :: 5.2
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Monitoring
-Requires-Python: >=3.10
-Requires-Dist: django>=4.2
-Provides-Extra: celery
-Requires-Dist: celery>=5.0; extra == 'celery'
-Description-Content-Type: text/markdown
-
-# FetchNode Python & Django SDK
-
-[![PyPI](https://img.shields.io/pypi/v/fetchnode.svg)](https://pypi.org/project/fetchnode/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/fetchnode.svg)](https://pypi.org/project/fetchnode/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-Official Python and Django client SDK for [FetchNode](https://fetchnode.com), the focused operations and monitoring workspace for Django teams and portfolio operators.
-
-FetchNode captures unhandled exceptions, error logs, slow database queries, Celery background tasks, and business conversions with zero configuration bloat and privacy-safe defaults.
-
----
-
-## Installation
-
-Install the package using `pip` or `uv`:
-
-```bash
-pip install fetchnode
-```
-
-*(Or `uv add fetchnode`)*
-
----
-
-## Quickstart (Django)
-
-### 1. Add to `INSTALLED_APPS`
-
-In your Django `settings.py`:
-
-```python
-INSTALLED_APPS = [
-    # ...
-    "fetchnode",
-]
-```
-
-### 2. Add the Middleware
-
-Add `FetchNodeMiddleware` near the top of your `MIDDLEWARE` list:
-
-```python
-MIDDLEWARE = [
-    "fetchnode.middleware.FetchNodeMiddleware",
-    "django.middleware.security.SecurityMiddleware",
-    # ...
-]
-```
-
-### 3. Configure `settings.FETCHNODE`
-
-```python
-FETCHNODE = {
-    "API_KEY": "fn_live_your_project_key_here",
-    "ENVIRONMENT": "production",  # e.g. "production", "staging"
-    
-    # Optional: override endpoint for self-hosted FetchNode instances
-    # Defaults to FetchNode Cloud: "https://monitor.fetchnode.com"
-    # "ENDPOINT": "https://monitor.fetchnode.com",
-}
-```
-
-You can also configure via environment variables:
-* `FETCHNODE_API_KEY`
-* `FETCHNODE_ENVIRONMENT`
-* `FETCHNODE_RELEASE`
-* `FETCHNODE_ENDPOINT`
-
----
-
-## Usage
-
-### Milestone & Conversion Tracking
-
-Track business events (form submits, leads, signups, payments) server-side with automatic visitor attribution:
-
-```python
-import fetchnode
-
-def contact_view(request):
-    form = ContactForm(request.POST)
-    if form.is_valid():
-        lead = form.save()
-        
-        # Track authoritative conversion
-        fetchnode.track(
-            "lead_submitted",
-            request=request,
-            idempotency_key=str(lead.id),
-            properties={"email": lead.email},
-            conversion=True,
-        )
-        return redirect("thank_you")
-```
-
-### Manual Exception Capture
-
-```python
-import fetchnode
-
-try:
-    risky_operation()
-except Exception as exc:
-    fetchnode.capture_exception(exc)
-```
-
-### Celery Task Monitoring
-
-FetchNode automatically instruments Celery when installed. To manually monitor tasks or commands:
-
-```python
-from fetchnode import capture_job
-
-@capture_job(name="sync_external_inventory")
-def sync_inventory():
-    ...
-```
-
----
-
-## Privacy by Default
-
-FetchNode is engineered with privacy-safe defaults:
-* Sensitive keys (`password`, `token`, `secret`, `api_key`, `authorization`, `cookie`, `csrfmiddlewaretoken`) are scrubbed before payload transmission.
-* Request bodies and raw IP addresses are excluded by default.
-* Query string parameters and raw SQL values are normalized.
-
----
-
-## License
-
-MIT License. See [LICENSE](LICENSE) for details.

fetchnode-0.4.0/README.md

@@ -1,132 +0,0 @@
-# FetchNode Python & Django SDK
-
-[![PyPI](https://img.shields.io/pypi/v/fetchnode.svg)](https://pypi.org/project/fetchnode/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/fetchnode.svg)](https://pypi.org/project/fetchnode/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-Official Python and Django client SDK for [FetchNode](https://fetchnode.com), the focused operations and monitoring workspace for Django teams and portfolio operators.
-
-FetchNode captures unhandled exceptions, error logs, slow database queries, Celery background tasks, and business conversions with zero configuration bloat and privacy-safe defaults.
-
----
-
-## Installation
-
-Install the package using `pip` or `uv`:
-
-```bash
-pip install fetchnode
-```
-
-*(Or `uv add fetchnode`)*
-
----
-
-## Quickstart (Django)
-
-### 1. Add to `INSTALLED_APPS`
-
-In your Django `settings.py`:
-
-```python
-INSTALLED_APPS = [
-    # ...
-    "fetchnode",
-]
-```
-
-### 2. Add the Middleware
-
-Add `FetchNodeMiddleware` near the top of your `MIDDLEWARE` list:
-
-```python
-MIDDLEWARE = [
-    "fetchnode.middleware.FetchNodeMiddleware",
-    "django.middleware.security.SecurityMiddleware",
-    # ...
-]
-```
-
-### 3. Configure `settings.FETCHNODE`
-
-```python
-FETCHNODE = {
-    "API_KEY": "fn_live_your_project_key_here",
-    "ENVIRONMENT": "production",  # e.g. "production", "staging"
-    
-    # Optional: override endpoint for self-hosted FetchNode instances
-    # Defaults to FetchNode Cloud: "https://monitor.fetchnode.com"
-    # "ENDPOINT": "https://monitor.fetchnode.com",
-}
-```
-
-You can also configure via environment variables:
-* `FETCHNODE_API_KEY`
-* `FETCHNODE_ENVIRONMENT`
-* `FETCHNODE_RELEASE`
-* `FETCHNODE_ENDPOINT`
-
----
-
-## Usage
-
-### Milestone & Conversion Tracking
-
-Track business events (form submits, leads, signups, payments) server-side with automatic visitor attribution:
-
-```python
-import fetchnode
-
-def contact_view(request):
-    form = ContactForm(request.POST)
-    if form.is_valid():
-        lead = form.save()
-        
-        # Track authoritative conversion
-        fetchnode.track(
-            "lead_submitted",
-            request=request,
-            idempotency_key=str(lead.id),
-            properties={"email": lead.email},
-            conversion=True,
-        )
-        return redirect("thank_you")
-```
-
-### Manual Exception Capture
-
-```python
-import fetchnode
-
-try:
-    risky_operation()
-except Exception as exc:
-    fetchnode.capture_exception(exc)
-```
-
-### Celery Task Monitoring
-
-FetchNode automatically instruments Celery when installed. To manually monitor tasks or commands:
-
-```python
-from fetchnode import capture_job
-
-@capture_job(name="sync_external_inventory")
-def sync_inventory():
-    ...
-```
-
----
-
-## Privacy by Default
-
-FetchNode is engineered with privacy-safe defaults:
-* Sensitive keys (`password`, `token`, `secret`, `api_key`, `authorization`, `cookie`, `csrfmiddlewaretoken`) are scrubbed before payload transmission.
-* Request bodies and raw IP addresses are excluded by default.
-* Query string parameters and raw SQL values are normalized.
-
----
-
-## License
-
-MIT License. See [LICENSE](LICENSE) for details.