agents/bundles: file: source defaults to destination basename
Caught during the left4me-integration nginx 80.conf move: the agent declared a redundant 'source': '80.conf' on a file: item whose destination already ended in 80.conf. The maintainer flagged it as noise. Document the rule: only declare source when the basename differs from the destination (e.g. .mako template to a non-suffixed destination). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
0e88c4967e
commit
7a579f27c5
1 changed files with 6 additions and 0 deletions
|
|
@ -102,6 +102,12 @@ bundles/<name>/
|
||||||
unless the matching `file:` item declares `content_type='mako'`
|
unless the matching `file:` item declares `content_type='mako'`
|
||||||
(or a templating extension triggers it). To check, read the matching
|
(or a templating extension triggers it). To check, read the matching
|
||||||
`file:` entry in `items.py`.
|
`file:` entry in `items.py`.
|
||||||
|
- **`file:` `source` defaults to the destination basename.** For a
|
||||||
|
destination of `/etc/foo/bar.conf` with no `source` key, bw looks
|
||||||
|
for `bundles/<bundle>/files/bar.conf`. Only declare `source`
|
||||||
|
explicitly when the basename you want differs (e.g. shipping a Mako
|
||||||
|
template named `bar.conf.mako` to a destination of
|
||||||
|
`/etc/foo/bar.conf`).
|
||||||
- **Reactors writing across namespaces.** Some bundles' reactors write
|
- **Reactors writing across namespaces.** Some bundles' reactors write
|
||||||
into other bundles' metadata namespaces (e.g. `nextcloud` writes
|
into other bundles' metadata namespaces (e.g. `nextcloud` writes
|
||||||
into `apt.packages`, `archive.paths`). When you change such a bundle,
|
into `apt.packages`, `archive.paths`). When you change such a bundle,
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue