edron 0.1.0__tar.gz

edron-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+.DS_Store
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+/build/
+# Artifact/output build trees only — never ignore package source such as
+# packages/hedron/src/hedron/build (Hatchling respects gitignore and would
+# omit it from sdists/wheels; see #32).
+**/.hedron/build/
+packages/hedron-runtime-java/build/
+target/
+.venv*/
+.bounds-venv*
+venv*/
+.env
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.hypothesis/
+.tox/
+.nox/
+.audit-build-proj/
+examples/reference-app/.hedron/
+*.html.gz
+/site/
+*.so
+*.dylib
+*.pyd
+.devcontainer/
+# Local SQLite demos (e.g. examples/notes-sqlalchemy)
+*.db

edron-0.1.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [0.1.0] — 2026-08-26
+
+### Added
+
+- Initial Edron class-oriented authoring facade over Hedron.
+
+### Fixed
+
+- Lowered fragment/action dependencies into their native route registrations.
+- Preserved explicitly bound action arguments in generated controls and forms.

edron-0.1.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.

edron-0.1.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.5
+Name: edron
+Version: 0.1.0
+Summary: Pythonic class-oriented authoring facade 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
+Author-email: Odos Matthews <odosmatthews@gmail.com>
+Maintainer-email: Odos Matthews <odosmatthews@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dashboard,fastapi,htmx,python,server-rendered
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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-charts<0.3,>=0.2.2
+Requires-Dist: hedron-data<0.67,>=0.66.0
+Requires-Dist: hedron-maps<0.2,>=0.1.2
+Requires-Dist: hedron<0.67,>=0.66.0
+Requires-Dist: markdown>=3.5
+Requires-Dist: nh3>=0.2
+Requires-Dist: uvicorn>=0.52.1
+Provides-Extra: altair
+Requires-Dist: altair<7,>=6; extra == 'altair'
+Requires-Dist: vl-convert-python>=1.0; extra == 'altair'
+Provides-Extra: matplotlib
+Requires-Dist: matplotlib<4,>=3.8; extra == 'matplotlib'
+Provides-Extra: pandas
+Requires-Dist: narwhals>=1.0; extra == 'pandas'
+Requires-Dist: pandas>=2.0; extra == 'pandas'
+Provides-Extra: plotly
+Requires-Dist: plotly<7,>=5.18; extra == 'plotly'
+Provides-Extra: polars
+Requires-Dist: narwhals>=1.0; extra == 'polars'
+Requires-Dist: polars>=1.0; extra == 'polars'
+Provides-Extra: pyarrow
+Requires-Dist: narwhals>=1.0; extra == 'pyarrow'
+Requires-Dist: pyarrow>=15.0; extra == 'pyarrow'
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy<3,>=2; extra == 'sqlalchemy'
+Description-Content-Type: text/markdown
+
+# Edron
+
+Edron is a class-oriented Python authoring facade over Hedron. It keeps Hedron as the renderer,
+router, interaction, state, styling, and security authority.
+
+```python
+import edron as ed
+
+app = ed.App(title="Hello")
+
+
+@app.page("/", title="Hello")
+class Home(ed.Page):
+    def render(self) -> None:
+        self.heading("Hello, Edron")
+        self.text("A small Python vocabulary over native Hedron.")
+```
+
+Edron 0.1 is a Beta implementation line. Native Hedron objects remain available through
+`app.hedron` and `Page.include()`.

edron-0.1.0/README.md

@@ -0,0 +1,20 @@
+# Edron
+
+Edron is a class-oriented Python authoring facade over Hedron. It keeps Hedron as the renderer,
+router, interaction, state, styling, and security authority.
+
+```python
+import edron as ed
+
+app = ed.App(title="Hello")
+
+
+@app.page("/", title="Hello")
+class Home(ed.Page):
+    def render(self) -> None:
+        self.heading("Hello, Edron")
+        self.text("A small Python vocabulary over native Hedron.")
+```
+
+Edron 0.1 is a Beta implementation line. Native Hedron objects remain available through
+`app.hedron` and `Page.include()`.

edron-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[project]
+name = "edron"
+version = "0.1.0"
+description = "Pythonic class-oriented authoring facade 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 = ["fastapi", "htmx", "python", "server-rendered", "dashboard"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: FastAPI",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "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.66.0,<0.67",
+    "hedron-data>=0.66.0,<0.67",
+    "hedron-charts>=0.2.2,<0.3",
+    "hedron-maps>=0.1.2,<0.2",
+    "markdown>=3.5",
+    "nh3>=0.2",
+    "uvicorn>=0.52.1",
+]
+
+[project.optional-dependencies]
+pandas = ["pandas>=2.0", "narwhals>=1.0"]
+polars = ["polars>=1.0", "narwhals>=1.0"]
+pyarrow = ["pyarrow>=15.0", "narwhals>=1.0"]
+plotly = ["plotly>=5.18,<7"]
+altair = ["altair>=6,<7", "vl-convert-python>=1.0"]
+matplotlib = ["matplotlib>=3.8,<4"]
+sqlalchemy = ["sqlalchemy>=2,<3"]
+
+[project.scripts]
+edron = "edron.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/eddiethedean/hedron"
+Repository = "https://github.com/eddiethedean/hedron"
+Issues = "https://github.com/eddiethedean/hedron/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/edron"]
+
+[tool.hatch.build.targets.sdist]
+only-include = ["src/edron", "README.md", "CHANGELOG.md", "LICENSE", "pyproject.toml"]

edron-0.1.0/src/edron/__init__.py

@@ -0,0 +1,62 @@
+"""Edron: a class-oriented authoring facade for Hedron."""
+
+__version__ = "0.1.0"
+
+from edron.app import App
+from edron.cache import CachedFunction, cache_data
+from edron.capabilities import (
+    BrokenCapabilityError,
+    CapabilityError,
+    IncompatibleCapabilityError,
+    MissingCapabilityError,
+)
+from edron.confirm import Confirm
+from edron.dependencies import Dependency, dependency
+from edron.descriptors import Action, BoundAction, BoundFragment, Fragment, action, fragment
+from edron.downloads import Download, download
+from edron.errors import BindingError, EdronError, PhaseError, RegistrationError
+from edron.jobs import JobBackend, JobFlow, JobScope  # pyright: ignore[reportUnknownVariableType]
+from edron.outcomes import Outcome, refresh, success
+from edron.page import Container, FilterScope, Page
+from edron.styling import Color, DesignSystem, StyleContext, StyleRecipe, Theme, ThemeSpec, theme
+
+__all__ = [
+    "Action",
+    "App",
+    "BindingError",
+    "BoundAction",
+    "BoundFragment",
+    "CachedFunction",
+    "CapabilityError",
+    "Color",
+    "Confirm",
+    "Container",
+    "Dependency",
+    "DesignSystem",
+    "Download",
+    "EdronError",
+    "FilterScope",
+    "Fragment",
+    "IncompatibleCapabilityError",
+    "JobBackend",
+    "JobFlow",
+    "JobScope",
+    "MissingCapabilityError",
+    "BrokenCapabilityError",
+    "Outcome",
+    "Page",
+    "PhaseError",
+    "RegistrationError",
+    "StyleContext",
+    "StyleRecipe",
+    "Theme",
+    "ThemeSpec",
+    "action",
+    "cache_data",
+    "dependency",
+    "download",
+    "fragment",
+    "refresh",
+    "success",
+    "theme",
+]

edron-0.1.0/src/edron/_internal.py

@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+from collections.abc import Iterator
+from contextlib import contextmanager
+from contextvars import ContextVar
+from dataclasses import dataclass, field
+from typing import Any
+
+from edron.errors import PhaseError
+
+
+@dataclass
+class Buffer:
+    entries: list[Any] = field(default_factory=list)
+    closed: bool = False
+
+    def append(self, value: Any) -> None:
+        if self.closed:
+            raise PhaseError(
+                "output was emitted after the request phase closed", code="EDRON_LATE_OUTPUT"
+            )
+        self.entries.append(value)
+
+
+@dataclass
+class Frame:
+    app: Any
+    page: Any
+    phase: str
+    request: Any = None
+    buffer: Buffer = field(default_factory=Buffer)
+    parent: Frame | None = None
+
+
+_current_frame: ContextVar[Frame | None] = ContextVar("edron_current_frame", default=None)
+
+
+def current_frame() -> Frame | None:
+    return _current_frame.get()
+
+
+def require_frame(*phases: str) -> Frame:
+    frame = current_frame()
+    if frame is None:
+        raise PhaseError(
+            "this Edron operation is only valid during a request", code="EDRON_NO_REQUEST"
+        )
+    if phases and frame.phase not in phases:
+        expected = ", ".join(phases)
+        raise PhaseError(
+            f"operation is valid during {expected}, not {frame.phase}",
+            code="EDRON_WRONG_PHASE",
+        )
+    return frame
+
+
+@contextmanager
+def frame_context(frame: Frame) -> Iterator[Frame]:
+    token = _current_frame.set(frame)
+    try:
+        yield frame
+    finally:
+        frame.buffer.closed = True
+        _current_frame.reset(token)
+
+
+def native_request() -> Any:
+    return require_frame().request