id       = "drush"
name     = "Drush"
homepage = "https://www.drush.org"
description = "Drush is a command line shell and Unix scripting interface for Drupal."
# The project's own logo, from its repository — drush.org publishes no icon.
icon     = "https://raw.githubusercontent.com/drush-ops/drush/14.x/docs/drush_logo-black.png"
executables   = ["drush"]

[dotfiles]

# https://www.drush.org/13.x/using-drush-configuration/ lists the drush.yml
# search path, including the "User's .drush folder (i.e. ~/.drush/drush.yml)".
# https://www.drush.org/13.x/site-aliases/: "Site alias files for other local
# sites are usually stored in the directory ~/.drush/sites" (Drush only reads
# it once alias-path names it, which is what the drush.yml example there does).
paths = ["~/.drush/drush.yml", "~/.drush/sites/"]

# Aliases name a host, a user and a Drupal root; the password comes from the
# site's own settings.php or from ~/.ssh, neither of which is Drush's file.
secret = []

# Read once per command invocation.
side_effect = false

# No machine_lines: the machine-local values are `root:` and `host:` inside the
# per-site alias files under ~/.drush/sites, and a rule's file has to be one
# concrete path — the alias file names are the user's own site names, so no
# rule here can spell them. Left to the consumer.