Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

va-spec-python

VA-Spec-Python provides Python language support and a reference implementation for the GA4GH Variant Annotation Specification (VA-Spec).

Information

license

Releases

gitHub tag pypi DOI

Development

action status issues GitHub Open Pull Requests GitHub license GitHub stars GitHub forks

Features

  • Pydantic implementation of VA-Spec models

Known Issues

You are encouraged to browse issues. All known issues are listed there. Please report any issues you find.

Developers

This section is intended for developers who contribute to VA-Spec-Python.

Installing for development

Prerequisites

  • Python >= 3.10
    • Note: Python 3.12 is required for developers contributing to VA-Spec-Python

Fork the repo at https://github.com/ga4gh/va-spec-python/.

Install development dependencies and pre-commit:

git clone --recurse-submodules git@github.com:YOUR_GITHUB_ID/va-spec-python.git
cd va-spec-python
make devready
source venv/3.12/bin/activate
pre-commit install

Check style with ruff:

make format; make lint

Submodules

va-spec-python embeds va-spec as a submodule, only for testing purposes. When checking out va-spec-python and switching branches, it is important to make sure that the submodule tracks va-spec-python correctly. The recommended way to do this is git config --global submodule.recurse true. If you don't set submodule.recurse, developers and reviewers must be extremely careful to not accidentally upgrade or downgrade schemas with respect to va-spec-python.

If you already cloned the repo, but forgot to include --recurse-submodules you can run:

git submodule update --init --recursive

Testing

To run tests:

make test

Security Note (from the GA4GH Security Team)

A stand-alone security review has been performed on the specification itself. This implementation is offered as-is, and without any security guarantees. It will need an independent security review before it can be considered ready for use in security-critical applications. If you integrate this code into your application it is AT YOUR OWN RISK AND RESPONSIBILITY to arrange for a security audit.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ga4gh_va_spec-0.5.0a3.tar.gz (51.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ga4gh_va_spec-0.5.0a3-py3-none-any.whl (38.4 kB view details)

Uploaded Python 3

File details

Details for the file ga4gh_va_spec-0.5.0a3.tar.gz.

File metadata

  • Download URL: ga4gh_va_spec-0.5.0a3.tar.gz
  • Upload date:
  • Size: 51.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ga4gh_va_spec-0.5.0a3.tar.gz
Algorithm Hash digest
SHA256 2015033e84c3f72a4095f75335caff055fb4ae0002214199a3d8e5e3be8ce304
MD5 e9fe56c413865fac45218a9136d76c21
BLAKE2b-256 5de2b4e23182ed1d389662118dd6e612f7208db2d5d5ff4e70823b501cecaf09

See more details on using hashes here.

Provenance

The following attestation bundles were made for ga4gh_va_spec-0.5.0a3.tar.gz:

Publisher: release.yaml on ga4gh/va-spec-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ga4gh_va_spec-0.5.0a3-py3-none-any.whl.

File metadata

File hashes

Hashes for ga4gh_va_spec-0.5.0a3-py3-none-any.whl
Algorithm Hash digest
SHA256 875ce21c962fef5fec02957d6b9fee2988bbe116bb646db5641c2a0616245c6e
MD5 c7908b350dc2fea02bb3511ae82b6148
BLAKE2b-256 26c9f52cca4a1c28825cb57876792c3f3a0b28f4c81fc23ed30749fa2a2a496d

See more details on using hashes here.

Provenance

The following attestation bundles were made for ga4gh_va_spec-0.5.0a3-py3-none-any.whl:

Publisher: release.yaml on ga4gh/va-spec-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page