bioware-kaitai-formats
Installable Python package containing Kaitai Struct–generated parsers for BioWare / KotOR binary and text-derived formats.
Canonical .ksy specifications live in the upstream repository: OldRepublicDevs/bioware-kaitai-formats. This PyKotor workspace copy vendors the generated Python under src/bioware_kaitai_formats/ so consumers (PyKotor, KotorBlender, etc.) depend on this package instead of copying parsers into each project.
Install
From the PyKotor monorepo (workspace):
uv sync --all-packages --all-extras
From PyPI (once published):
pip install bioware-kaitai-formats
Regenerating Python from .ksy
- Clone or sync the upstream spec tree (for example
vendor/bioware-kaitai-formatswith all.ksyfiles). - Install a Kaitai Struct compiler (0.11.x matches this tree).
- Run:
uv run python scripts/regenerate_python.py --ksy-root PATH_TO_KSY_DIR
Optional:
--ksc— path tokaitai-struct-compiler(or.baton Windows); otherwisekaitai-struct-compilermust be onPATH.--repo-root— root of this package (defaults to the directory containingpyproject.toml).
The script compiles into src/bioware_kaitai_formats/, then runs post-processing (relative imports, URL scrub) so the tree matches packaging expectations.
Versioning
Keep this package version aligned with PyKotor releases when wire layouts change. Patch bumps for regenerated-only updates; minor bumps when new specs are added.
Publishing to PyPI
Before uploading a new pykotor release that lists bioware-kaitai-formats>=0.1.0, publish this package (same version or compatible range) to PyPI so plain pip install pykotor resolves the dependency. Monorepo consumers continue to use the workspace member via uv sync.
Metadata
Release files for bioware-kaitai-formats 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| bioware_kaitai_formats-0.1.0.tar.gz | 58.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bioware_kaitai_formats-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 143.2 kB
Release files / bioware_kaitai_formats-0.1.0.tar.gz
| Download URL | bioware_kaitai_formats-0.1.0.tar.gz |
|---|---|
| Size | 58.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
62a34a82cee045ae28de8b89a97e1af6241e3cd974baac3ae5b9779055d391e2
|
|
BLAKE2b-256 checksum How to use checksums |
4f11f3e784ab4f30f5925c832420d4f39fddbc35e935e113bc3e98ad57eb793a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / bioware_kaitai_formats-0.1.0-py3-none-any.whl
| Download URL | bioware_kaitai_formats-0.1.0-py3-none-any.whl |
|---|---|
| Size | 85.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ae3516c608b43a6211c881530af1ce9c1e58fa7c5e77829670a8ddf131ba1d33
|
|
BLAKE2b-256 checksum How to use checksums |
df0189b36660e05a9b35274f8b46780e62b8c6b12c19100e68f387931ac213ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for bioware-kaitai-formats 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.