Registry / aws / total-perspective-vortex

total-perspective-vortex

library3.2.1pypypi✓ verified 81d ago

A library for routing entities (jobs, users or groups) to destinations in Galaxy. Current version is 3.2.1, released in April 2025. Release cadence is irregular with multiple minor releases per year.

aws data workflow

pip install total-perspective-vortex

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · TOTAL-PERSPECTIVE-

total-perspective-vortex

awspythonv3.2.1

Install

6.2s avg

Import

—

Disk

94MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.2.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 98.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 6.2s · import 0.000s · 96MB

94MB installed

● package 94MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

get_version

✓ from tpv import get_version

✗ from total_perspective_vortex.config import TPVConfigLoader

version

✓ from tpv import version

PackageNotFoundError

✓ from tpv import PackageNotFoundError

Basic usage: create an entity, load a router, and route to a destination.

from total_perspective_vortex.entities import Entity from total_perspective_vortex.routing import Router # Define an entity (e.g., a job) entity = Entity( id="job-123", tool_id="toolshed.g2.bx.psu.edu/repos/devteam/fastqc/fastqc/0.11.9", user="alice" ) # Initialize router with config path router = Router(config_path="tpv_config.yml") # Route entity to destination destination = router.route(entity) print(destination)

Debug

Known issues

breakingVersion 3.0.0 changed the TPV shared database URL. Old short links point to db-v1 which is frozen. Use https://gxy.io/tpv/db-v2.yml for latest v2 database or fork your own.

fix

Update config to use new database URL: https://gxy.io/tpv/db-v2.yml

affects: >=3.0.0

deprecatedPydantic v1-style class Config is deprecated since v3.2.1. Replace with ConfigDict (Pydantic v2).

fix

Replace `class Config` with `model_config = ConfigDict(...)` in your custom models.

affects: >=3.2.1

gotchaThe entity 'tool_type' tag is automatically set for special tool types (e.g., 'data_source'). This can override user-set tool_type attributes unexpectedly.

fix

Check if tool is being automatically tagged; manually set tool_type in config after loading.

affects: >=3.2.0

gotchaJinja2 templates in configuration are evaluated at load time; syntax errors or missing variables cause silent failures or unexpected defaults.

fix

Test templates separately and use tpv validate command to catch errors early.

affects: all

Upgrade

Version history

3.2.1latest on PyPI · released Apr 13, 2026

Audit

Dependencies

pydanticrequiredConfiguration models

pyyamlrequiredYAML config parsing

Jinja2requiredTemplate rendering in configuration

Agent activity

48 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/galaxyproject/total-perspective-vortex ↗

packagehttps://pypi.org/project/total-perspective-vortex/ ↗

docshttps://total-perspective-vortex.readthedocs.io ↗