https://github.com/bsm/bfs
Multi-adapter bucket-based file system abstraction. #golang
https://github.com/bsm/bfs
Last synced: 8 months ago
JSON representation
Multi-adapter bucket-based file system abstraction. #golang
- Host: GitHub
- URL: https://github.com/bsm/bfs
- Owner: bsm
- License: apache-2.0
- Created: 2018-04-13T08:33:41.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-12-11T22:23:11.000Z (over 1 year ago)
- Last Synced: 2025-03-22T19:02:42.847Z (about 1 year ago)
- Language: Go
- Size: 449 KB
- Stars: 14
- Watchers: 5
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BFS
[](https://godoc.org/github.com/bsm/bfs)
[](https://github.com/bsm/bfs/actions/workflows/test.yml)
Multi-adapter bucket-based file system abstraction.
## Documentation
For documentation and examples, please see https://godoc.org/github.com/bsm/bfs.
## Install
```
go get -u github.com/bsm/bfs
```
## Basic Usage
```go
package main
import (
"fmt"
"github.com/bsm/bfs"
)
func main() {
ctx := context.Background()
bucket := bfs.NewInMem()
// Write object
o1, err := bucket.Create(ctx, "nested/file.txt", nil)
if err != nil {
panic(err)
}
defer o1.Discard()
if _, err := o1.Write([]byte("TESTDATA")); err != nil {
panic(err)
}
if err := o1.Commit(); err != nil {
panic(err)
}
// Glob entries
entries, err := bucket.Glob(ctx, "nested/**")
if err != nil {
panic(err)
}
fmt.Println("ENTRIES:", entries)
// Read object
o2, err := bucket.Open(ctx, "nested/file.txt")
if err != nil {
panic(err)
}
defer o2.Close()
data, err := io.ReadAll(o2)
if err != nil {
panic(err)
}
fmt.Println("DATA:", string(data))
// Head object
info, err := bucket.Head(ctx, "nested/file.txt")
if err != nil {
panic(err)
}
fmt.Printf("INFO: name=%q size=%d\n", info.Name, info.Size)
// Delete object
if err := bucket.Remove(ctx, "nested/file.txt"); err != nil {
panic(err)
}
}
```