Recursively copy Go virtual file systems, such as gobindata, vfsgen, and http.FileSystem.
Go to file
AJ ONeal 86a1bd4bec
update examples section
2020-10-23 20:37:41 -06:00
fixtures tested working (for proper implementations) 2020-10-23 15:21:19 -06:00
internal/tools tested working (for proper implementations) 2020-10-23 15:21:19 -06:00
vendor vendor deps for tests 2020-10-23 15:21:36 -06:00
.gitignore tested working (for proper implementations) 2020-10-23 15:21:19 -06:00
AUTHORS add LICENSE, AUTHORS, update README 2020-10-23 15:30:09 -06:00
LICENSE add LICENSE, AUTHORS, update README 2020-10-23 15:30:09 -06:00
README.md update examples section 2020-10-23 20:37:41 -06:00
copy.go rename Copy => CopyAll, update docs 2020-10-23 15:38:54 -06:00
copy_test.go rename Copy => CopyAll, update docs 2020-10-23 15:38:54 -06:00
go.mod tested working (for proper implementations) 2020-10-23 15:21:19 -06:00
go.sum tested working (for proper implementations) 2020-10-23 15:21:19 -06:00
options.go tested working (for proper implementations) 2020-10-23 15:21:19 -06:00
vfs.go tested working (for proper implementations) 2020-10-23 15:21:19 -06:00

README.md

vfscopy

Recursively copy a Virtual FileSystem, such as http.FileSystem, to a native file system destination.

Works with any file system that implements http.FileSystem, including vfsgen, fileb0x, gobindata and most others.

GoDoc

See https://pkg.go.dev/git.rootprojects.org/root/vfscopy.

Examples

(Native) File System

httpfs := http.Dir("/tmp/public/")
vfs := vfscopy.NewVFS(httpfs)

if err := vfscopy.CopyAll(vfs, ".", "/tmp/dst/"); nil != err {
    fmt.Fprintf(os.Stderr, "couldn't copy vfs: %v\n", err)
}

vfsgen (http.FileSystem)

Note: vfsgen does not support symlinks or file permissions.

package main

import (
    "fmt"

    "git.rootprojects.org/root/vfscopy"

    // vfsgen-generated file system
    "git.example.com/org/project/assets"
)

func main() {
    vfs := vfscopy.NewVFS(assets.Assets)

    if err := vfscopy.CopyAll(vfs, ".", "/tmp/dst/"); nil != err {
        fmt.Fprintf(os.Stderr, "couldn't copy vfs: %v\n", err)
    }
    fmt.Println("Done.")
}

Test

# Generate the test virtual file system
go generate ./...

# Run the tests
go test ./...

License

The MIT License (MIT)

We used the recursive native file system copy implementation at https://github.com/otiai10/copy as a starting point and added virtual file system support.