A virtual filesystem library written in Rust for the kompo gem. This library enables Ruby scripts and their dependencies to be packed into a single binary by providing a virtual filesystem layer that intercepts system calls.

kompo-vfs consists of three main components:

kompo-vfs hooks into system calls (open, read, stat, opendir, etc.) to transparently redirect file operations. When the packed binary runs:

1. The virtual filesystem is initialized with embedded file data
2. System calls are intercepted and checked against the virtual filesystem
3. If the path exists in the VFS, the operation is handled internally
4. Otherwise, the call falls through to the real filesystem

$ brew tap ahogappa/kompo-vfs https://github.com/ahogappa/kompo-vfs.git
$ brew install ahogappa/kompo-vfs/kompo-vfs

Prerequisites:

• Rust (stable)

$ git clone https://github.com/ahogappa/kompo-vfs.git
$ cd kompo-vfs
$ cargo build --release

The built static libraries will be at:

• target/release/libkompo_fs.a
• target/release/libkompo_wrap.a

This library is designed to be used with the kompo gem. See the kompo documentation for details on packing Ruby applications into single binaries.

$ cargo test -p kompo_storage -p kompo_fs

kompo-vfs/
├── kompo_fs/           # Core VFS implementation
│   └── src/
│       └── lib.rs      # Trie-based filesystem, Ruby bindings
├── kompo_storage/      # Storage layer
│   └── src/
│       └── lib.rs      # File/directory data management
├── kompo_wrap/         # System call wrappers
│   └── src/
│       └── lib.rs      # Intercepts open, read, stat, etc.
└── Formula/            # Homebrew formula

Bug reports and pull requests are welcome on GitHub at https://github.com/ahogappa/kompo-vfs.

This project is licensed under the MIT License - see the LICENSE file for details.

• kompo - Ruby gem that uses kompo-vfs to pack Ruby applications into single binaries