fetchnode 0.4.0__tar.gz

fetchnode-0.4.0/.gitignore

@@ -0,0 +1,58 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+.venv-win/
+venv/
+env/
+ENV/
+
+# Packaging / build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Test / coverage caches
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# Django / local runtime artifacts
+db.sqlite3
+db.sqlite3-journal
+staticfiles/
+media/
+*.log
+
+# Local environment / secrets
+.env
+.env.*
+!.env.example
+
+# Tooling caches
+node_modules/
+.mypy_cache/
+.ruff_cache/
+.pyre/
+
+# Editor / OS files
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+.agents/
+

fetchnode-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FetchNode (Remco van Wijk)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fetchnode-0.4.0/PKG-INFO

@@ -0,0 +1,166 @@
+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

@@ -0,0 +1,132 @@
+# 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/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fetchnode"
+version = "0.4.0"
+description = "Official Django and Python client SDK for FetchNode monitoring"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Remco van Wijk", email = "remcovanwijk040@users.noreply.github.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+    "Framework :: Django :: 5.1",
+    "Framework :: Django :: 5.2",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: System :: Monitoring",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "django>=4.2",
+]
+
+[project.optional-dependencies]
+celery = [
+    "celery>=5.0",
+]
+
+[project.urls]
+Homepage = "https://fetchnode.com"
+Repository = "https://github.com/remcovanwijk040/fetchnode"
+Issues = "https://github.com/remcovanwijk040/fetchnode/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fetchnode", "src/fetchnode_client"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]

fetchnode-0.4.0/src/fetchnode/__init__.py

@@ -0,0 +1,50 @@
+default_app_config = "fetchnode.apps.FetchNodeConfig"
+
+from fetchnode.version import SDK_VERSION
+
+__version__ = SDK_VERSION
+
+from fetchnode.api import capture_exception, capture_message, track, track_event
+from fetchnode.capture import (
+    capture_context,
+    capture_django_task,
+    capture_exceptions,
+    capture_job,
+    capture_job_context,
+    capture_job_exception,
+    capture_management_command,
+    track_job_execution,
+)
+from fetchnode.excepthook import (
+    install_excepthook_instrumentation,
+    restore_excepthook,
+    uninstall_excepthook_instrumentation,
+)
+from fetchnode.scope import add_breadcrumb, clear_scope, set_context, set_tag, set_user
+from fetchnode.sender import flush, transport_stats
+
+__all__ = [
+    "__version__",
+    "capture_exception",
+    "capture_message",
+    "track",
+    "track_event",
+    "capture_exceptions",
+    "capture_context",
+    "capture_job_exception",
+    "capture_job_context",
+    "capture_job",
+    "capture_django_task",
+    "track_job_execution",
+    "capture_management_command",
+    "install_excepthook_instrumentation",
+    "uninstall_excepthook_instrumentation",
+    "restore_excepthook",
+    "add_breadcrumb",
+    "clear_scope",
+    "set_context",
+    "set_tag",
+    "set_user",
+    "flush",
+    "transport_stats",
+]