Wags-TAILS

Technology-Assisted Information Loading and Structure (TAILS) for Wagnerds.

This tool provides data acquisition and access utilities for several projects developed by the Wagner Lab. It designates a storage location in user-space where external data files can be saved, and provides methods to download and update them when available.

It is currently used in:

• Thera-Py
• Gene Normalizer
• Disease Normalizer
• and more!

Documentation · Installation · Usage · API reference

Installation

Install from PyPI:

python3 -m pip install wags_tails

Overview

Data source classes provide a get_latest() method that acquires the most recent available data file and returns a pathlib.Path object with its location:

>>> from wags_tails.mondo import MondoData
>>> m = MondoData()
>>> m.get_latest(force_refresh=True)
Downloading mondo.obo: 100%|█████████████████| 171M/171M [00:28<00:00, 6.23MB/s]
PosixPath('/Users/genomicmedlab/.local/share/wags_tails/mondo/mondo_20241105.obo'), '20241105'

This method is also available as a shell command for ease of use and for interoperability with other runtimes:

% wags-tails get-latest mondo
/Users/genomicmedlab/.local/share/wags_tails/mondo/mondo_20241105.obo

Configuration

All data is stored within source-specific subdirectories of a designated WagsTails data directory. By default, this location is ~/.local/share/wags_tails/, but it can be configured by passing a Path directly to a data class on initialization, via the $WAGS_TAILS_DIR environment variable, or via XDG data environment variables.

Feedback and contributing

We welcome bug reports, feature requests, and code contributions from users and interested collaborators. The documentation contains guidance for submitting feedback and contributing new code.