gdrive

README

gdrive

Google Drive service support for go-storage.

Install

go get go.beyondstorage.io/services/gdrive

Usage

import (
	"log"

	_ "go.beyondstorage.io/services/gdrive"
	"go.beyondstorage.io/v5/services"
)

func main() {
	store, err := services.NewStoragerFromString("gdrive://path/to/work_dir?name=<a_meaningful_name>?credential=file:<absolute_path_to_credentials>")
	if err != nil {
		log.Fatal(err)
	}

	// Write data from io.Reader into hello.txt
	n, err := store.Write("hello.txt", r, length)
}

• See more examples in go-storage-example.
• Read more docs about go-service-gdrive.

Documentation

Overview

Package gdrive provided support for local file system.

Code generated by go generate via cmd/definitions; DO NOT EDIT.

Index

• Constants
• func NewStorager(pairs ...types.Pair) (types.Storager, error)
• func WithDefaultStoragePairs(v DefaultStoragePairs) Pair
• func WithStorageFeatures(v StorageFeatures) Pair
• type DefaultStoragePairs
• type ObjectSystemMetadata
  • func GetObjectSystemMetadata(o *Object) ObjectSystemMetadata
• type Storage
  • func (s *Storage) Copy(src string, dst string, pairs ...Pair) (err error)
  • func (s *Storage) CopyWithContext(ctx context.Context, src string, dst string, pairs ...Pair) (err error)
  • func (s *Storage) Create(path string, pairs ...Pair) (o *Object)
  • func (s *Storage) CreateDir(path string, pairs ...Pair) (o *Object, err error)
  • func (s *Storage) CreateDirWithContext(ctx context.Context, path string, pairs ...Pair) (o *Object, err error)
  • func (s *Storage) Delete(path string, pairs ...Pair) (err error)
  • func (s *Storage) DeleteWithContext(ctx context.Context, path string, pairs ...Pair) (err error)
  • func (s *Storage) List(path string, pairs ...Pair) (oi *ObjectIterator, err error)
  • func (s *Storage) ListWithContext(ctx context.Context, path string, pairs ...Pair) (oi *ObjectIterator, err error)
  • func (s *Storage) Metadata(pairs ...Pair) (meta *StorageMeta)
  • func (s *Storage) Read(path string, w io.Writer, pairs ...Pair) (n int64, err error)
  • func (s *Storage) ReadWithContext(ctx context.Context, path string, w io.Writer, pairs ...Pair) (n int64, err error)
  • func (s *Storage) Stat(path string, pairs ...Pair) (o *Object, err error)
  • func (s *Storage) StatWithContext(ctx context.Context, path string, pairs ...Pair) (o *Object, err error)
  • func (s *Storage) String() string
  • func (s *Storage) Write(path string, r io.Reader, size int64, pairs ...Pair) (n int64, err error)
  • func (s *Storage) WriteWithContext(ctx context.Context, path string, r io.Reader, size int64, pairs ...Pair) (n int64, err error)
• type StorageFeatures
• type StorageSystemMetadata
  • func GetStorageSystemMetadata(s *StorageMeta) StorageSystemMetadata

Constants

const Type = "gdrive"

Type is the type for gdrive

Functions

func NewStorager

func NewStorager(pairs ...types.Pair) (types.Storager, error)

NewStorager will create Storager only.

func WithDefaultStoragePairs

func WithDefaultStoragePairs(v DefaultStoragePairs) Pair

WithDefaultStoragePairs will apply default_storage_pairs value to Options.

func WithStorageFeatures

func WithStorageFeatures(v StorageFeatures) Pair

WithStorageFeatures will apply storage_features value to Options.

Types

type DefaultStoragePairs

type DefaultStoragePairs struct {
	Copy      []Pair
	Create    []Pair
	CreateDir []Pair
	Delete    []Pair
	List      []Pair
	Metadata  []Pair
	Read      []Pair
	Stat      []Pair
	Write     []Pair
}

DefaultStoragePairs is default pairs for specific action

type ObjectSystemMetadata

type ObjectSystemMetadata struct {
}

ObjectSystemMetadata stores system metadata for object.

func GetObjectSystemMetadata

func GetObjectSystemMetadata(o *Object) ObjectSystemMetadata

GetObjectSystemMetadata will get ObjectSystemMetadata from Object.

- This function should not be called by service implementer. - The returning ObjectServiceMetadata is read only and should not be modified.

type Storage

type Storage struct {
	types.UnimplementedStorager
	types.UnimplementedDirer
	types.UnimplementedCopier
	// contains filtered or unexported fields
}

Storage is the example client.

func (*Storage) Copy

func (s *Storage) Copy(src string, dst string, pairs ...Pair) (err error)

func (*Storage) CopyWithContext

func (s *Storage) CopyWithContext(ctx context.Context, src string, dst string, pairs ...Pair) (err error)

func (*Storage) Create

func (s *Storage) Create(path string, pairs ...Pair) (o *Object)

func (*Storage) CreateDir

func (s *Storage) CreateDir(path string, pairs ...Pair) (o *Object, err error)

func (*Storage) CreateDirWithContext

func (s *Storage) CreateDirWithContext(ctx context.Context, path string, pairs ...Pair) (o *Object, err error)

func (*Storage) Delete

func (s *Storage) Delete(path string, pairs ...Pair) (err error)

func (*Storage) DeleteWithContext

func (s *Storage) DeleteWithContext(ctx context.Context, path string, pairs ...Pair) (err error)

func (*Storage) List

func (s *Storage) List(path string, pairs ...Pair) (oi *ObjectIterator, err error)

func (*Storage) ListWithContext

func (s *Storage) ListWithContext(ctx context.Context, path string, pairs ...Pair) (oi *ObjectIterator, err error)

func (*Storage) Metadata

func (s *Storage) Metadata(pairs ...Pair) (meta *StorageMeta)

func (*Storage) Read

func (s *Storage) Read(path string, w io.Writer, pairs ...Pair) (n int64, err error)

func (*Storage) ReadWithContext

func (s *Storage) ReadWithContext(ctx context.Context, path string, w io.Writer, pairs ...Pair) (n int64, err error)

func (*Storage) Stat

func (s *Storage) Stat(path string, pairs ...Pair) (o *Object, err error)

func (*Storage) StatWithContext

func (s *Storage) StatWithContext(ctx context.Context, path string, pairs ...Pair) (o *Object, err error)

func (*Storage) String

func (s *Storage) String() string

String implements Storager.String

func (*Storage) Write

func (s *Storage) Write(path string, r io.Reader, size int64, pairs ...Pair) (n int64, err error)

func (*Storage) WriteWithContext

func (s *Storage) WriteWithContext(ctx context.Context, path string, r io.Reader, size int64, pairs ...Pair) (n int64, err error)

type StorageFeatures

type StorageFeatures struct {
}

type StorageSystemMetadata

type StorageSystemMetadata struct {
}

StorageSystemMetadata stores system metadata for object.

func GetStorageSystemMetadata

func GetStorageSystemMetadata(s *StorageMeta) StorageSystemMetadata

GetStorageSystemMetadata will get StorageSystemMetadata from Storage.

- This function should not be called by service implementer. - The returning StorageServiceMetadata is read only and should not be modified.