Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions plugins/heph-expert/skills/heph/references/authoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,11 @@ Both resolve to filesystem (`//@heph/fs:…`) addresses, so their results drop
straight into a dependency field. Paths are relative to the BUILD file's
package by default; pass `abs=True` to resolve from the workspace root.

For `glob()`, `exclude` resolves exactly like `pattern` — package-relative by
default, workspace-root-relative under `abs=True`. A package-relative
`exclude=["vendor/**"]` in `//pkg` excludes `pkg/vendor/**`, not a root-level
`vendor/**`; add `abs=True` to exclude from the workspace root instead.

```python title="BUILD"
target(
name = "lib",
Expand Down
6 changes: 6 additions & 0 deletions website/docs/plugins/buildfile.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,6 +156,12 @@ normalized — `./` prefixes and empty segments are collapsed, `..` components
resolve against the package path, and a path whose `..` segments escape the
workspace root is an error.

For `glob()`, `exclude` resolves exactly like `pattern` — package-relative by
default, workspace-root-relative under `abs = True`. A package-relative
`exclude = ["vendor/**"]` in `//pkg` excludes `pkg/vendor/**`, not a
root-level `vendor/**`; write `exclude = ["vendor/**"], abs = True` to exclude
from the workspace root instead.

### `target()` — what buildfile reads, and what it forwards

`target()` interprets only the fields that describe the target to the engine —
Expand Down
Loading