dbt-fusion-package-tools

What it is and what it does

dbt-fusion-package-tools is a CLI and library for automatically upgrading dbt package dependencies to versions compatible with dbt Fusion. It reads packages.yml or dependencies.yml from a dbt project, cross-references each package against a local cache of Fusion compatibility data (built from hub.getdbt.com), identifies which versions need updating, and rewrites the version strings in the original file while preserving formatting and comments.

The package centers on four classes: DbtPackageFile (represents a dependency manifest), DbtPackage (a single dependency), DbtPackageVersion (a specific release), and DbtPackageTextFile (preserves raw file layout during rewrites). It includes helper scripts to download package hub data and compute Fusion compatibility matrices, though these are primarily used offline to generate a cached compatibility index. The upgrade workflow is designed to be fast and resilient by avoiding repeated network calls to the package hub.

Use it for:

• Bulk-upgrade all packages in an existing dbt project to Fusion-compatible versions without manual version lookup.
• Dry-run package upgrades to preview changes before committing them to packages.yml.
• Integrate package compatibility checking into CI/CD pipelines to catch incompatible versions early.
• Migrate legacy dbt projects to Fusion by automating the dependency version audit and rewrite step.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Upgrades dbt package dependencies to versions compatible with dbt Fusion by parsing packages.yml/dependencies.yml files, checking compatibility against a local cache of package hub data, and rewriting version strings in place.

Yes, if you maintain dbt projects and need to migrate to Fusion. Install friction is low, maintenance is active, and there are no known vulnerabilities. License treatment is unclear (no SPDX or raw license declared), so verify licensing before use in proprietary codebases. The package is narrowly scoped to a specific dbt workflow; install only if you actually need Fusion compatibility upgrades.

Install

dbt-fusion-package-tools on PyPI

pip install dbt-fusion-package-tools

uv add dbt-fusion-package-tools

poetry add dbt-fusion-package-tools

Installing dbt-fusion-package-tools

Before you install

Low friction: pure Python wheel with seven common runtime dependencies (click, typer, requests, rich, pyyaml, mashumaro, dbt-protos). Active maintenance with a release 14 days ago.

Quickstart

pip install dbt-fusion-package-tools

from dbt_fusion_package_tools.main import upgrade_packages
upgrade_packages(path='/path/to/dbt/project', dry_run=True)

Requires Python 3.10 or later (supports up to <3.14). Expects a dbt project directory containing packages.yml or dependencies.yml with at least one package dependency.

Verify before relying

• Whether the package hub cache (fusion_version_compatibility_output.py) is included in the distribution or must be fetched separately.
• Support status for private dbt packages, as the description notes this as an open TODO.
• Whether dry-run mode actually prevents file writes or only prints proposed changes.

Package facts

Evidence: dbt_fusion_package_tools-0.21.6-py3-none-any.whl

Tags

More Build Tools packages