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
- API
  
  Reference documentation for the pkg.go.dev API
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

objects

package

Go to main page

Versions in this module

v2

v2.4.2

Aug 31, 2026

v2.4.1

Aug 31, 2026

Changes in this version

+ var ErrMissingFile = errors.New("file is not set")

+ func WithBackupSourceHint(ctx context.Context, source storagetypes.ProviderType) context.Context

+ type BackupResult struct

+ Bucket string

+ Bytes int64

+ Key string

+ Provider storage.ProviderType

+ Region string

+ URI string

+ type BackupSourceHint storagetypes.ProviderType

+ func BackupSourceHintFromContext(ctx context.Context) (BackupSourceHint, bool)

+ type BackupTarget struct

+ Provider storage.Provider

+ ReadFromBackup bool

type Config

+ Backups map[storage.ProviderType]BackupTarget

type Service

+ func (s *Service) Backup(ctx context.Context, file *storagetypes.File) (*BackupResult, error)

+ func (s *Service) BackupProviderFor(source storage.ProviderType) (storage.Provider, bool)

+ func (s *Service) BackupSources() []storage.ProviderType

+ func (s *Service) DeleteBackup(ctx context.Context, file *storagetypes.File, ...) error

+ func (s *Service) ReadFromBackupFor(source storage.ProviderType) (storage.Provider, bool)

v2.4.0

Aug 31, 2026

v2.3.0

Aug 28, 2026

Changes in this version

+ const DefaultClientPoolTTL

+ const DefaultDevStorageBucket

+ const DefaultLocalDiskURL

+ const DefaultS3Region

+ const TemplateKindMetadataKey

+ var ErrInvalidIntegration = errors.New("invalid integration provided")

+ var ErrInvalidUploadOptions = errors.New("invalid upload options")

+ var ErrMissingFileID = errors.New("file id required for presigned URL")

+ var ErrMissingHushID = errors.New("hush ID is missing")

+ var ErrMissingIntegrationID = errors.New("integration ID is missing")

+ var ErrNoIntegrationOrCredentials = errors.New("no integration or credentials available")

+ var ErrNoIntegrationWithSecrets = errors.New("no active integration with secrets found")

+ var ErrNoOrganizationID = errors.New("no organization ID available")

+ var ErrNoSystemIntegration = errors.New("no system integration found")

+ var ErrProviderCreationFailed = errors.New("storage provider creation failed")

+ var ErrProviderResolutionFailed = errors.New("storage provider resolution failed")

+ var ErrSystemIntegrationMissingOrgID = errors.New("system integration missing organization ID")

+ func ApplyProviderHints(ctx context.Context, hints *storagetypes.ProviderHints) context.Context

+ func PopulateProviderHints(file *pkgobjects.File, orgID string)

+ func ResolveModuleFromFile(f pkgobjects.File) (models.OrgModule, bool)

+ func SetTemplateKindHint(file *pkgobjects.File, kind enums.TemplateKind)

+ func WithKnownProviderHint(ctx context.Context, provider storagetypes.ProviderType) context.Context

+ func WithModuleHint(ctx context.Context, module models.OrgModule) context.Context

+ func WithTemplateKindHint(ctx context.Context, kind enums.TemplateKind) context.Context

+ type Config struct

+ ClientService *eddy.ClientService[storage.Provider, storage.ProviderCredentials, *storage.ProviderOptions]

+ Resolver *eddy.Resolver[storage.Provider, storage.ProviderCredentials, *storage.ProviderOptions]

+ ValidationFunc storage.ValidationFunc

+ type KnownProviderHint storagetypes.ProviderType

+ func KnownProviderHintFromContext(ctx context.Context) (KnownProviderHint, bool)

+ type ModuleHint models.OrgModule

+ func ModuleHintFromContext(ctx context.Context) (ModuleHint, bool)

+ type PreferredProviderHint storagetypes.ProviderType

+ func PreferredProviderHintFromContext(ctx context.Context) (PreferredProviderHint, bool)

+ type ProviderCacheKey struct

+ IntegrationType string

+ TenantID string

+ func (k ProviderCacheKey) String() string

+ type Service struct

+ func NewService(cfg Config) *Service

+ func (s *Service) Delete(ctx context.Context, file *storagetypes.File, ...) error

+ func (s *Service) Download(ctx context.Context, provider storage.Provider, file *storagetypes.File, ...) (*storage.DownloadedMetadata, error)

+ func (s *Service) ErrorResponseHandler() storage.ErrResponseHandler

+ func (s *Service) Exists(ctx context.Context, file *storagetypes.File) (bool, error)

+ func (s *Service) GetPresignedURL(ctx context.Context, file *storagetypes.File, duration time.Duration) (string, error)

+ func (s *Service) IgnoreNonExistentKeys() bool

+ func (s *Service) Keys() []string

+ func (s *Service) MaxSize() int64

+ func (s *Service) Skipper() storage.SkipperFunc

+ func (s *Service) Upload(ctx context.Context, reader io.Reader, opts *storage.UploadOptions) (*pkgobjects.File, error)

+ type SizeBytesHint int64

+ func SizeBytesHintFromContext(ctx context.Context) (SizeBytesHint, bool)

+ type TemplateKindHint enums.TemplateKind

+ func TemplateKindHintFromContext(ctx context.Context) (TemplateKindHint, bool)

Other modules containing this package

github.com/theopenlane/core