// Package node provides an in-memory filesystem implementation of io.Medium // ported from Borg's DataNode. It stores files in memory with implicit // directory structure and supports tar serialisation. package node import ( "archive/tar" "bytes" goio "io" "io/fs" "os" "path" "sort" "strings" "time" coreio "forge.lthn.ai/core/go/pkg/io" ) // Node is an in-memory filesystem that implements coreio.Node (and therefore // coreio.Medium). Directories are implicit -- they exist whenever a file path // contains a "/". type Node struct { files map[string]*dataFile } // compile-time interface check var _ coreio.Medium = (*Node)(nil) // New creates a new, empty Node. func New() *Node { return &Node{files: make(map[string]*dataFile)} } // ---------- Node-specific methods ---------- // AddData stages content in the in-memory filesystem. func (n *Node) AddData(name string, content []byte) { name = strings.TrimPrefix(name, "/") if name == "" { return } // Directories are implicit, so we don't store them. if strings.HasSuffix(name, "/") { return } n.files[name] = &dataFile{ name: name, content: content, modTime: time.Now(), } } // ToTar serialises the entire in-memory tree to a tar archive. func (n *Node) ToTar() ([]byte, error) { buf := new(bytes.Buffer) tw := tar.NewWriter(buf) for _, file := range n.files { hdr := &tar.Header{ Name: file.name, Mode: 0600, Size: int64(len(file.content)), ModTime: file.modTime, } if err := tw.WriteHeader(hdr); err != nil { return nil, err } if _, err := tw.Write(file.content); err != nil { return nil, err } } if err := tw.Close(); err != nil { return nil, err } return buf.Bytes(), nil } // FromTar replaces the in-memory tree with the contents of a tar archive. func (n *Node) FromTar(data []byte) error { newFiles := make(map[string]*dataFile) tr := tar.NewReader(bytes.NewReader(data)) for { header, err := tr.Next() if err == goio.EOF { break } if err != nil { return err } if header.Typeflag == tar.TypeReg { content, err := goio.ReadAll(tr) if err != nil { return err } name := strings.TrimPrefix(header.Name, "/") if name == "" || strings.HasSuffix(name, "/") { continue } newFiles[name] = &dataFile{ name: name, content: content, modTime: header.ModTime, } } } n.files = newFiles return nil } // WalkNode walks the in-memory tree, calling fn for each entry. func (n *Node) WalkNode(root string, fn fs.WalkDirFunc) error { return fs.WalkDir(n, root, fn) } // CopyTo copies a file (or directory tree) from the node to any Medium. func (n *Node) CopyTo(target coreio.Medium, sourcePath, destPath string) error { sourcePath = strings.TrimPrefix(sourcePath, "/") info, err := n.Stat(sourcePath) if err != nil { return err } if !info.IsDir() { // Single file copy f, ok := n.files[sourcePath] if !ok { return fs.ErrNotExist } return target.Write(destPath, string(f.content)) } // Directory: walk and copy all files underneath prefix := sourcePath if prefix != "" && !strings.HasSuffix(prefix, "/") { prefix += "/" } for p, f := range n.files { if !strings.HasPrefix(p, prefix) && p != sourcePath { continue } rel := strings.TrimPrefix(p, prefix) dest := destPath if rel != "" { dest = destPath + "/" + rel } if err := target.Write(dest, string(f.content)); err != nil { return err } } return nil } // ---------- Medium interface: fs.FS methods ---------- // Open opens a file from the Node. Implements fs.FS. func (n *Node) Open(name string) (fs.File, error) { name = strings.TrimPrefix(name, "/") if file, ok := n.files[name]; ok { return &dataFileReader{file: file}, nil } // Check if it's a directory prefix := name + "/" if name == "." || name == "" { prefix = "" } for p := range n.files { if strings.HasPrefix(p, prefix) { return &dirFile{path: name, modTime: time.Now()}, nil } } return nil, fs.ErrNotExist } // Stat returns file information for the given path. func (n *Node) Stat(name string) (fs.FileInfo, error) { name = strings.TrimPrefix(name, "/") if file, ok := n.files[name]; ok { return file.Stat() } // Check if it's a directory prefix := name + "/" if name == "." || name == "" { prefix = "" } for p := range n.files { if strings.HasPrefix(p, prefix) { return &dirInfo{name: path.Base(name), modTime: time.Now()}, nil } } return nil, fs.ErrNotExist } // ReadDir reads and returns all directory entries for the named directory. func (n *Node) ReadDir(name string) ([]fs.DirEntry, error) { name = strings.TrimPrefix(name, "/") if name == "." { name = "" } // Disallow reading a file as a directory. if info, err := n.Stat(name); err == nil && !info.IsDir() { return nil, &fs.PathError{Op: "readdir", Path: name, Err: fs.ErrInvalid} } entries := []fs.DirEntry{} seen := make(map[string]bool) prefix := "" if name != "" { prefix = name + "/" } for p := range n.files { if !strings.HasPrefix(p, prefix) { continue } relPath := strings.TrimPrefix(p, prefix) firstComponent := strings.Split(relPath, "/")[0] if seen[firstComponent] { continue } seen[firstComponent] = true if strings.Contains(relPath, "/") { dir := &dirInfo{name: firstComponent, modTime: time.Now()} entries = append(entries, fs.FileInfoToDirEntry(dir)) } else { file := n.files[p] info, _ := file.Stat() entries = append(entries, fs.FileInfoToDirEntry(info)) } } sort.Slice(entries, func(i, j int) bool { return entries[i].Name() < entries[j].Name() }) return entries, nil } // ---------- Medium interface: read/write ---------- // Read retrieves the content of a file as a string. func (n *Node) Read(p string) (string, error) { p = strings.TrimPrefix(p, "/") f, ok := n.files[p] if !ok { return "", fs.ErrNotExist } return string(f.content), nil } // Write saves the given content to a file, overwriting it if it exists. func (n *Node) Write(p, content string) error { n.AddData(p, []byte(content)) return nil } // FileGet is an alias for Read. func (n *Node) FileGet(p string) (string, error) { return n.Read(p) } // FileSet is an alias for Write. func (n *Node) FileSet(p, content string) error { return n.Write(p, content) } // EnsureDir is a no-op because directories are implicit in Node. func (n *Node) EnsureDir(_ string) error { return nil } // ---------- Medium interface: existence checks ---------- // Exists checks if a path exists (file or directory). func (n *Node) Exists(p string) bool { _, err := n.Stat(p) return err == nil } // IsFile checks if a path exists and is a regular file. func (n *Node) IsFile(p string) bool { p = strings.TrimPrefix(p, "/") _, ok := n.files[p] return ok } // IsDir checks if a path exists and is a directory. func (n *Node) IsDir(p string) bool { info, err := n.Stat(p) if err != nil { return false } return info.IsDir() } // ---------- Medium interface: mutations ---------- // Delete removes a single file. func (n *Node) Delete(p string) error { p = strings.TrimPrefix(p, "/") if _, ok := n.files[p]; ok { delete(n.files, p) return nil } return fs.ErrNotExist } // DeleteAll removes a file or directory and all children. func (n *Node) DeleteAll(p string) error { p = strings.TrimPrefix(p, "/") found := false if _, ok := n.files[p]; ok { delete(n.files, p) found = true } prefix := p + "/" for k := range n.files { if strings.HasPrefix(k, prefix) { delete(n.files, k) found = true } } if !found { return fs.ErrNotExist } return nil } // Rename moves a file from oldPath to newPath. func (n *Node) Rename(oldPath, newPath string) error { oldPath = strings.TrimPrefix(oldPath, "/") newPath = strings.TrimPrefix(newPath, "/") f, ok := n.files[oldPath] if !ok { return fs.ErrNotExist } f.name = newPath n.files[newPath] = f delete(n.files, oldPath) return nil } // List returns directory entries for the given path. func (n *Node) List(p string) ([]fs.DirEntry, error) { p = strings.TrimPrefix(p, "/") if p == "" || p == "." { return n.ReadDir(".") } return n.ReadDir(p) } // ---------- Medium interface: streams ---------- // Create creates or truncates the named file, returning a WriteCloser. // Content is committed to the Node on Close. func (n *Node) Create(p string) (goio.WriteCloser, error) { p = strings.TrimPrefix(p, "/") return &nodeWriter{node: n, path: p}, nil } // Append opens the named file for appending, creating it if needed. // Content is committed to the Node on Close. func (n *Node) Append(p string) (goio.WriteCloser, error) { p = strings.TrimPrefix(p, "/") var existing []byte if f, ok := n.files[p]; ok { existing = make([]byte, len(f.content)) copy(existing, f.content) } return &nodeWriter{node: n, path: p, buf: existing}, nil } // ReadStream returns a ReadCloser for the file content. func (n *Node) ReadStream(p string) (goio.ReadCloser, error) { f, err := n.Open(p) if err != nil { return nil, err } return goio.NopCloser(f), nil } // WriteStream returns a WriteCloser for the file content. func (n *Node) WriteStream(p string) (goio.WriteCloser, error) { return n.Create(p) } // ---------- Internal types ---------- // nodeWriter buffers writes and commits them to the Node on Close. type nodeWriter struct { node *Node path string buf []byte } func (w *nodeWriter) Write(p []byte) (int, error) { w.buf = append(w.buf, p...) return len(p), nil } func (w *nodeWriter) Close() error { w.node.files[w.path] = &dataFile{ name: w.path, content: w.buf, modTime: time.Now(), } return nil } // dataFile represents a file in the Node. type dataFile struct { name string content []byte modTime time.Time } func (d *dataFile) Stat() (fs.FileInfo, error) { return &dataFileInfo{file: d}, nil } func (d *dataFile) Read(_ []byte) (int, error) { return 0, goio.EOF } func (d *dataFile) Close() error { return nil } // dataFileInfo implements fs.FileInfo for a dataFile. type dataFileInfo struct{ file *dataFile } func (d *dataFileInfo) Name() string { return path.Base(d.file.name) } func (d *dataFileInfo) Size() int64 { return int64(len(d.file.content)) } func (d *dataFileInfo) Mode() fs.FileMode { return 0444 } func (d *dataFileInfo) ModTime() time.Time { return d.file.modTime } func (d *dataFileInfo) IsDir() bool { return false } func (d *dataFileInfo) Sys() any { return nil } // dataFileReader implements fs.File for reading a dataFile. type dataFileReader struct { file *dataFile reader *bytes.Reader } func (d *dataFileReader) Stat() (fs.FileInfo, error) { return d.file.Stat() } func (d *dataFileReader) Read(p []byte) (int, error) { if d.reader == nil { d.reader = bytes.NewReader(d.file.content) } return d.reader.Read(p) } func (d *dataFileReader) Close() error { return nil } // dirInfo implements fs.FileInfo for an implicit directory. type dirInfo struct { name string modTime time.Time } func (d *dirInfo) Name() string { return d.name } func (d *dirInfo) Size() int64 { return 0 } func (d *dirInfo) Mode() fs.FileMode { return fs.ModeDir | 0555 } func (d *dirInfo) ModTime() time.Time { return d.modTime } func (d *dirInfo) IsDir() bool { return true } func (d *dirInfo) Sys() any { return nil } // dirFile implements fs.File for a directory. type dirFile struct { path string modTime time.Time } func (d *dirFile) Stat() (fs.FileInfo, error) { return &dirInfo{name: path.Base(d.path), modTime: d.modTime}, nil } func (d *dirFile) Read([]byte) (int, error) { return 0, &fs.PathError{Op: "read", Path: d.path, Err: fs.ErrInvalid} } func (d *dirFile) Close() error { return nil } // Ensure Node implements fs.FS so WalkDir works. var _ fs.FS = (*Node)(nil) // Ensure Node also satisfies fs.StatFS and fs.ReadDirFS for WalkDir. var _ fs.StatFS = (*Node)(nil) var _ fs.ReadDirFS = (*Node)(nil) // Unexported helper: ensure ReadStream result also satisfies fs.File // (for cases where callers do a type assertion). var _ goio.ReadCloser = goio.NopCloser(nil) // Ensure nodeWriter satisfies goio.WriteCloser. var _ goio.WriteCloser = (*nodeWriter)(nil) // Ensure dirFile satisfies fs.File. var _ fs.File = (*dirFile)(nil) // Ensure dataFileReader satisfies fs.File. var _ fs.File = (*dataFileReader)(nil) // ReadDirFile is not needed since fs.WalkDir works via ReadDirFS on the FS itself, // but we need the Node to satisfy fs.ReadDirFS. // ensure all internal compile-time checks are grouped above // no further type assertions needed // unused import guard var _ = os.ErrNotExist