fetchnode 0.4.2__tar.gz → 0.4.3__tar.gz

fetchnode-0.4.3/CHANGELOG.md

@@ -0,0 +1,36 @@
+# FetchNode SDK changelog
+
+## 0.4.3 — 2026-09-29
+
+### Fixed
+
+- Use `https://fetch-node.com/api/events/ingest/` as the default ingest endpoint.
+- Let Django automatically discover the SDK AppConfig when `fetchnode` is in
+  `INSTALLED_APPS`, so startup installs logging and enabled instrumentation.
+- Preserve automatic AppConfig discovery for the legacy `fetchnode_client` name.
+- Correct the documentation URLs to the active FetchNode website.
+
+### Documentation
+
+- Configure the private server key through `FETCHNODE_API_KEY` and supply an
+  explicit ingest URL. Keep private keys out of browser code and source control.
+- Show explicit server conversion declarations and non-personal event properties.
+- Verify reception after restarting or redeploying Django.
+
+### Release checks
+
+- Test the installed wheel outside the repository, including Django AppConfig and
+  automatic logging setup.
+- Exercise requests, exceptions, error logs and idempotent conversions against a
+  local FetchNode collector, with project isolation checks.
+- Check distribution metadata and the release tag before uploading to PyPI.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.4.3
+```
+
+Update your dependency file or lockfile, restart or redeploy Django, and verify a
+request and test error in FetchNode. Existing installations can set `API_URL`
+explicitly if they use their own collector.

{fetchnode-0.4.2 → fetchnode-0.4.3}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: fetchnode
-Version: 0.4.2
+Version: 0.4.3
 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: Homepage, https://fetch-node.com
+Project-URL: Documentation, https://fetch-node.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/
+Project-URL: Changelog, https://pypi.org/project/fetchnode/0.4.3/#sdk-changelog
 Author-email: Remco van Wijk <remcovanwijk040@users.noreply.github.com>
 License-Expression: MIT
 License-File: LICENSE
@@ -43,7 +43,7 @@ Description-Content-Type: text/markdown
 [![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.
+Official Python and Django client SDK for [FetchNode](https://fetch-node.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.
 
@@ -70,6 +70,10 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
 
 ## Installation
 
+Version 0.4.3 fixes the default ingest endpoint and Django startup discovery for
+automatic logging. See the [SDK changelog](#sdk-changelog)
+for changes and upgrade instructions.
+
 Install via `pip`:
 
 ```bash
@@ -114,13 +118,18 @@ MIDDLEWARE = [
 ### 3. Configure `settings.FETCHNODE`
 
 ```python
+import os
+
 FETCHNODE = {
-    "API_KEY": "fn_live_your_project_key_here",
+    "API_KEY": os.environ.get("FETCHNODE_API_KEY", ""),
+    "API_URL": "https://fetch-node.com/api/events/ingest/",
     "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.
+Set `FETCHNODE_API_KEY` to your private server key in the deployment environment. Keep it out of source control and browser code. Restart or redeploy Django, then verify a request and test error in FetchNode.
+
+Django will automatically initialize FetchNode upon startup and capture unhandled exceptions, slow queries, and request telemetry.
 
 ---
 
@@ -130,8 +139,8 @@ 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. |
+| `API_KEY` | `FETCHNODE_API_KEY` | `""` | **Required.** Your private server key from project settings. Never use a public browser key here. |
+| `ENDPOINT` / `API_URL` | `FETCHNODE_ENDPOINT` | `https://fetch-node.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. |
@@ -163,8 +172,8 @@ def contact_view(request):
             "lead_submitted",
             request=request,
             idempotency_key=f"lead:{lead.id}",
-            properties={"email": lead.email},
-            conversion=True,
+            properties={"source": "contact_form"},
+            conversion={"display_name": "Lead submitted", "funnel_order": 1, "primary": True},
         )
         return redirect("thank_you")
 ```
@@ -271,9 +280,9 @@ fetchnode.flush()
 
 ## 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/)
+- **Website & Cloud App:** [fetchnode.com](https://fetch-node.com)
+- **Documentation & Setup Guide:** [fetchnode.com/guide/](https://fetch-node.com/guide/)
+- **Changelog:** [fetchnode.com/changelog/](https://fetch-node.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)
 
@@ -282,3 +291,41 @@ fetchnode.flush()
 ## License
 
 MIT License. See [LICENSE](LICENSE) for details.
+
+
+# SDK changelog
+
+## 0.4.3 — 2026-09-29
+
+### Fixed
+
+- Use `https://fetch-node.com/api/events/ingest/` as the default ingest endpoint.
+- Let Django automatically discover the SDK AppConfig when `fetchnode` is in
+  `INSTALLED_APPS`, so startup installs logging and enabled instrumentation.
+- Preserve automatic AppConfig discovery for the legacy `fetchnode_client` name.
+- Correct the documentation URLs to the active FetchNode website.
+
+### Documentation
+
+- Configure the private server key through `FETCHNODE_API_KEY` and supply an
+  explicit ingest URL. Keep private keys out of browser code and source control.
+- Show explicit server conversion declarations and non-personal event properties.
+- Verify reception after restarting or redeploying Django.
+
+### Release checks
+
+- Test the installed wheel outside the repository, including Django AppConfig and
+  automatic logging setup.
+- Exercise requests, exceptions, error logs and idempotent conversions against a
+  local FetchNode collector, with project isolation checks.
+- Check distribution metadata and the release tag before uploading to PyPI.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.4.3
+```
+
+Update your dependency file or lockfile, restart or redeploy Django, and verify a
+request and test error in FetchNode. Existing installations can set `API_URL`
+explicitly if they use their own collector.

{fetchnode-0.4.2 → fetchnode-0.4.3}/README.md

@@ -6,7 +6,7 @@
 [![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.
+Official Python and Django client SDK for [FetchNode](https://fetch-node.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.
 
@@ -33,6 +33,10 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
 
 ## Installation
 
+Version 0.4.3 fixes the default ingest endpoint and Django startup discovery for
+automatic logging. See the [SDK changelog](#sdk-changelog)
+for changes and upgrade instructions.
+
 Install via `pip`:
 
 ```bash
@@ -77,13 +81,18 @@ MIDDLEWARE = [
 ### 3. Configure `settings.FETCHNODE`
 
 ```python
+import os
+
 FETCHNODE = {
-    "API_KEY": "fn_live_your_project_key_here",
+    "API_KEY": os.environ.get("FETCHNODE_API_KEY", ""),
+    "API_URL": "https://fetch-node.com/api/events/ingest/",
     "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.
+Set `FETCHNODE_API_KEY` to your private server key in the deployment environment. Keep it out of source control and browser code. Restart or redeploy Django, then verify a request and test error in FetchNode.
+
+Django will automatically initialize FetchNode upon startup and capture unhandled exceptions, slow queries, and request telemetry.
 
 ---
 
@@ -93,8 +102,8 @@ 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. |
+| `API_KEY` | `FETCHNODE_API_KEY` | `""` | **Required.** Your private server key from project settings. Never use a public browser key here. |
+| `ENDPOINT` / `API_URL` | `FETCHNODE_ENDPOINT` | `https://fetch-node.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. |
@@ -126,8 +135,8 @@ def contact_view(request):
             "lead_submitted",
             request=request,
             idempotency_key=f"lead:{lead.id}",
-            properties={"email": lead.email},
-            conversion=True,
+            properties={"source": "contact_form"},
+            conversion={"display_name": "Lead submitted", "funnel_order": 1, "primary": True},
         )
         return redirect("thank_you")
 ```
@@ -234,9 +243,9 @@ fetchnode.flush()
 
 ## 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/)
+- **Website & Cloud App:** [fetchnode.com](https://fetch-node.com)
+- **Documentation & Setup Guide:** [fetchnode.com/guide/](https://fetch-node.com/guide/)
+- **Changelog:** [fetchnode.com/changelog/](https://fetch-node.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)
 
@@ -245,3 +254,41 @@ fetchnode.flush()
 ## License
 
 MIT License. See [LICENSE](LICENSE) for details.
+
+
+# SDK changelog
+
+## 0.4.3 — 2026-09-29
+
+### Fixed
+
+- Use `https://fetch-node.com/api/events/ingest/` as the default ingest endpoint.
+- Let Django automatically discover the SDK AppConfig when `fetchnode` is in
+  `INSTALLED_APPS`, so startup installs logging and enabled instrumentation.
+- Preserve automatic AppConfig discovery for the legacy `fetchnode_client` name.
+- Correct the documentation URLs to the active FetchNode website.
+
+### Documentation
+
+- Configure the private server key through `FETCHNODE_API_KEY` and supply an
+  explicit ingest URL. Keep private keys out of browser code and source control.
+- Show explicit server conversion declarations and non-personal event properties.
+- Verify reception after restarting or redeploying Django.
+
+### Release checks
+
+- Test the installed wheel outside the repository, including Django AppConfig and
+  automatic logging setup.
+- Exercise requests, exceptions, error logs and idempotent conversions against a
+  local FetchNode collector, with project isolation checks.
+- Check distribution metadata and the release tag before uploading to PyPI.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.4.3
+```
+
+Update your dependency file or lockfile, restart or redeploy Django, and verify a
+request and test error in FetchNode. Existing installations can set `API_URL`
+explicitly if they use their own collector.

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fetchnode"
-version = "0.4.2"
+version = "0.4.3"
 description = "Official Django and Python client SDK for FetchNode monitoring"
 readme = "README.md"
 license = "MIT"
@@ -43,11 +43,11 @@ celery = [
 ]
 
 [project.urls]
-Homepage = "https://fetchnode.com"
-Documentation = "https://fetchnode.com/guide/"
+Homepage = "https://fetch-node.com"
+Documentation = "https://fetch-node.com/guide/"
 Repository = "https://github.com/remcovanwijk040/fetchnode"
 Issues = "https://github.com/remcovanwijk040/fetchnode/issues"
-Changelog = "https://fetchnode.com/changelog/"
+Changelog = "https://pypi.org/project/fetchnode/0.4.3/#sdk-changelog"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/fetchnode", "src/fetchnode_client"]
@@ -56,6 +56,7 @@ packages = ["src/fetchnode", "src/fetchnode_client"]
 include = [
     "/src",
     "/README.md",
+    "/CHANGELOG.md",
     "/LICENSE",
     "/pyproject.toml",
 ]

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

@@ -34,5 +34,9 @@ class FetchNodeConfig(AppConfig):
             install_excepthook_instrumentation()
 
 
-# Backwards compatibility alias
-FetchNodeClientConfig = FetchNodeConfig
+def __getattr__(name):
+    # Keep explicit legacy imports working without exposing a second AppConfig
+    # candidate to Django's automatic application discovery.
+    if name == "FetchNodeClientConfig":
+        return FetchNodeConfig
+    raise AttributeError(name)

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

@@ -4,7 +4,7 @@ from django.conf import settings
 
 DEFAULTS = {
     "ENABLED": False,
-    "API_URL": "https://monitor.fetchnode.com/api/events/ingest/",
+    "API_URL": "https://fetch-node.com/api/events/ingest/",
     "API_KEY": "",
     "ENVIRONMENT": "development",
     "RELEASE": "",

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

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

fetchnode-0.4.3/src/fetchnode_client/apps.py

@@ -0,0 +1,5 @@
+from fetchnode import apps as _primary_apps
+
+
+class FetchNodeClientConfig(_primary_apps.FetchNodeConfig):
+    name = "fetchnode_client"

fetchnode-0.4.2/src/fetchnode_client/apps.py

@@ -1,2 +0,0 @@
-from fetchnode.apps import *
-from fetchnode.apps import FetchNodeClientConfig