s3

Documentation

Overview

Copyright 2022 CodeNotary, Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Copyright 2022 CodeNotary, Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Index

• Variables
• func Open(endpoint string, accessKeyID string, secretKey string, bucket string, ...) (remotestorage.Storage, error)
• type Storage
  • func (s *Storage) Exists(ctx context.Context, name string) (bool, error)
  • func (s *Storage) Get(ctx context.Context, name string, offs, size int64) (io.ReadCloser, error)
  • func (s *Storage) ListEntries(ctx context.Context, path string) ([]remotestorage.EntryInfo, []string, error)
  • func (s *Storage) Put(ctx context.Context, name string, fileName string) error
  • func (s *Storage) String() string

Variables

var (
	ErrInvalidArguments = errors.New("invalid arguments")
	ErrInvalidResponse  = errors.New("invalid response code")
	ErrTooManyRedirects = errors.New("too many redirects")
)

Functions

func Open

func Open(
	endpoint string,
	accessKeyID string,
	secretKey string,
	bucket string,
	location string,
	prefix string,
) (remotestorage.Storage, error)

Types

type Storage

type Storage struct {
	// contains filtered or unexported fields
}

func (*Storage) Exists

func (s *Storage) Exists(ctx context.Context, name string) (bool, error)

Exists checks if a remove resource exists and can be read. Note that due to an asynchronous nature of cloud storage, a resource stored with the Put method may not be immediately accessible.

func (*Storage) Get

func (s *Storage) Get(ctx context.Context, name string, offs, size int64) (io.ReadCloser, error)

Get opens a remote s3 resource

func (*Storage) ListEntries

func (s *Storage) ListEntries(ctx context.Context, path string) ([]remotestorage.EntryInfo, []string, error)

func (*Storage) Put

func (s *Storage) Put(ctx context.Context, name string, fileName string) error

Put writes a remote s3 resource

func (*Storage) String

func (s *Storage) String() string