payloaded 0.0.1__tar.gz

payloaded-0.0.1/.gitignore

@@ -0,0 +1,48 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE & OS
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo

payloaded-0.0.1/LICENSE

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

payloaded-0.0.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: payloaded
+Version: 0.0.1
+Summary: Transform flat tabular data into nested, hierarchical API payloads with grouping and reconciliation.
+Project-URL: Homepage, https://github.com/svr-s/payloaded
+Project-URL: Repository, https://github.com/svr-s/payloaded
+Project-URL: Issues, https://github.com/svr-s/payloaded/issues
+Author: svr-s
+License: MIT
+License-File: LICENSE
+Keywords: api,batching,data-transformation,json,pandas,payload
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: pandas>=1.5.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: twine>=4.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# payloaded
+
+[![PyPI version](https://img.shields.io/pypi/v/payloaded.svg)](https://pypi.org/project/payloaded/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**`payloaded`** transforms flat tabular data (CSVs, DataFrames) into nested, hierarchical JSON payloads for REST/GraphQL APIs with grouping, batch chunking, and mathematical row reconciliation.
+
+---
+
+## Key Features
+
+- **Template-Driven Payloads**: Map tabular columns directly to placeholders in complex, nested JSON skeletons.
+- **Hierarchical Grouping**: Group rows by parent entities and automatically nest repeating child and grandchild elements.
+- **Batch Chunking**: Split repeating entities across multiple payloads when batch limits are exceeded (e.g., max 50 line items per payload).
+- **Audit & Zero-Loss Reconciliation**: Generates an auditable DataFrame containing payload indices, row tallies, source filenames, and Postman-ready payloads.
+
+---
+
+## Installation
+
+```bash
+pip install payloaded
+```
+
+---
+
+## Quickstart
+
+```python
+import payloaded as pl
+
+# Coming soon in v0.1.0!
+```
+
+---
+
+## Output Structure
+
+The output DataFrame provides complete transparency:
+
+| Column | Description |
+|---|---|
+| `index` | Incremental payload identifier |
+| `running_total` | Cumulative count of source rows packed (verifies zero data loss) |
+| `payload` | Complete JSON payload ready to dispatch or paste into Postman |
+| `source_filename` | Origin file name for multi-file traceability |
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

payloaded-0.0.1/Payloaded - Testing/v0.0.1_testing/test_version.py

@@ -0,0 +1,8 @@
+"""Unit test verifying payloaded package initialization and version."""
+
+import payloaded
+
+
+def test_package_version():
+    """Verify that payloaded exposes the correct initial version string."""
+    assert payloaded.__version__ == "0.0.1"

payloaded-0.0.1/README.md

@@ -0,0 +1,52 @@
+# payloaded
+
+[![PyPI version](https://img.shields.io/pypi/v/payloaded.svg)](https://pypi.org/project/payloaded/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**`payloaded`** transforms flat tabular data (CSVs, DataFrames) into nested, hierarchical JSON payloads for REST/GraphQL APIs with grouping, batch chunking, and mathematical row reconciliation.
+
+---
+
+## Key Features
+
+- **Template-Driven Payloads**: Map tabular columns directly to placeholders in complex, nested JSON skeletons.
+- **Hierarchical Grouping**: Group rows by parent entities and automatically nest repeating child and grandchild elements.
+- **Batch Chunking**: Split repeating entities across multiple payloads when batch limits are exceeded (e.g., max 50 line items per payload).
+- **Audit & Zero-Loss Reconciliation**: Generates an auditable DataFrame containing payload indices, row tallies, source filenames, and Postman-ready payloads.
+
+---
+
+## Installation
+
+```bash
+pip install payloaded
+```
+
+---
+
+## Quickstart
+
+```python
+import payloaded as pl
+
+# Coming soon in v0.1.0!
+```
+
+---
+
+## Output Structure
+
+The output DataFrame provides complete transparency:
+
+| Column | Description |
+|---|---|
+| `index` | Incremental payload identifier |
+| `running_total` | Cumulative count of source rows packed (verifies zero data loss) |
+| `payload` | Complete JSON payload ready to dispatch or paste into Postman |
+| `source_filename` | Origin file name for multi-file traceability |
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

payloaded-0.0.1/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling>=1.26.0,<1.32.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "payloaded"
+version = "0.0.1"
+description = "Transform flat tabular data into nested, hierarchical API payloads with grouping and reconciliation."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "svr-s" }
+]
+keywords = ["api", "payload", "json", "pandas", "data-transformation", "batching"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "pandas>=1.5.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "build>=1.0.0",
+    "twine>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/svr-s/payloaded"
+Repository = "https://github.com/svr-s/payloaded"
+Issues = "https://github.com/svr-s/payloaded/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/payloaded"]

payloaded-0.0.1/src/payloaded/__init__.py

@@ -0,0 +1,8 @@
+"""payloaded.
+
+A Python package to transform flat tabular data into nested,
+hierarchical API payloads with grouping and reconciliation.
+"""
+
+__version__ = "0.0.1"
+__all__ = ["__version__"]

payloaded-0.0.1/src/payloaded/py.typed

@@ -0,0 +1 @@
+# Marker file for PEP 561.