nerd2 / gexto

EXT2/EXT3/EXT4 Filesystem library for Golang
Apache License 2.0
41 stars 14 forks source link

gexto

EXT2/EXT3/EXT4 Filesystem library for Golang

Introduction

Gexto is a Go library to allow read / write access to EXT2/3/4 filesystems.

Created due to my eternal frustration at the crazy world of guestfish, where starting a VM containing a separate and complete linux kernel is apparently the only non-root way of editing a filesystem image.

Aims to provide an "os."-like interface to the filesystem with file objects behaving basically how you would expect them to.

Minimal Example

Error checking omitted for brevity

import (
  "log"
  "github.com/nerd2/gexto"
)

func main() {
  fs, _ := gexto.NewFileSystem("file.ext4")

  f, _ := fs.Create("/test")
  f.Write([]byte("hello world")
  f.Close()

  g, _ := fs.Open("/another/file")
  log.Println(ioutil.ReadAll(file))
}

Testing

Note that testing requires (passwordless) sudo, in order that the test filesystems can be mounted.