Skip to main content

Crate fp_appimage_updater

Crate fp_appimage_updater 

Source
Expand description

Declarative AppImage manager.

fp-appimage-updater keeps a set of AppImages current from a tree of YAML recipes, without root, without a GUI, and without a database. You describe each application and where its updates come from; the tool resolves versions, downloads what is newer, and integrates the result into your desktop menu, icons and PATH.

§Getting started

# Write the global config
fp-appimage-updater init --global

# Scaffold a recipe for an app published as a GitHub release
fp-appimage-updater init --app hydra-launcher --strategy forge

# Confirm the recipe parses, then see whether anything is newer
fp-appimage-updater validate
fp-appimage-updater check

# Install it
fp-appimage-updater update

§How it fits together

  • cli parses arguments and, more importantly, carries the user-facing documentation for every command in its doc comments.
  • config holds the shapes of config.yml and of an app recipe. The doc comments on its fields are the published configuration reference.
  • parser finds and reads that YAML; validator checks it.
  • resolvers decide what the newest version is: a forge release, a direct URL checked by ETag or Last-Modified, or a script you supply.
  • downloader fetches it, through a delta path, segmented range requests, or a plain download.
  • integrator extracts the .desktop entry and icon and installs them; disintegrator reverses that.
  • update orchestrates all of the above concurrently; state remembers what was installed.

§Where the documentation lives

The command reference is the doc comments in cli; the configuration reference is the doc comments in config. Those same comments are rendered as --help, as a man page, and on docs.rs. There is no separate documentation tree to drift out of date — see help for how the three are derived from one source.

Modules§

cli
Command-line surface.
commands
config
Configuration types, and the published configuration reference.
disintegrator
doctor
Local health checks, reported by the doctor command.
downloader
extractor
help
--help rendering.
initializer
integrator
lock
output
parser
resolvers
self_updater
state
update
validator