Crate cargo_dist

dist

This is the library at the core of the ‘dist’ CLI. It currently mostly exists for the sake of internal documentation/testing, and isn’t intended to be used by anyone else. That said, if you have a reason to use it, let us know!

It’s currently not terribly well-suited to being used as a pure library because it happily writes to stderr/stdout whenever it pleases. Suboptimal for a library.

Re-exports

• pub use tasks::*;

Modules

• announce
  Computing the Announcement (and Changelogs)
• backend
  The backend of dist – things it outputs
• build
  Compiling Things
• config
  Config types (for workspace.metadata.dist)
• env
  Functions to parse and manipulate the environment
• errors
  Errors!
• host
  Details for hosting artifacts
• linkage
  The Linkage Checker, which lets us detect what a binary dynamically links to (and why)
• manifest
  Utilities for managing DistManifests
• net
  Centralized logic for initializing http clients to ensure uniform configuration.
• platform
  Logic for computing how different platforms are supported by a project’s archives.
• sign
  Code/artifact signing support
• tasks
  Code to compute the tasks dist should do

Structs

• GenerateArgs
  Arguments for dist generate (do_generate)
• InitArgs
  Arguments for dist init (do_init)

Functions

• check_integrity
  Run any necessary integrity checks for “primary” commands like build/plan
• create_tmp
  Creates a temporary directory, returning the directory and its path as a Utf8PathBuf.
• default_desktop_targets
  Get the default list of targets
• do_build
  dist build – actually build binaries and installers!
• do_env_test
  dist env test – make sure we have everything we need for a build.
• do_generate
  Generate any scripts which are relevant (impl of dist generate)
• do_init
  Run ‘dist init’
• do_manifest
  Just generate the manifest produced by dist build without building
• do_migrate
  Run dist migrate
• fetch_updater
  Fetches an installer executable and installs it in the expected target path.
• known_desktop_targets
  Get the list of all known targets
• run_generate
  The inner impl of do_generate