payloaded
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
pip install payloaded
Quickstart
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 file for details.
1 maintainer
Release files for payloaded 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| payloaded-0.0.1.tar.gz | 3.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| payloaded-0.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.3 kB
Release files / payloaded-0.0.1.tar.gz
| Download URL | payloaded-0.0.1.tar.gz |
|---|---|
| Size | 3.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3eaf9f847ca2cfb234da48a7b16a3f33d4602648bcb0cfe6dfe7fed79d789584
|
|
BLAKE2b-256 checksum How to use checksums |
e2e6a3a5ae44dc3fd06854d7bb688ecd6884fb2bb0a23e8a0c34c5b542360871
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
Release files / payloaded-0.0.1-py3-none-any.whl
| Download URL | payloaded-0.0.1-py3-none-any.whl |
|---|---|
| Size | 3.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f1031b35c446662ffe0731016ff13015e59ecf8e4366eb4f3dbadde057f77f3b
|
|
BLAKE2b-256 checksum How to use checksums |
a534821e4c584c9058842acc54cbbcfd20892cc933eec5d91ad32ea5b17de879
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
