Interfaces & Data

Interfaces

Interface	Type
fhtoolkit query / fhtoolkit download	CLI (Python, packaged)
Query.py / Download.py	Legacy standalone script entrypoints
fhtoolkit.query / fhtoolkit.download	Python package API
stdout	Human-readable summaries
stderr	Diagnostics/warnings

Produces

• .refs files — one line per Flatpak ref, grouped by category
• .flatpakref files — single-file Flatpak app descriptors
• Console output (human-readable summaries)

Consumes

• Flathub AppStream XML over HTTPS
• Local .refs files as input (for the download step)
• Network access to flathub.org / dl.flathub.org
• Command-line arguments

Depends on

• Python 3.9+
• Internet access
• Flathub endpoints (dl.flathub.org, flathub.org)

No other Aptlantis project or external library dependency — this is a small, self-contained toolkit.

Used by

• Single-operator / local deployment workflows
• Archive/packaging tooling that needs curated lists of Flatpak refs (e.g. feeding a Linux distribution image build, per the drive's linux-genealogy WDS project)

Notable governance detail

The manifest records stage = production but lifecycle = paused — worth noting since those can read as contradictory. Per the governance notes, "production" here reflects a metadata classification from the reconciliation pass, not a release-readiness claim; review is recommended before treating it as release-verified.