Cache command

Manages the local package cache. The command takes one of three sub-commands:

• add - downloads a package into the local package cache.
• remove - evicts cached package version(s) so the next install/restore re-downloads them. Useful for package authors testing a package they keep re-publishing under the same version.
• verify - re-hashes and re-verifies every package already in the cache.

See Package Cache and Package Signing.

If no sources are specified, those listed in %appdata%\.dpm\dpm.config.yaml are used.

Usage

dpm cache <add|remove|verify> [packageId] [options]

The first positional argument is the sub-command. add and remove take a package id; verify takes no further arguments.

add

Downloads a package (and its dependencies) into the local cache without installing it into a project.

dpm cache add <packageId> -compiler=<version> [options]

-compiler is required. If -version is omitted, the latest version is downloaded.

remove

Removes cached package version(s) from the cache - both the extracted folder and the raw .dpkg file (and its .sha256 sidecar) - so the next install or restore fetches a fresh copy.

dpm cache remove <packageId> [options]

Only the package id is required. The -compiler and -version options act as optional filters:

• Omit -version to remove every cached version of the package id.
• Omit -compiler to remove matches across all compiler versions.

By default the matching packages are listed and you are prompted to confirm before anything is deleted. Pass -force to skip the prompt (for scripted/CI use). If nothing matches, the command reports this and exits successfully without prompting.

verify

Re-hashes every cached package against its manifest and re-runs signature verification.

dpm cache verify

Options

Option	Description
version	The package version. For add, the version to download (latest if omitted). For remove, the version to evict (all cached versions if omitted).
compiler (-c)	The Delphi compiler version. Required for add; an optional filter for remove (all compilers if omitted); ignored by verify. See compiler-versions.
force (-f)	For remove, skip the confirmation prompt.
sources (-s)	Source(s) to fetch from (add). May be specified multiple times. If omitted, all configured sources are used.
configFile	The DPM configuration file to apply. If not specified, %AppData%\.dpm\dpm.config.yaml is used.
verbosity (-v)	Output verbosity: quiet, normal, detailed.
help (-h)	Displays help information for the command.

Examples

dpm cache add VSoft.CommandLine -compiler=10.3

dpm cache add VSoft.CommandLine -compiler=10.3 -version=1.0.1

dpm cache add Spring.Base -compiler=10.3 -source=VSoftInternal

dpm cache remove VSoft.CommandLine -compiler=10.3 -version=1.0.1

dpm cache remove VSoft.CommandLine

dpm cache remove VSoft.CommandLine -force

dpm cache verify