about summary refs log tree commit diff
path: root/test/python/test_dev_token.py
diff options
context:
space:
mode:
authorPjotr <wrk@bosa.lan>2026-11-10 13:17:05 +0000
committerPjotr <wrk@bosa.lan>2026-11-10 13:17:05 +0000
commitde4f3601732e47f54b7e1a6423eb98a86ce55efb (patch)
tree0965c9ddde97fb141dc4248780875a4588314ee2 /test/python/test_dev_token.py
parent7fa899b66f484593e36b175dc6daa5be1d03f2fd (diff)
downloadgenenetwork4-de4f3601732e47f54b7e1a6423eb98a86ce55efb.tar.gz
genes: Wikidata aliases, cached in gene-aliases.lmdb for seven days
A GeneNetwork trait page shows the gene's aliases next to the symbol,
and GN4 had no way to ask for them: gn-guile has a Wikidata lookup
(gn/db/sources/wikidata.scm) and nothing in GN4 did. This is that
lookup with the caching Wikidata deserves -- it is a shared public
service and an alias list is not news.

  * GET /genes/{symbol}/aliases: two SPARQL queries against
    WIKIDATA_ENDPOINT (the entity: a gene wdt:P31 wd:Q7187 in human,
    mouse or rat, labelled with the symbol; then its skos:altLabel s in
    English), cached in WIKIDATA_CACHE_DIR/gene-aliases.lmdb, an LMDB
    file (NO_SUB_DIR, 0600, so one file and LMDB's -lock companion
    rather than a directory of two).
  * TTL WIKIDATA_TTL_SECONDS, seven days by default. Past it the value
    is refetched; ?refresh=true forces that.
  * The label is matched case-insensitively, which the gn-guile query
    did not: human genes are labelled SHH and mouse ones Shh, so an
    exact match finds only one species. ?species=human now returns the
    ortholog's labels -- HLP3, HPE3 and the rest -- which are the ones a
    mouse trait page shows. With no species named the pick is
    deterministic (mouse, rat, human), so a repeated request cannot
    change entity.
  * A failed refresh keeps the last value: the answer says stale: true,
    the envelope is partial, and a note explains it. Nothing cached at
    all is a 502 that says so. An empty alias list and an unreachable
    upstream are different facts, and only one of them is about the
    gene.

Seven unit tests (key scoping, TTL including a clock that went backwards,
the query shape and quote-escaping, SPARQL flattening, an LMDB
round-trip that asserts the file is gene-aliases.lmdb, and
stale-on-failure with and without a cache) and two route tests (the
second call is served from the cache -- same fetched_at -- and the
species switch), which skip with a 502 assertion when there is no
network.
Diffstat (limited to 'test/python/test_dev_token.py')
0 files changed, 0 insertions, 0 deletions