In-memory filesystem implementation backed by an ETS table.

Implements Bash.Filesystem using ETS for fast, concurrent reads. Each entry in the table is a 4-tuple:

{path :: String.t(), type :: :file | :dir, content :: binary() | nil, stat :: File.Stat.t()}

Usage

# Create with POSIX skeleton directories pre-seeded
tid = Bash.Filesystem.ETS.new()
{:ok, session} = Bash.Session.new(filesystem: {Bash.Filesystem.ETS, tid})

# Create with custom seed files and directories
tid =
  Bash.Filesystem.ETS.new(%{
    "/home/user/.bashrc" => "export PATH=/usr/bin:\$PATH",
    "/usr/local/bin/myscript" => %{content: "#!/bin/bash\necho hi", mode: 0o755},
    "/var/data" => {:dir, nil}
  })

{:ok, session} = Bash.Session.new(filesystem: {Bash.Filesystem.ETS, tid})

Magic device paths

/dev/null, /dev/stdin, /dev/stdout, and /dev/stderr are intercepted at the callback level and never stored in the ETS table. /dev/null is readable (returns ""), while /dev/stdout and /dev/stderr return {:error, :eacces} on read.

ETS table lifecycle

The caller owns the ETS table and is responsible for deleting it via :ets.delete/1 when it is no longer needed.