hedron-data 0.5.0__tar.gz

hedron_data-0.5.0/.gitignore

@@ -0,0 +1,23 @@
+.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/
+.audit-build-proj/
+examples/reference-app/.hedron/
+*.html.gz
+/site/

hedron_data-0.5.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [0.5.0] - 2026-08-03
+
+- Initial `hedron-data` package: data-source protocols, `DataTable`, `DataEditor`,
+  in-memory paged sources (sync + async), optional Narwhals dataframe normalization, and
+  Tabulator-shaped browser adapter assets.
+- Async sources require explicit `page=` at construction; sync `apply_changes` raises for
+  awaitable `apply` and `apply_changes_async` awaits correctly.
+- Writable-field policy rejects forged read-only/hidden fields, unauthorized deletes, and
+  non-mapping inserts.
+- DataEditor host: undo DOM restore, insert/delete, save modes, conflict actions, choices
+  and boolean editors, escaped selectors; CSS fingerprinted via plugin assets.
+
+[0.5.0]: https://github.com/eddiethedean/hedron/releases/tag/v0.5.0

hedron_data-0.5.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_data-0.5.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: hedron-data
+Version: 0.5.0
+Summary: DataTable, DataEditor, and data-source toolkit 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-data/CHANGELOG.md
+Project-URL: Documentation, https://hedron.readthedocs.io/en/latest/
+Author-email: Odos Matthews <odosmatthews@gmail.com>
+Maintainer-email: Odos Matthews <odosmatthews@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: components,data,dataeditor,datatable,hedron,tabulator
+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: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.11
+Requires-Dist: hedron-core==0.5.0
+Provides-Extra: dataframes
+Requires-Dist: narwhals>=1.0; extra == 'dataframes'
+Requires-Dist: pandas>=2.0; extra == 'dataframes'
+Requires-Dist: polars>=1.0; extra == 'dataframes'
+Requires-Dist: pyarrow>=15.0; extra == 'dataframes'
+Provides-Extra: pandas
+Requires-Dist: narwhals>=1.0; extra == 'pandas'
+Requires-Dist: pandas>=2.0; extra == 'pandas'
+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'
+Description-Content-Type: text/markdown
+
+# hedron-data
+
+Data application toolkit for Hedron: `DataTable`, `DataEditor`, typed data-source
+protocols, optional dataframe normalization, and a Tabulator-backed grid Web
+Component.
+
+```bash
+pip install hedron-data
+# Optional dataframe extras:
+pip install "hedron-data[dataframes]"
+```
+
+Requires `hedron-core`. First release: `0.5.0`.

hedron_data-0.5.0/README.md

@@ -0,0 +1,13 @@
+# hedron-data
+
+Data application toolkit for Hedron: `DataTable`, `DataEditor`, typed data-source
+protocols, optional dataframe normalization, and a Tabulator-backed grid Web
+Component.
+
+```bash
+pip install hedron-data
+# Optional dataframe extras:
+pip install "hedron-data[dataframes]"
+```
+
+Requires `hedron-core`. First release: `0.5.0`.

hedron_data-0.5.0/pyproject.toml

@@ -0,0 +1,72 @@
+[project]
+name = "hedron-data"
+version = "0.5.0"
+description = "DataTable, DataEditor, and data-source toolkit 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",
+    "data",
+    "datatable",
+    "dataeditor",
+    "hedron",
+    "tabulator",
+]
+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",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "hedron-core==0.5.0",
+]
+
+[project.optional-dependencies]
+pandas = ["pandas>=2.0", "narwhals>=1.0"]
+polars = ["polars>=1.0", "narwhals>=1.0"]
+pyarrow = ["pyarrow>=15.0", "narwhals>=1.0"]
+dataframes = ["pandas>=2.0", "polars>=1.0", "pyarrow>=15.0", "narwhals>=1.0"]
+
+[project.entry-points."hedron.plugins"]
+hedron_data = "hedron_data.plugin:register"
+
+[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-data/CHANGELOG.md"
+Documentation = "https://hedron.readthedocs.io/en/latest/"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hedron_data"]
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+    "src/hedron_data",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "pyproject.toml",
+]

hedron_data-0.5.0/src/hedron_data/__init__.py

@@ -0,0 +1,53 @@
+"""hedron-data: DataTable, DataEditor, and data-source toolkit."""
+
+from __future__ import annotations
+
+from hedron_data.columns import Column, columns_from_model, resolve_columns
+from hedron_data.editor import DataEditor, conflict_actions, filter_writable_changes
+from hedron_data.memory import AsyncInMemoryDataSource, InMemoryDataSource
+from hedron_data.normalize import normalize_rows
+from hedron_data.sources import (
+    DEFAULT_MAX_PAGE_SIZE,
+    HARD_MAX_PAGE_SIZE,
+    AsyncDataEditorSource,
+    CellUpdate,
+    ColumnSchema,
+    Conflict,
+    DataChanges,
+    DataEditorSource,
+    DataPage,
+    DataQuery,
+    DataSaveResult,
+    FieldError,
+    VisualizationSource,
+)
+from hedron_data.table import DataTable
+
+__version__ = "0.5.0"
+
+__all__ = [
+    "DEFAULT_MAX_PAGE_SIZE",
+    "HARD_MAX_PAGE_SIZE",
+    "AsyncDataEditorSource",
+    "AsyncInMemoryDataSource",
+    "CellUpdate",
+    "Column",
+    "ColumnSchema",
+    "Conflict",
+    "DataChanges",
+    "DataEditor",
+    "DataEditorSource",
+    "DataPage",
+    "DataQuery",
+    "DataSaveResult",
+    "DataTable",
+    "FieldError",
+    "InMemoryDataSource",
+    "VisualizationSource",
+    "__version__",
+    "columns_from_model",
+    "conflict_actions",
+    "filter_writable_changes",
+    "normalize_rows",
+    "resolve_columns",
+]

hedron_data-0.5.0/src/hedron_data/assets/tabulator/editor.css

@@ -0,0 +1,14 @@
+.hedron-data-editor { display: block; }
+.hedron-data-editor-toolbar { display: flex; gap: 0.5rem; margin-bottom: 0.5rem; flex-wrap: wrap; }
+.hedron-data-editor-conflicts { display: flex; gap: 0.5rem; margin-bottom: 0.5rem; }
+.hedron-data-editor-conflicts[hidden] { display: none; }
+.hedron-data-editor-grid { width: 100%; border-collapse: collapse; }
+.hedron-data-editor-grid th,
+.hedron-data-editor-grid td { border: 1px solid currentColor; padding: 0.25rem 0.5rem; }
+.hedron-sr-only {
+  position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px;
+  overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0;
+}
+.hedron-data-table { width: 100%; border-collapse: collapse; }
+.hedron-data-table th,
+.hedron-data-table td { border-bottom: 1px solid currentColor; padding: 0.35rem 0.5rem; text-align: left; }