chord-lib 0.3.0

A set of common utilities and helpers for CHORD.

CHORD Library (for Python CHORD microservices)

Common utilities and helpers for CHORD services.

Running Tests

python3 -m pytest --cov=chord_lib --cov-branch

Modules

auth

auth provides Python service decorators and Django / DRF backends for dealing with the CHORD container authentication headers (derived from lua-resty-openidc, set by the internal container NGINX instance.)

events

events facilitates JSON-serialized message-passing between CHORD microservices. Serialized objects can be at most 512 MB.

Events should have a lower-case type which is type-insensitively unique and adequately describes the associated data.

All CHORD channels are prefixed with chord..

ingestion

ingestion contains common code used for handling ingestion routines in different CHORD data services.

schemas

schemas contains common JSON schemas which may be useful to a variety of different CHORD services.

schemas.chord contains CHORD-specific schemas, and schemas.ga4gh contains GA4GH-standardized schemas (possibly not exactly to spec.)

search

search contains definitions, validators, and transformations for the query syntax for CHORD, as well as a transpiler to the psycopg2 PostgreSQL IR.

The query syntax for CHORD takes advantage of JSON schemas augmented with additional properties about the field's accessibility and, in the case of Postgres, how the field maps to a table column (or JSON column sub-field.)

search.data_structure contains code for evaluating a CHORD query against a Python data structure.

search.operations contains constants representing valid search operations one can allow against particular fields from within an augmented JSON schema.

search.postgres contains a "transpiler" from the CHORD query syntax to the psycopg2-provided intermediate representation (IR) for PostgreSQL, allowing safe queries against a Postgres database.

search.queries provides definitions for the CHORD query AST and some helper methods for creating and processing ASTs.

utils

utils contains miscellaneous utilities commonly required by CHORD services.

workflows

workflows contains common code used for handling workflow metadata processing and response generation.