eden/tools/cpm/README.md

CPMUtil Tools

These are supplemental shell scripts for CPMUtil aiming to ease maintenance burden for sanity checking, updates, prefetching, formatting, and standard operations done by these shell scripts, all in one common place.

All scripts are POSIX-compliant.

Meta

These scripts are generally reserved for internal use.

• common.sh: Grabs all available cpmfiles and aggregates them together.
  • Outputs:
    • PACKAGES: The aggregated cpmfile
    • LIBS: The list of individual libraries contained within each cpmfile
    • value: A function that grabs a key from the JSON variable (typically the package key)
• download.sh: Utility script to handle downloading of regular and CI packages.
  • Generally only used by the fetch scripts.
• package.sh: The actual package parser.
  • Inputs:
    • package: The package key
  • Outputs:
    • Basically everything. You're best off reading the code rather than me poorly explaining it.
• which.sh: Find which cpmfile a package is located in.
  • Inputs:
    • The package key

Simple Utilities

These scripts don't really have any functionality, they just help you out a bit yknow?

• format.sh: Format all cpmfiles (4-space indent is enforced)
  • In the future, these scripts will have options for spacing
• hash.sh: Determine the hash of a specific package.
  • Inputs:
    • The repository (e.g. fmtlib/fmt)
    • The sha or tag (e.g. v1.0.1)
    • GIT_HOST: What git host to use (default github.com)
    • USE_TAG: Set to "true" if the second argument is a tag instead of a sha
    • ARTIFACT: The artifact to download, if using a tag. Set to null or empty to use the tag source archive instead
  • Output: the SHA512 sum of the package
• url-hash.sh: Determine the hash of a URL
  • Input: the URL
  • Output: the SHA512 sum of the URL

Functional Utilities

These modify the CPM cache or cpmfiles. Each allows you to input all the packages to act on, as well as a <scriptname>-all.sh that acts upon all available packages.

For the update and hash scripts, set UPDATE=true to update the cpmfile with the new version or hash. Beware: if the hash is cf83e1357... that means you got a 404 error!

• fetch.sh: Prefetch a package according to its cpmfile definition
  • Packages are fetched to the .cache/cpm directory by default, following the CPMUtil default.
• check-updates.sh: Check a package for available updates
  • This only applies to packages that utilize tags.
  • If the tag is a format string, the git_version is acted upon instead.
  • Setting FORCE=true will forcefully update every package and its hash, even if they are on the latest version (UPDATE must also be true)
• check-hashes.sh: Check a package's hash
  • This only applies to packages with hardcoded hashes, NOT ones that use hash URLs.