Distributing Go binaries like sqlite-scanner through PyPI using go-to-wheel

Overview

The article explains how to distribute Go binaries through Python’s packaging ecosystem, demonstrating with sqlite-scanner - a Go CLI tool that leverages PyPI’s platform-specific distribution system to make Go binaries installable via simple pip/uv commands across different operating systems and architectures.

The Breakdown

• Magic number detection - sqlite-scanner identifies SQLite databases by checking if the first 16 bytes match the exact sequence ‘SQLite format 3\x00’
• Platform-specific wheel files - PyPI automatically serves the correct binary (like macosx_11_0_arm64.whl vs win_amd64.whl) based on your system architecture
• Go-to-wheel automation - The go-to-wheel tool generates Python wheel packages from Go binaries, handling cross-compilation for 8 different OS/architecture combinations
• Concurrent filesystem scanning - The tool uses goroutines to scan multiple directories simultaneously, streaming results in real-time as JSON or plain text