Build

Build, package, and release the current application from source.

Prerequisites

  • Python 3.9 or later
  • UV package manager for the recommended workflow
  • Platform-specific system packages for Linux builds when required

Run from source

git clone https://github.com/busaudit/dbcUtility.git
cd dbcUtility
uv sync
uv run dbcUtility

Build Windows executable

uv run python scripts/build_exe.py

Output goes to dist/.

Build Linux distribution

uv run python scripts/build_linux.py

The Linux build flow produces packaged output suitable for distribution and install scripts.

Create releases

Windows

uv run python scripts/release.py

Linux

uv run python scripts/release_linux.py

Release output is written into versioned folders such as release-v1.0.3/.

Linux packaging notes

The Linux build guide describes generated artifacts such as:

  • install scripts
  • uninstall scripts
  • portable launchers
  • desktop integration files
  • release tarballs and AppImages

Troubleshooting

  • If a Linux build script is not executable, run chmod +x on the script
  • If dependencies are missing, install the required system packages and rerun uv sync
  • If builds fail repeatedly, remove build/ and dist/ and retry a clean build