25709610378
84%

Ran 12 May 2026 02:30AM UTC

Jobs 4

Files 25

Run time 1min

Badge

Embed ▾

Committed 12 May 2026 02:29AM UTC coverage: 70.775% (+0.09%) from 70.69%

Build # 25709610378

Build Type

push

github

Committed by

web-flow

Commit Message

Add tcrsift data cache + download + auto-fallback (#32) (#33)

* Add tcrsift data download + metadata sidecar (#32 chunks 2+3)

Extends the foundation with automated downloads:

  tcrsift data download                # all supported DBs
  tcrsift data download --db iedb
  tcrsift data download --force        # refresh

Per-DB download support:
  - IEDB: stable URL at iedb.org/downloader.php (zip with tcr_full_v3.csv)
  - VDJdb: dynamic resolution via GitHub releases API for latest release
  - CEDAR: no stable single-file endpoint; --db cedar reports clearly
    and points users at the manual install location

Each downloaded DB gets a _meta.json sidecar recording source_url,
downloaded_at (UTC ISO timestamp), size_bytes, and sha256. Lets users
audit what they're running annotation against.

All HTTP I/O is injectable via `opener=` for hermetic tests. 9 new
tests mock urlopen with in-memory zips covering: successful extraction,
metadata write, skip-when-cached, force-redownload, missing archive
member raises, VDJdb GitHub-API resolution, missing release asset,
CEDAR-has-no-download, and unknown-db error paths.

10 datacache module tests from chunk 1 still pass; 16 + 9 = 25 total
new tests. Coverage on datacache.py is now ~95%.

* Bump version to 0.8.3

Coverage Stats

4628 of 6539 relevant lines covered (70.78%)

2.83 hits per line

Coverage Regressions

Lines	Coverage	∆	File
281	52.04	-1.61%	cli.py

Jobs

ID	Job ID	Ran	Files	Coverage
1	python-3.9 - 25709610378.1	12 May 2026 02:30AM UTC	25	70.74	GitHub Action Run
2	python-3.10 - 25709610378.2	12 May 2026 02:30AM UTC	25	70.76	GitHub Action Run
3	python-3.12 - 25709610378.3	12 May 2026 02:30AM UTC	25	70.76	GitHub Action Run
4	python-3.11 - 25709610378.4	12 May 2026 02:30AM UTC	25	70.76	GitHub Action Run

pirl-unc / tcrsift / 25709610378
84%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 25709610378

pirl-unc / tcrsift / 25709610378 84%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 25709610378

pirl-unc / tcrsift / 25709610378
84%

README BADGES
x