repositories

repositories:
  <local-path>:
    type: <git|hg|svn|bzr|tar|zip>
    url:  <string>
    version: <string>   # optional

​

Type

​

Required

​

Entry fields

​

type

​

url

• git: https://..., git@host:owner/repo.git, file://..., or a local path.
• hg, svn, bzr: any URL the matching binary accepts.
• tar, zip: any HTTPS URL returning the archive.

​

version

​

Example

repositories:
  src/gaal:
    type: git
    url: https://github.com/getgaal/gaal.git
    version: main

  src/legacy:
    type: svn
    url: https://svn.example.com/repos/legacy/trunk
    version: "1234"

  vendor/sdk:
    type: tar
    url: https://example.com/sdk-v3.tar.gz
    version: sdk-v3

​

Behaviour

• A first sync clones (or extracts) into the destination path.
• Subsequent syncs fast-forward or re-extract if the URL or version changed.
• Existing non-empty destinations are refused before clone.
• Existing Git checkouts keep using their configured origin; a mismatch with url: is reported instead of silently retargeting the checkout.
• Removing an entry from gaal.yaml does not delete the directory. --prune ignores repositories.

​

Related