bfsgs

Documentation

Overview

Package bfsgs abstracts Google Cloud Storage bucket.

When imported, it registers a global `gs://` scheme resolver and can be used like:

import (
  "github.com/bsm/bfs"

  _ "github.com/bsm/bfs/bfsgs"
)

func main() {
  ctx := context.Background()
  b, _ := bfs.Connect(ctx, "gs://bucket/a")
  f, _ := b.Open(ctx, "b/c.txt") // opens gs://bucket/a/b/c.txt
  ...
}

bfs.Connect supports the following query parameters:

scopes      - custom scopes
credentials - path to custom credentials file

Index

• func New(ctx context.Context, name string, cfg *Config) (bfs.Bucket, error)
• type Config

Functions

func New

func New(ctx context.Context, name string, cfg *Config) (bfs.Bucket, error)

New initiates an bfs.Bucket backed by Google Cloud Storage.

Types

type Config

type Config struct {
	Options       []option.ClientOption // options for Google API client
	Prefix        string                // an optional path prefix
	PredefinedACL string                // an optional predefined ACL string, e.g. "publicRead"
}

Config is passed to New to configure the Google Cloud Storage connection.