variantkey

encode/decode variants to/from uint64

Pure Nim score 15/100 · tests present · no docs generated

Summary

Latest Version Unknown
License MIT
CI Status Failing
Downloads 0
Last Indexed 2026-07-21 05:24

Tags

vcf variant genomics

Installation

nimble install variantkey
choosenim install variantkey
git clone https://github.com/brentp/variantkey-nim

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
variantkey ✓ ✓ ✓ - - - - - - -

Source

Repository https://github.com/brentp/variantkey-nim
Homepage https://github.com/brentp/variantkey-nim
Registry Source nimble_official

README

variantkey

nim wrapper for variantkey.

This wrapper can encode+decode about 5 million variants per second. The entirety of the API exposed by this library is demonstrated below:

import variantkey

var
  chrom = "19"
  pos = 3323934'u32
  # encode
  e = encode(chrom, pos, "A", "T")


assert e.exact
echo e # 10959892387821256704
echo e.decode # (chrom: "19", position: 3323934, reference: "A", alternate: "T", exact: true)

# longer variants are encoded with a hash
e = encode("1", 878111, "CAGGGGCCCCCGGGCTCCGGACCCCCCACCCCGTCCCGGGACTCTGCCCGGCGAGCCCCCCGGAA", "C")
# the reference and alternate are not set upon decoding.
echo e # (chrom: "1", position: 878111, reference: "", alternate: "")