Skip to main content

Filesystem

The fs plugin reads files and directories from the workspace filesystem. It provides two target types: file for referencing a single file, and glob for matching multiple files with patterns. Both types emit output artifacts that can be consumed by other build targets as inputs, which lets the rest of the graph depend on raw workspace content without copying or restating paths.

Driver​

A driver is the component that knows how to execute a particular kind of target. The fs plugin registers a single driver named fs.

Enabling it​

Built-in and auto-registered. The fs driver is always available in heph and does not require configuration in .hephconfig.

Usage​

//@heph/fs:file@f=src/main.rs
//@heph/fs:glob@p=src/**/*.rs@e=vendor/**,generated/**

Notes​

Path normalization: all paths are normalized (. and .. segments are collapsed), and leading/trailing ../ escapes are rejected to prevent escaping the workspace root.

Glob patterns use the wax library with support for *, ?, [..], {..}, and ** operators. Within a single build request, glob walk results are memoized to avoid redundant filesystem traversal.