yedipy 0.1.0__tar.gz

yedipy-0.1.0/.gitattributes

@@ -0,0 +1 @@
+*.edi -text

yedipy-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install -e ".[dev]"
+      - run: ruff check .
+      - run: pyright
+      - run: pytest -q
+      - run: python -m build

yedipy-0.1.0/.github/workflows/deploy-pages.yml

@@ -0,0 +1,39 @@
+name: Deploy documentation
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install "mkdocs-material>=9.6"
+      - run: python -m mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

yedipy-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install build twine
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/yedipy
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

yedipy-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+site/

yedipy-0.1.0/CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

yedipy-0.1.0/LICENSE

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

yedipy-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.5
+Name: yedipy
+Version: 0.1.0
+Summary: Lossless X12 EDI parsing for Python
+Project-URL: Documentation, https://patrickarronlee.github.io/yedipy/
+Project-URL: Source, https://github.com/PatrickArronLee/yedipy
+Project-URL: Issues, https://github.com/PatrickArronLee/yedipy/issues
+Project-URL: Changelog, https://github.com/PatrickArronLee/yedipy/blob/main/CHANGELOG.md
+Author: Patrick Arron Lee
+License-Expression: MIT
+License-File: LICENSE
+Keywords: edi,healthcare,hipaa,x12,x12-270
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.11
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.6; extra == 'dev'
+Requires-Dist: pyright>=1.1.390; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: twine>=6.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# YediPy
+
+YediPy is a Python library for lossless X12 EDI parsing and safe structural validation. It includes typed models for the healthcare transaction sets in X12 releases `004010`, `005010`, and `005010` pre-errata (270, 271, 276, 277, 277A, 278, 820, 820 HIX, 834, 835, 837D, 837I, 837P, and 999), plus a hand-written `005010X279A1` 270 parser with hierarchy validation.
+
+## What It Does
+
+- Detects separators from a fixed-width ISA header.
+- Preserves the original source bytes, segment order, elements, and byte offsets.
+- Validates ISA/IEA, GS/GE, and ST/SE nesting, control numbers, and counts.
+- Slices one interchange into ordered ST/SE transactions.
+- Parses 32 transaction sets across three releases into generated Pydantic models with snake_case attributes and OpenFoo aliases.
+- Parses the 270 hierarchy with `HL` parent validation.
+- Emits diagnostics without including source values.
+
+## Install
+
+After the first PyPI release:
+
+```shell
+python -m pip install yedipy
+```
+
+From a checkout:
+
+```shell
+python -m pip install -e ".[dev]"
+```
+
+## CLI
+
+```text
+yedipy x12 inspect input.edi
+yedipy x12 validate input.edi --transaction 270
+```
+
+`inspect` returns structural JSON only. `validate` returns JSON diagnostics and exits with `0` for valid input, `2` for validation failures, and `3` when the input cannot be read.
+
+## Python API
+
+```python
+from pathlib import Path
+
+from yedipy.x12 import parse_x12
+from yedipy.x12.transactions.v5010 import parse_270
+
+result = parse_x12(Path("request.edi").read_bytes())
+result.raise_for_errors()
+
+interchange = result.interchange
+assert interchange is not None
+
+typed = parse_270(interchange.transactions[0], interchange.delimiters)
+assert typed.transaction is not None
+```
+
+Any supported transaction set:
+
+```python
+from yedipy.x12.transactions import parse_transaction
+
+claims = parse_transaction(interchange.transactions[0], interchange.delimiters)
+claims.errors
+claims.transaction  # e.g. yedipy.x12.transactions.v5010.ts837p.TS837P
+```
+
+## Documentation
+
+- [Getting started](https://patrickarronlee.github.io/yedipy/getting-started/)
+- [Transaction sets](https://patrickarronlee.github.io/yedipy/transactions/)
+- [X12 270 support](https://patrickarronlee.github.io/yedipy/x12-270/)
+- [API reference](https://patrickarronlee.github.io/yedipy/api/)
+- [EDI to Python object model](https://patrickarronlee.github.io/yedipy/edi-to-python.html)
+- [Publishing](https://patrickarronlee.github.io/yedipy/publishing/)
+
+## Status
+
+YediPy is pre-release software. It is not a payer-ready eligibility workflow, a FHIR mapper, or a complete X12 implementation.
+
+## License
+
+YediPy is released under the [MIT License](https://github.com/PatrickArronLee/yedipy/blob/main/LICENSE).

yedipy-0.1.0/README.md

@@ -0,0 +1,81 @@
+# YediPy
+
+YediPy is a Python library for lossless X12 EDI parsing and safe structural validation. It includes typed models for the healthcare transaction sets in X12 releases `004010`, `005010`, and `005010` pre-errata (270, 271, 276, 277, 277A, 278, 820, 820 HIX, 834, 835, 837D, 837I, 837P, and 999), plus a hand-written `005010X279A1` 270 parser with hierarchy validation.
+
+## What It Does
+
+- Detects separators from a fixed-width ISA header.
+- Preserves the original source bytes, segment order, elements, and byte offsets.
+- Validates ISA/IEA, GS/GE, and ST/SE nesting, control numbers, and counts.
+- Slices one interchange into ordered ST/SE transactions.
+- Parses 32 transaction sets across three releases into generated Pydantic models with snake_case attributes and OpenFoo aliases.
+- Parses the 270 hierarchy with `HL` parent validation.
+- Emits diagnostics without including source values.
+
+## Install
+
+After the first PyPI release:
+
+```shell
+python -m pip install yedipy
+```
+
+From a checkout:
+
+```shell
+python -m pip install -e ".[dev]"
+```
+
+## CLI
+
+```text
+yedipy x12 inspect input.edi
+yedipy x12 validate input.edi --transaction 270
+```
+
+`inspect` returns structural JSON only. `validate` returns JSON diagnostics and exits with `0` for valid input, `2` for validation failures, and `3` when the input cannot be read.
+
+## Python API
+
+```python
+from pathlib import Path
+
+from yedipy.x12 import parse_x12
+from yedipy.x12.transactions.v5010 import parse_270
+
+result = parse_x12(Path("request.edi").read_bytes())
+result.raise_for_errors()
+
+interchange = result.interchange
+assert interchange is not None
+
+typed = parse_270(interchange.transactions[0], interchange.delimiters)
+assert typed.transaction is not None
+```
+
+Any supported transaction set:
+
+```python
+from yedipy.x12.transactions import parse_transaction
+
+claims = parse_transaction(interchange.transactions[0], interchange.delimiters)
+claims.errors
+claims.transaction  # e.g. yedipy.x12.transactions.v5010.ts837p.TS837P
+```
+
+## Documentation
+
+- [Getting started](https://patrickarronlee.github.io/yedipy/getting-started/)
+- [Transaction sets](https://patrickarronlee.github.io/yedipy/transactions/)
+- [X12 270 support](https://patrickarronlee.github.io/yedipy/x12-270/)
+- [API reference](https://patrickarronlee.github.io/yedipy/api/)
+- [EDI to Python object model](https://patrickarronlee.github.io/yedipy/edi-to-python.html)
+- [Publishing](https://patrickarronlee.github.io/yedipy/publishing/)
+
+## Status
+
+YediPy is pre-release software. It is not a payer-ready eligibility workflow, a FHIR mapper, or a complete X12 implementation.
+
+## License
+
+YediPy is released under the [MIT License](https://github.com/PatrickArronLee/yedipy/blob/main/LICENSE).

yedipy-0.1.0/docs/api.md

@@ -0,0 +1,53 @@
+# API Reference
+
+## `parse_x12(payload)`
+
+Parses `bytes` or an ASCII `str` into an `X12ParseResult`.
+
+| Result member | Description |
+| --- | --- |
+| `interchange` | An `X12Interchange` when the ISA header is valid. |
+| `diagnostics` | Ordered structural diagnostics. |
+| `errors` | Diagnostics whose severity is `error`. |
+| `raise_for_errors()` | Raises `X12ParseError` using diagnostic codes only. |
+
+## `X12Interchange`
+
+| Member | Description |
+| --- | --- |
+| `source` | Original input bytes. |
+| `delimiters` | Element, repetition, component, and segment separators. |
+| `segments` | Ordered `RawSegment` values with byte offsets. |
+| `transactions` | Ordered `RawTransaction` ST/SE slices. |
+| `to_source()` | Returns `source` unchanged. |
+
+## `parse_270(transaction, delimiters)`
+
+Parses one `RawTransaction` into a `Parse270Result`.
+
+| Result member | Description |
+| --- | --- |
+| `transaction` | A `Transaction270` when structural validation succeeds. |
+| `diagnostics` | 270-specific structural diagnostics. |
+| `errors` | Error diagnostics. |
+
+The resulting `Transaction270` exposes `control_number`, `implementation_version`, `beginning`, and `information_sources`.
+
+## `parse_transaction(transaction, delimiters, *, implementation_version=None, release=None)`
+
+Parses one `RawTransaction` with the generated model selected from `ST01` and `ST03` (or `implementation_version`). Returns a `ParseTransactionResult`. Raises `LookupError` when no single model matches.
+
+| Result member | Description |
+| --- | --- |
+| `transaction` | The generated transaction model, or `None` when errors are present. |
+| `diagnostics` | Placement and validation diagnostics. |
+| `errors` | Error diagnostics. |
+| `unmatched_segments` | Segments that did not fit the transaction layout. |
+
+## `load_transaction_model(transaction_set_id, *, implementation_version=None, release=None)`
+
+Imports and returns a generated `X12TransactionSet` subclass. `find_transaction_set` returns its `TransactionSetEntry` without importing it, and `TRANSACTION_SETS` lists every entry.
+
+## `X12TransactionSet.parse(transaction, delimiters)`
+
+Parses with a specific generated model, for example `TS835.parse(raw, delimiters)`. See [Transaction Sets](transactions.md).