tinyhgvs 0.4.0

Hybrid Rust/Python library for parsing HGVS variants.

tinyhgvs

tinyhgvs is a lightweight HGVS parsing Python library backed by a core parser and structured data and error model implemented in Rust.

Installation

tinyhgvs can be installed directly from PyPI:

pip install tinyhgvs

Quick start

• A splicing-site substitution crossing exon/intron boundary:

from tinyhgvs import parse_hgvs

variant = parse_hgvs("NM_004006.2:c.357+1G>A")
print(variant.reference.primary.id)
print(variant.coordinate_system.value)
print(variant.description.location.start.coordinate)
print(variant.description.location.start.offset)

• Known but unsupported HGVS syntax raises TINYHGVSError with diagnostic code:

from tinyhgvs import TinyHGVSError, parse_hgvs

try:
    parse_hgvs("NC_000001.11:g.[123G>A;345del]")
except TinyHGVSError as error:
    print(error.code)

Documentation

Please refer to official documents for details about both Python and Rust APIs:

• Python API and project docs
• Rust API docs