Documentation
¶
Index ¶
- func Register(reg *execution.ActionRegistry)
- type Backup
- type Copy
- type Link
- type Mkdir
- type Move
- type Provider
- func (p *Provider) Backup(path, backupSuffix string) (string, map[string]any, error)
- func (p *Provider) CompensateBackup(state map[string]any) error
- func (p *Provider) CompensateCopy(state map[string]any) error
- func (p *Provider) CompensateLink(state map[string]any) error
- func (p *Provider) CompensateMove(state map[string]any) error
- func (p *Provider) CompensateRemove(state map[string]any) error
- func (p *Provider) CompensateUnlink(state map[string]any) error
- func (p *Provider) CompensateWrite(state map[string]any) error
- func (p *Provider) Copy(path string, mode os.FileMode, content []byte) (string, map[string]any, error)
- func (p *Provider) Link(source, path string) (map[string]any, error)
- func (p *Provider) Mkdir(path string, mode os.FileMode) error
- func (p *Provider) Move(gitMv func(src, dst string) error, source, path string) (map[string]any, error)
- func (p *Provider) Remove(path string, prune bool, pruneBoundary string) (map[string]any, error)
- func (p *Provider) Source(path string) ([]byte, error)
- func (p *Provider) Unlink(path string, prune bool, pruneBoundary string) (map[string]any, error)
- func (p *Provider) Write(content, path string, mode os.FileMode) (map[string]any, error)
- type Remove
- type Source
- type Unlink
- type Write
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Register ¶
func Register(reg *execution.ActionRegistry)
Register registers all file actions with the given registry.
Types ¶
type Backup ¶
type Backup struct{ Impl *Provider }
Backup moves the existing file at "path" slot to a timestamped backup. Returns the backup path as Result.
type Copy ¶
type Copy struct{ Impl *Provider }
Copy writes content to "path" slot (consumer: reads content from slot, checksums).
type Link ¶
type Link struct{ Impl *Provider }
Link creates a symlink from "path" slot pointing to "source" slot.
type Mkdir ¶
type Mkdir struct{ Impl *Provider }
Mkdir creates a directory at "path" slot.
type Move ¶
type Move struct{ Impl *Provider }
Move moves a file from "source" slot to "path" slot.
type Provider ¶
type Provider struct{}
Provider provides file system operations. Each method receives all inputs as parameters — no execution context, no node access.
Compensable Forward methods return (result, map[string]any, error). The map is the compensation receipt — opaque to the executor, meaningful only to the corresponding Compensate* Backward method.
func (*Provider) Backup ¶
Backup moves the file at path to a timestamped backup location. Returns the backup path and compensation state.
func (*Provider) CompensateBackup ¶
CompensateBackup undoes a Backup by moving the backup back to the original path.
func (*Provider) CompensateCopy ¶
CompensateCopy undoes a Copy operation using the captured state.
func (*Provider) CompensateLink ¶
CompensateLink undoes a Link operation using the captured state.
func (*Provider) CompensateMove ¶
CompensateMove undoes a Move by moving the file back from path to source.
func (*Provider) CompensateRemove ¶
CompensateRemove undoes a Remove by re-creating the file with saved content and mode.
func (*Provider) CompensateUnlink ¶
CompensateUnlink undoes an Unlink by re-creating the symlink.
func (*Provider) CompensateWrite ¶
CompensateWrite undoes a Write operation using the captured state.
func (*Provider) Copy ¶
func (p *Provider) Copy(path string, mode os.FileMode, content []byte) (string, map[string]any, error)
Copy writes content to path with the given mode. Returns the SHA256 checksum of the written content and compensation state.
func (*Provider) Link ¶
Link creates a symlink at path pointing to source. Idempotent: if the symlink already points correctly, it's a no-op (returns nil state).
func (*Provider) Move ¶
func (p *Provider) Move(gitMv func(src, dst string) error, source, path string) (map[string]any, error)
Move moves a file from source to path. Uses gitMv if provided (preserves git history), falling back to os.Rename. Returns compensation state with paths for reverse move.
func (*Provider) Remove ¶
Remove deletes the file at path. If prune is true and pruneBoundary is set, empty parent directories are removed up to the boundary. Returns compensation state with file content for re-creation.
type Remove ¶
type Remove struct{ Impl *Provider }
Remove deletes the file at "path" slot.
type Source ¶
type Source struct{ Impl *Provider }
Source reads a file and returns its content as Result for downstream nodes.
type Unlink ¶
type Unlink struct{ Impl *Provider }
Unlink removes a symlink at "path" slot.
Source Files