2021-02-03 04:06:34 +00:00
|
|
|
package storage
|
|
|
|
|
2021-11-05 01:33:13 +00:00
|
|
|
import (
|
|
|
|
"errors"
|
|
|
|
)
|
2021-10-28 23:35:46 +00:00
|
|
|
|
|
|
|
var (
|
2021-11-09 05:06:41 +00:00
|
|
|
ErrSQLStorageRequiresPath = errors.New("sql storage requires a non-empty path to be defined")
|
|
|
|
ErrMemoryStorageDoesNotSupportPath = errors.New("memory storage does not support persistence, use sqlite if you want persistence on file")
|
2021-10-28 23:35:46 +00:00
|
|
|
)
|
|
|
|
|
2021-07-16 02:07:30 +00:00
|
|
|
// Config is the configuration for storage
|
2021-02-03 04:06:34 +00:00
|
|
|
type Config struct {
|
2021-11-05 01:33:13 +00:00
|
|
|
// Path is the path used by the store to achieve persistence
|
|
|
|
// If blank, persistence is disabled.
|
|
|
|
// Note that not all Type support persistence
|
|
|
|
Path string `yaml:"path"`
|
|
|
|
|
2021-07-16 02:07:30 +00:00
|
|
|
// Type of store
|
|
|
|
// If blank, uses the default in-memory store
|
|
|
|
Type Type `yaml:"type"`
|
2022-08-12 00:47:29 +00:00
|
|
|
|
|
|
|
// Caching is whether to enable caching.
|
|
|
|
// This is used to drastically decrease read latency by pre-emptively caching writes
|
|
|
|
// as they happen, also known as the write-through caching strategy.
|
|
|
|
// Does not apply if Config.Type is not TypePostgres or TypeSQLite.
|
|
|
|
Caching bool `yaml:"caching,omitempty"`
|
2021-02-03 04:06:34 +00:00
|
|
|
}
|
2021-10-28 23:35:46 +00:00
|
|
|
|
|
|
|
// ValidateAndSetDefaults validates the configuration and sets the default values (if applicable)
|
|
|
|
func (c *Config) ValidateAndSetDefaults() error {
|
2021-11-05 01:33:13 +00:00
|
|
|
if c.Type == "" {
|
|
|
|
c.Type = TypeMemory
|
|
|
|
}
|
|
|
|
if (c.Type == TypePostgres || c.Type == TypeSQLite) && len(c.Path) == 0 {
|
2021-11-09 05:06:41 +00:00
|
|
|
return ErrSQLStorageRequiresPath
|
2021-10-28 23:35:46 +00:00
|
|
|
}
|
2021-11-05 01:33:13 +00:00
|
|
|
if c.Type == TypeMemory && len(c.Path) > 0 {
|
2022-06-15 03:36:18 +00:00
|
|
|
return ErrMemoryStorageDoesNotSupportPath
|
2021-11-05 01:33:13 +00:00
|
|
|
}
|
2021-10-28 23:35:46 +00:00
|
|
|
return nil
|
|
|
|
}
|