Skip to main content

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

  1. Clone or sync the upstream spec tree (for example vendor/bioware-kaitai-formats with all .ksy files).
  2. Install a Kaitai Struct compiler (0.11.x matches this tree).
  3. Run:
uv run python scripts/regenerate_python.py --ksy-root PATH_TO_KSY_DIR

Optional:

  • --ksc — path to kaitai-struct-compiler (or .bat on Windows); otherwise kaitai-struct-compiler must be on PATH.
  • --repo-root — root of this package (defaults to the directory containing pyproject.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)

Source distribution for bioware-kaitai-formats 0.1.0
File Size Uploaded Provenance
bioware_kaitai_formats-0.1.0.tar.gz 58.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for bioware-kaitai-formats 0.1.0
File Interpreter ABI Platform
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page