hedron-explorer 0.2.0__tar.gz

hedron_explorer-0.2.0/.gitignore

@@ -0,0 +1,20 @@
+.DS_Store
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+venv/
+.env
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.hypothesis/
+.tox/
+.nox/
+*.html.gz

hedron_explorer-0.2.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to `hedron-explorer` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+with the Hedron coordinated release train (`0.N.0` for phase `0.N`).
+
+## [0.2.0] - 2026-08-03
+
+Initial Explorer preview for the FastAPI MVP.
+
+### Added
+
+- Development-only router for routes, components, previews, HTMX inference, and
+  security findings.
+- Production absence by default with redacted metadata views.
+- Shared registry identity with `hedron` routing and OpenAPI.
+
+[0.2.0]: https://github.com/eddiethedean/hedron/commits/main

hedron_explorer-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Odos Matthews
+
+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.

hedron_explorer-0.2.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: hedron-explorer
+Version: 0.2.0
+Summary: Development Component Explorer preview for Hedron
+Project-URL: Homepage, https://github.com/eddiethedean/hedron
+Project-URL: Repository, https://github.com/eddiethedean/hedron
+Project-URL: Issues, https://github.com/eddiethedean/hedron/issues
+Project-URL: Changelog, https://github.com/eddiethedean/hedron/blob/main/packages/hedron-explorer/CHANGELOG.md
+Project-URL: Documentation, https://github.com/eddiethedean/hedron/tree/main/docs
+Author-email: Odos Matthews <odosmatthews@gmail.com>
+Maintainer-email: Odos Matthews <odosmatthews@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: components,development,explorer,hedron
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Typing :: Typed
+Requires-Python: <3.15,>=3.11
+Requires-Dist: hedron==0.2.0
+Description-Content-Type: text/markdown
+
+# hedron-explorer
+
+Development Component Explorer preview for Hedron (`0.2.0`).
+
+Provides registry-backed inspection of routes, components, HTMX inference, and
+security findings. Installed through `hedron[dev]`; not required in production.
+
+## Install
+
+```bash
+pip install "hedron[dev]"
+# or
+uv add hedron --extra dev
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

hedron_explorer-0.2.0/README.md

@@ -0,0 +1,18 @@
+# hedron-explorer
+
+Development Component Explorer preview for Hedron (`0.2.0`).
+
+Provides registry-backed inspection of routes, components, HTMX inference, and
+security findings. Installed through `hedron[dev]`; not required in production.
+
+## Install
+
+```bash
+pip install "hedron[dev]"
+# or
+uv add hedron --extra dev
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

hedron_explorer-0.2.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "hedron-explorer"
+version = "0.2.0"
+description = "Development Component Explorer preview for Hedron"
+readme = "README.md"
+requires-python = ">=3.11,<3.15"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Odos Matthews", email = "odosmatthews@gmail.com" },
+]
+maintainers = [
+    { name = "Odos Matthews", email = "odosmatthews@gmail.com" },
+]
+keywords = [
+    "components",
+    "development",
+    "explorer",
+    "hedron",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = [
+    "hedron==0.2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/eddiethedean/hedron"
+Repository = "https://github.com/eddiethedean/hedron"
+Issues = "https://github.com/eddiethedean/hedron/issues"
+Changelog = "https://github.com/eddiethedean/hedron/blob/main/packages/hedron-explorer/CHANGELOG.md"
+Documentation = "https://github.com/eddiethedean/hedron/tree/main/docs"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hedron_explorer"]
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+    "src/hedron_explorer",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "pyproject.toml",
+]

hedron_explorer-0.2.0/src/hedron_explorer/__init__.py

@@ -0,0 +1,9 @@
+"""hedron-explorer: development Component Explorer preview."""
+
+from __future__ import annotations
+
+from hedron_explorer.router import explorer_router
+
+__version__ = "0.2.0"
+
+__all__ = ["__version__", "explorer_router"]

hedron_explorer-0.2.0/src/hedron_explorer/router.py

@@ -0,0 +1,93 @@
+"""Explorer preview router (development only)."""
+
+from __future__ import annotations
+
+import html as html_lib
+from typing import Any
+
+from fastapi import APIRouter
+from fastapi.responses import HTMLResponse
+
+from hedron_core.registry import get_registry
+
+__all__ = ["explorer_router"]
+
+
+def explorer_router() -> APIRouter:
+    router = APIRouter(tags=["hedron-explorer"])
+
+    @router.get("/", response_class=HTMLResponse, include_in_schema=False)
+    async def index() -> str:
+        registry = get_registry()
+        routes = list(registry.routes())
+        components = list(registry.components())
+        findings = [
+            "Explorer is development-only by default",
+            "Secrets and absolute paths are redacted from this view",
+            "Internal component resources default to include_in_schema=False",
+            "Unsafe cookie-authenticated actions require CSRF validation",
+        ]
+        route_rows = "".join(
+            f"<tr><td>{html_lib.escape(r.kind)}</td>"
+            f"<td>{html_lib.escape(r.name)}</td>"
+            f"<td><code>{html_lib.escape(r.path)}</code></td>"
+            f"<td>{html_lib.escape(','.join(r.methods))}</td>"
+            f"<td>{html_lib.escape(str(dict(r.htmx_inference)))}</td></tr>"
+            for r in routes
+        )
+        component_rows = "".join(
+            f"<tr><td>{html_lib.escape(c.name)}</td>"
+            f"<td><code>{html_lib.escape(c.logical_id)}</code></td>"
+            f"<td>{html_lib.escape(c.distribution)}</td></tr>"
+            for c in components[:100]
+        )
+        finding_items = "".join(f"<li>{html_lib.escape(item)}</li>" for item in findings)
+        return f"""<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="utf-8"><title>Hedron Explorer</title></head>
+<body>
+  <h1>Hedron Explorer</h1>
+  <p>Registry-backed preview for routes, components, HTMX inference, and security findings.</p>
+  <h2>Routes</h2>
+  <table border="1" cellpadding="6">
+    <thead>
+      <tr><th>Kind</th><th>Name</th><th>Path</th><th>Methods</th><th>HTMX</th></tr>
+    </thead>
+    <tbody>{route_rows or "<tr><td colspan='5'>No routes registered</td></tr>"}</tbody>
+  </table>
+  <h2>Components</h2>
+  <table border="1" cellpadding="6">
+    <thead><tr><th>Name</th><th>Logical ID</th><th>Distribution</th></tr></thead>
+    <tbody>{component_rows or "<tr><td colspan='3'>No components</td></tr>"}</tbody>
+  </table>
+  <h2>Security findings</h2>
+  <ul>{finding_items}</ul>
+</body>
+</html>"""
+
+    @router.get("/api/routes", include_in_schema=False)
+    async def api_routes() -> list[dict[str, Any]]:
+        return [
+            {
+                "kind": r.kind,
+                "name": r.name,
+                "path": r.path,
+                "methods": list(r.methods),
+                "operation_id": r.operation_id,
+                "htmx_inference": dict(r.htmx_inference),
+            }
+            for r in get_registry().routes()
+        ]
+
+    @router.get("/api/security", include_in_schema=False)
+    async def api_security() -> dict[str, Any]:
+        return {
+            "findings": [
+                "Explorer routes absent in production by default",
+                "CSRF required for unsafe cookie-authenticated actions",
+                "Authenticated fragments use private, no-store caching",
+            ],
+            "redacted": True,
+        }
+
+    return router