github.com/tetratelabs/wazero@v1.7.3-0.20240513003603-48f702e154b5/internal/sysfs/adapter_test.go

package sysfs

import (
	"errors"
	"fmt"
	"io"
	"io/fs"
	"os"
	"path/filepath"
	"runtime"
	"syscall"
	"testing"

	experimentalsys "github.com/tetratelabs/wazero/experimental/sys"
	"github.com/tetratelabs/wazero/internal/fstest"
	"github.com/tetratelabs/wazero/internal/testing/require"
	"github.com/tetratelabs/wazero/sys"
)

func TestAdaptFS_MkDir(t *testing.T) {
	testFS := &AdaptFS{FS: os.DirFS(t.TempDir())}

	err := testFS.Mkdir("mkdir", fs.ModeDir)
	require.EqualErrno(t, experimentalsys.ENOSYS, err)
}

func TestAdaptFS_Chmod(t *testing.T) {
	testFS := &AdaptFS{FS: os.DirFS(t.TempDir())}

	err := testFS.Chmod("chmod", fs.ModeDir)
	require.EqualErrno(t, experimentalsys.ENOSYS, err)
}

func TestAdaptFS_Rename(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}

	file1 := "file1"
	file1Path := joinPath(tmpDir, file1)
	file1Contents := []byte{1}
	err := os.WriteFile(file1Path, file1Contents, 0o600)
	require.NoError(t, err)

	file2 := "file2"
	file2Path := joinPath(tmpDir, file2)
	file2Contents := []byte{2}
	err = os.WriteFile(file2Path, file2Contents, 0o600)
	require.NoError(t, err)

	err = testFS.Rename(file1, file2)
	require.EqualErrno(t, experimentalsys.ENOSYS, err)
}

func TestAdaptFS_Rmdir(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}

	path := "rmdir"
	realPath := joinPath(tmpDir, path)
	require.NoError(t, os.Mkdir(realPath, 0o700))

	err := testFS.Rmdir(path)
	require.EqualErrno(t, experimentalsys.ENOSYS, err)
}

func TestAdaptFS_Unlink(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}

	path := "unlink"
	realPath := joinPath(tmpDir, path)
	require.NoError(t, os.WriteFile(realPath, []byte{}, 0o600))

	err := testFS.Unlink(path)
	require.EqualErrno(t, experimentalsys.ENOSYS, err)
}

func TestAdaptFS_UtimesNano(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}

	path := "utimes"
	realPath := joinPath(tmpDir, path)
	require.NoError(t, os.WriteFile(realPath, []byte{}, 0o600))

	err := testFS.Utimens(path, experimentalsys.UTIME_OMIT, experimentalsys.UTIME_OMIT)
	require.EqualErrno(t, experimentalsys.ENOSYS, err)
}

func TestAdaptFS_Open_Read(t *testing.T) {
	tmpDir := t.TempDir()
	// Create a subdirectory, so we can test reads outside the sys.FS root.
	tmpDir = joinPath(tmpDir, t.Name())
	require.NoError(t, os.Mkdir(tmpDir, 0o700))
	require.NoError(t, fstest.WriteTestFiles(tmpDir))
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}

	// We can't correct operating system portability issues with os.DirFS on
	// windows. Use syscall.DirFS instead!
	testOpen_Read(t, testFS, true, runtime.GOOS != "windows")

	t.Run("path outside root invalid", func(t *testing.T) {
		_, err := testFS.OpenFile("../foo", experimentalsys.O_RDONLY, 0)

		// sys.FS doesn't allow relative path lookups
		require.EqualErrno(t, experimentalsys.EINVAL, err)
	})
}

func TestAdaptFS_Lstat(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}
	require.NoError(t, fstest.WriteTestFiles(tmpDir))

	for _, path := range []string{"animals.txt", "sub", "sub-link"} {
		fullPath := joinPath(tmpDir, path)
		linkPath := joinPath(tmpDir, path+"-link")
		require.NoError(t, os.Symlink(fullPath, linkPath))

		_, errno := testFS.Lstat(filepath.Base(linkPath))
		require.EqualErrno(t, 0, errno)
	}
}

func TestAdaptFS_Stat(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: os.DirFS(tmpDir)}
	require.NoError(t, fstest.WriteTestFiles(tmpDir))

	testStat(t, testFS)
}

// hackFS cheats the fs.FS contract by opening for write (sys.O_RDWR).
//
// Until we have an alternate public interface for filesystems, some users will
// rely on this. Via testing, we ensure we don't accidentally break them.
type hackFS string

func (dir hackFS) Open(name string) (fs.File, error) {
	path := ensureTrailingPathSeparator(string(dir)) + name

	if f, err := os.OpenFile(path, os.O_RDWR, 0); err == nil {
		return f, nil
	} else if errors.Is(err, syscall.EISDIR) {
		return os.OpenFile(path, os.O_RDONLY, 0)
	} else if errors.Is(err, syscall.ENOENT) {
		return os.OpenFile(path, os.O_RDONLY|os.O_CREATE, 0o444)
	} else {
		return nil, err
	}
}

// TestAdaptFS_HackedWrites ensures we allow writes even if they violate the
// api.FS contract.
func TestAdaptFS_HackedWrites(t *testing.T) {
	tmpDir := t.TempDir()
	testFS := &AdaptFS{FS: hackFS(tmpDir)}

	testOpen_O_RDWR(t, tmpDir, testFS)
}

// MaskOsFS helps prove that the fsFile implementation behaves the same way
// when a fs.FS returns an os.File or methods we use from it.
type MaskOsFS struct {
	Fs fs.FS

	// ZeroIno helps us test stat with sys.Stat_t work.
	ZeroIno bool
}

// Open implements the same method as documented on fs.FS
func (fs *MaskOsFS) Open(name string) (fs.File, error) {
	if f, err := fs.Fs.Open(name); err != nil {
		return nil, err
	} else if osF, ok := f.(*os.File); !ok {
		return nil, fmt.Errorf("input not an os.File %v", osF)
	} else if fs.ZeroIno {
		return &zeroInoOsFile{osF}, nil
	} else {
		return struct{ methodsUsedByFsAdapter }{osF}, nil
	}
}

// zeroInoOsFile wraps an os.File to override functions that can return
// fs.FileInfo.
type zeroInoOsFile struct{ *os.File }

// Readdir implements the same method as documented on os.File
func (f *zeroInoOsFile) Readdir(n int) ([]fs.FileInfo, error) {
	infos, err := f.File.Readdir(n)
	if err != nil {
		return nil, err
	}
	for i := range infos {
		infos[i] = withZeroIno(infos[i])
	}
	return infos, nil
}

// Stat implements the same method as documented on fs.File
func (f *zeroInoOsFile) Stat() (fs.FileInfo, error) {
	info, err := f.File.Stat()
	if err != nil {
		return nil, err
	}
	return withZeroIno(info), nil
}

// withZeroIno clears the sys.Inode which is non-zero on most operating
// systems. We test for zero ensure stat logic always checks for sys.Stat_t
// first. If that failed, at least one OS would return a non-zero value.
func withZeroIno(info fs.FileInfo) fs.FileInfo {
	st := sys.NewStat_t(info)
	st.Ino = 0 // clear
	return &sysFileInfo{info, &st}
}

// sysFileInfo wraps a fs.FileInfo to return *sys.Stat_t from Sys.
type sysFileInfo struct {
	fs.FileInfo
	sys *sys.Stat_t
}

// Sys implements the same method as documented on fs.FileInfo
func (i *sysFileInfo) Sys() any {
	return i.sys
}

// methodsUsedByFsAdapter includes all functions Adapt supports. This includes
// the ability to write files and seek files or directories (directories only
// to zero).
//
// A fs.File implementing this should be functionally equivalent to an os.File,
// even if both are less ideal than using DirFS directly, especially on
// Windows.
//
// For example, on Windows, we cannot reliably read the inode for a
// sys.Dirent with any of these functions.
type methodsUsedByFsAdapter interface {
	// fs.File is used to implement `stat`, `read` and `close`.
	fs.File

	// Fd is only used on windows, to back-fill the inode on `stat`.
	// When implemented, this should dispatch to the same function on os.File.
	Fd() uintptr

	// io.ReaderAt is used to implement `pread`.
	io.ReaderAt

	// io.Seeker is used to implement `seek` on a file or directory. It is also
	// used to implement `pread` when io.ReaderAt isn't implemented.
	io.Seeker
	// ^-- TODO: we can also use this to backfill support for `pwrite`

	// Readdir is used to implement `readdir`, and attempts to retrieve inodes.
	// When implemented, this should dispatch to the same function on os.File.
	Readdir(n int) ([]fs.FileInfo, error)

	// Readdir is used to implement `readdir` when Readdir is not available.
	fs.ReadDirFile

	// io.Writer is used to implement `write`.
	io.Writer

	// io.WriterAt is used to implement `pwrite`.
	io.WriterAt
}