Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

s3

package module

Go to main page

Versions in this module

v1

v1.4.1

Dec 28, 2025

v1.4.0

Jul 28, 2025

Changes in this version

+ const NonceSize

+ var ErrInvalidKey = errors.New("invalid key")

type Reader

+ func (r *Reader) Seek(offset int64, whence int) (int64, error)

type S3

+ Endpoint string

+ Insecure bool

+ Profile string

+ Region string

+ RoleARN string

+ UsePathStyle bool

type SecretBoxIO

+ func NewSecretBoxIO(key [32]byte) *SecretBoxIO

+ func (sb *SecretBoxIO) IsValid() bool

v1.3.0

Aug 24, 2024

v1.2.3

Oct 4, 2022

v1.2.2

Sep 30, 2022

v1.2.1

Sep 21, 2022

v1.2.0

Aug 16, 2022

v1.1.0

May 14, 2021

Changes in this version

+ var LockExpiration = 2 * time.Minute

+ var LockPollInterval = 1 * time.Second

+ var LockTimeout = 15 * time.Second

+ type CleartextIO struct

+ func (ci *CleartextIO) ByteReader(buf []byte) Reader

+ func (ci *CleartextIO) WrapReader(r io.Reader) io.Reader

+ type IO interface

+ ByteReader func([]byte) Reader

+ WrapReader func(io.Reader) io.Reader

+ type Reader struct

+ func (r *Reader) Len() int64

+ func (r Reader) Read(buf []byte) (int, error)

+ type S3 struct

+ AccessKey string

+ Bucket string

+ Client *minio.Client

+ EncryptionKey string

+ Host string

+ Logger *zap.Logger

+ Prefix string

+ SecretKey string

+ func (s3 *S3) CaddyModule() caddy.ModuleInfo

+ func (s3 *S3) CertMagicStorage() (certmagic.Storage, error)

+ func (s3 *S3) Delete(key string) error

+ func (s3 *S3) Exists(key string) bool

+ func (s3 *S3) List(prefix string, recursive bool) ([]string, error)

+ func (s3 *S3) Load(key string) ([]byte, error)

+ func (s3 *S3) Lock(ctx context.Context, key string) error

+ func (s3 *S3) Provision(context caddy.Context) error

+ func (s3 *S3) Stat(key string) (certmagic.KeyInfo, error)

+ func (s3 *S3) Store(key string, value []byte) error

+ func (s3 *S3) Unlock(key string) error

+ func (s3 *S3) UnmarshalCaddyfile(d *caddyfile.Dispenser) error

+ type SecretBoxIO struct

+ SecretKey [32]byte

+ func (sb *SecretBoxIO) ByteReader(msg []byte) Reader

+ func (sb *SecretBoxIO) WrapReader(r io.Reader) io.Reader