e739dd3e89
Enables developers to extend the existing config and API. Initial proof of concept and work in progress. Implementation details may change. Feedback welcome! Signed-off-by: Michael Mayer <michael@photoprism.app>
296 lines
15 KiB
Go
296 lines
15 KiB
Go
package config
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"os"
|
|
"reflect"
|
|
"time"
|
|
|
|
"github.com/urfave/cli"
|
|
"gopkg.in/yaml.v2"
|
|
|
|
"github.com/photoprism/photoprism/pkg/clean"
|
|
"github.com/photoprism/photoprism/pkg/fs"
|
|
"github.com/photoprism/photoprism/pkg/txt"
|
|
)
|
|
|
|
// Options hold the global configuration values without further validation or processing.
|
|
// Application code should retrieve option values via getter functions since they provide
|
|
// validation and return defaults if a value is empty.
|
|
type Options struct {
|
|
Name string `json:"-"`
|
|
Edition string `json:"-"`
|
|
Version string `json:"-"`
|
|
Copyright string `json:"-"`
|
|
PartnerID string `yaml:"-" json:"-" flag:"partner-id"`
|
|
AdminPassword string `yaml:"AdminPassword" json:"-" flag:"admin-password"`
|
|
LogLevel string `yaml:"LogLevel" json:"-" flag:"log-level"`
|
|
Debug bool `yaml:"Debug" json:"Debug" flag:"debug"`
|
|
Trace bool `yaml:"Trace" json:"Trace" flag:"Trace"`
|
|
AuthMode string `yaml:"AuthMode" json:"-" flag:"auth-mode"`
|
|
Public bool `yaml:"Public" json:"-" flag:"public"`
|
|
Test bool `yaml:"-" json:"Test,omitempty" flag:"test"`
|
|
Unsafe bool `yaml:"-" json:"-" flag:"unsafe"`
|
|
Demo bool `yaml:"Demo" json:"-" flag:"demo"`
|
|
Sponsor bool `yaml:"-" json:"-" flag:"sponsor"`
|
|
ReadOnly bool `yaml:"ReadOnly" json:"ReadOnly" flag:"read-only"`
|
|
Experimental bool `yaml:"Experimental" json:"Experimental" flag:"experimental"`
|
|
ConfigPath string `yaml:"ConfigPath" json:"-" flag:"config-path"`
|
|
DefaultsYaml string `json:"-" yaml:"-" flag:"defaults-yaml"`
|
|
OriginalsPath string `yaml:"OriginalsPath" json:"-" flag:"originals-path"`
|
|
OriginalsLimit int `yaml:"OriginalsLimit" json:"OriginalsLimit" flag:"originals-limit"`
|
|
ResolutionLimit int `yaml:"ResolutionLimit" json:"ResolutionLimit" flag:"resolution-limit"`
|
|
StoragePath string `yaml:"StoragePath" json:"-" flag:"storage-path"`
|
|
SidecarPath string `yaml:"SidecarPath" json:"-" flag:"sidecar-path"`
|
|
BackupPath string `yaml:"BackupPath" json:"-" flag:"backup-path"`
|
|
CachePath string `yaml:"CachePath" json:"-" flag:"cache-path"`
|
|
ImportPath string `yaml:"ImportPath" json:"-" flag:"import-path"`
|
|
AssetsPath string `yaml:"AssetsPath" json:"-" flag:"assets-path"`
|
|
CustomAssetsPath string `yaml:"-" json:"-" flag:"custom-assets-path"`
|
|
TempPath string `yaml:"TempPath" json:"-" flag:"temp-path"`
|
|
Workers int `yaml:"Workers" json:"Workers" flag:"workers"`
|
|
WakeupInterval time.Duration `yaml:"WakeupInterval" json:"WakeupInterval" flag:"wakeup-interval"`
|
|
AutoIndex int `yaml:"AutoIndex" json:"AutoIndex" flag:"auto-index"`
|
|
AutoImport int `yaml:"AutoImport" json:"AutoImport" flag:"auto-import"`
|
|
DisableWebDAV bool `yaml:"DisableWebDAV" json:"DisableWebDAV" flag:"disable-webdav"`
|
|
DisableBackups bool `yaml:"DisableBackups" json:"DisableBackups" flag:"disable-backups"`
|
|
DisableSettings bool `yaml:"DisableSettings" json:"-" flag:"disable-settings"`
|
|
DisablePlaces bool `yaml:"DisablePlaces" json:"DisablePlaces" flag:"disable-places"`
|
|
DisableTensorFlow bool `yaml:"DisableTensorFlow" json:"DisableTensorFlow" flag:"disable-tensorflow"`
|
|
DisableFaces bool `yaml:"DisableFaces" json:"DisableFaces" flag:"disable-faces"`
|
|
DisableClassification bool `yaml:"DisableClassification" json:"DisableClassification" flag:"disable-classification"`
|
|
DisableFFmpeg bool `yaml:"DisableFFmpeg" json:"DisableFFmpeg" flag:"disable-ffmpeg"`
|
|
DisableExifTool bool `yaml:"DisableExifTool" json:"DisableExifTool" flag:"disable-exiftool"`
|
|
DisableHeifConvert bool `yaml:"DisableHeifConvert" json:"DisableHeifConvert" flag:"disable-heifconvert"`
|
|
DisableDarktable bool `yaml:"DisableDarktable" json:"DisableDarktable" flag:"disable-darktable"`
|
|
DisableRawtherapee bool `yaml:"DisableRawtherapee" json:"DisableRawtherapee" flag:"disable-rawtherapee"`
|
|
DisableSips bool `yaml:"DisableSips" json:"DisableSips" flag:"disable-sips"`
|
|
DisableRaw bool `yaml:"DisableRaw" json:"DisableRaw" flag:"disable-raw"`
|
|
RawPresets bool `yaml:"RawPresets" json:"RawPresets" flag:"raw-presets"`
|
|
ExifBruteForce bool `yaml:"ExifBruteForce" json:"ExifBruteForce" flag:"exif-bruteforce"`
|
|
DetectNSFW bool `yaml:"DetectNSFW" json:"DetectNSFW" flag:"detect-nsfw"`
|
|
UploadNSFW bool `yaml:"UploadNSFW" json:"-" flag:"upload-nsfw"`
|
|
DefaultTheme string `yaml:"DefaultTheme" json:"DefaultTheme" flag:"default-theme"`
|
|
DefaultLocale string `yaml:"DefaultLocale" json:"DefaultLocale" flag:"default-locale"`
|
|
AppIcon string `yaml:"AppIcon" json:"AppIcon" flag:"app-icon"`
|
|
AppName string `yaml:"AppName" json:"AppName" flag:"app-name"`
|
|
AppMode string `yaml:"AppMode" json:"AppMode" flag:"app-mode"`
|
|
WallpaperUri string `yaml:"WallpaperUri" json:"WallpaperUri" flag:"wallpaper-uri"`
|
|
CdnUrl string `yaml:"CdnUrl" json:"CdnUrl" flag:"cdn-url"`
|
|
SiteUrl string `yaml:"SiteUrl" json:"SiteUrl" flag:"site-url"`
|
|
SiteAuthor string `yaml:"SiteAuthor" json:"SiteAuthor" flag:"site-author"`
|
|
SiteTitle string `yaml:"SiteTitle" json:"SiteTitle" flag:"site-title"`
|
|
SiteCaption string `yaml:"SiteCaption" json:"SiteCaption" flag:"site-caption"`
|
|
SiteDescription string `yaml:"SiteDescription" json:"SiteDescription" flag:"site-description"`
|
|
SitePreview string `yaml:"SitePreview" json:"SitePreview" flag:"site-preview"`
|
|
Imprint string `yaml:"Imprint" json:"Imprint" flag:"imprint"`
|
|
ImprintUrl string `yaml:"ImprintUrl" json:"ImprintUrl" flag:"imprint-url"`
|
|
DatabaseDriver string `yaml:"DatabaseDriver" json:"-" flag:"database-driver"`
|
|
DatabaseDsn string `yaml:"DatabaseDsn" json:"-" flag:"database-dsn"`
|
|
DatabaseServer string `yaml:"DatabaseServer" json:"-" flag:"database-server"`
|
|
DatabaseName string `yaml:"DatabaseName" json:"-" flag:"database-name"`
|
|
DatabaseUser string `yaml:"DatabaseUser" json:"-" flag:"database-user"`
|
|
DatabasePassword string `yaml:"DatabasePassword" json:"-" flag:"database-password"`
|
|
DatabaseConns int `yaml:"DatabaseConns" json:"-" flag:"database-conns"`
|
|
DatabaseConnsIdle int `yaml:"DatabaseConnsIdle" json:"-" flag:"database-conns-idle"`
|
|
HttpHost string `yaml:"HttpHost" json:"-" flag:"http-host"`
|
|
HttpPort int `yaml:"HttpPort" json:"-" flag:"http-port"`
|
|
HttpMode string `yaml:"HttpMode" json:"-" flag:"http-mode"`
|
|
HttpCompression string `yaml:"HttpCompression" json:"-" flag:"http-compression"`
|
|
DarktableBin string `yaml:"DarktableBin" json:"-" flag:"darktable-bin"`
|
|
DarktableCachePath string `yaml:"DarktableCachePath" json:"-" flag:"darktable-cache-path"`
|
|
DarktableConfigPath string `yaml:"DarktableConfigPath" json:"-" flag:"darktable-config-path"`
|
|
DarktableBlacklist string `yaml:"DarktableBlacklist" json:"-" flag:"darktable-blacklist"`
|
|
RawtherapeeBin string `yaml:"RawtherapeeBin" json:"-" flag:"rawtherapee-bin"`
|
|
RawtherapeeBlacklist string `yaml:"RawtherapeeBlacklist" json:"-" flag:"rawtherapee-blacklist"`
|
|
SipsBin string `yaml:"SipsBin" json:"-" flag:"sips-bin"`
|
|
HeifConvertBin string `yaml:"HeifConvertBin" json:"-" flag:"heifconvert-bin"`
|
|
FFmpegBin string `yaml:"FFmpegBin" json:"-" flag:"ffmpeg-bin"`
|
|
FFmpegEncoder string `yaml:"FFmpegEncoder" json:"FFmpegEncoder" flag:"ffmpeg-encoder"`
|
|
FFmpegBitrate int `yaml:"FFmpegBitrate" json:"FFmpegBitrate" flag:"ffmpeg-bitrate"`
|
|
ExifToolBin string `yaml:"ExifToolBin" json:"-" flag:"exiftool-bin"`
|
|
DetachServer bool `yaml:"DetachServer" json:"-" flag:"detach-server"`
|
|
DownloadToken string `yaml:"DownloadToken" json:"-" flag:"download-token"`
|
|
PreviewToken string `yaml:"PreviewToken" json:"-" flag:"preview-token"`
|
|
ThumbColor string `yaml:"ThumbColor" json:"ThumbColor" flag:"thumb-color"`
|
|
ThumbFilter string `yaml:"ThumbFilter" json:"ThumbFilter" flag:"thumb-filter"`
|
|
ThumbSize int `yaml:"ThumbSize" json:"ThumbSize" flag:"thumb-size"`
|
|
ThumbSizeUncached int `yaml:"ThumbSizeUncached" json:"ThumbSizeUncached" flag:"thumb-size-uncached"`
|
|
ThumbUncached bool `yaml:"ThumbUncached" json:"ThumbUncached" flag:"thumb-uncached"`
|
|
JpegQuality string `yaml:"JpegQuality" json:"JpegQuality" flag:"jpeg-quality"`
|
|
JpegSize int `yaml:"JpegSize" json:"JpegSize" flag:"jpeg-size"`
|
|
FaceSize int `yaml:"-" json:"-" flag:"face-size"`
|
|
FaceScore float64 `yaml:"-" json:"-" flag:"face-score"`
|
|
FaceOverlap int `yaml:"-" json:"-" flag:"face-overlap"`
|
|
FaceClusterSize int `yaml:"-" json:"-" flag:"face-cluster-size"`
|
|
FaceClusterScore int `yaml:"-" json:"-" flag:"face-cluster-score"`
|
|
FaceClusterCore int `yaml:"-" json:"-" flag:"face-cluster-core"`
|
|
FaceClusterDist float64 `yaml:"-" json:"-" flag:"face-cluster-dist"`
|
|
FaceMatchDist float64 `yaml:"-" json:"-" flag:"face-match-dist"`
|
|
PIDFilename string `yaml:"PIDFilename" json:"-" flag:"pid-filename"`
|
|
LogFilename string `yaml:"LogFilename" json:"-" flag:"log-filename"`
|
|
}
|
|
|
|
// NewOptions creates a new configuration entity by using two methods:
|
|
//
|
|
// 1. Load: This will initialize options from a yaml config file.
|
|
//
|
|
// 2. SetContext: Which comes after Load and overrides
|
|
// any previous options giving an option two override file configs through the CLI.
|
|
func NewOptions(ctx *cli.Context) *Options {
|
|
c := &Options{}
|
|
|
|
// Has context?
|
|
if ctx == nil {
|
|
return c
|
|
}
|
|
|
|
// Set app name from metadata if possible.
|
|
if s, ok := ctx.App.Metadata["Name"]; ok {
|
|
c.Name = fmt.Sprintf("%s", s)
|
|
}
|
|
|
|
// Set app edition from metadata if possible.
|
|
if s, ok := ctx.App.Metadata["Edition"]; ok {
|
|
c.Edition = fmt.Sprintf("%s", s)
|
|
}
|
|
|
|
// Set copyright and version information.
|
|
c.Copyright = ctx.App.Copyright
|
|
c.Version = ctx.App.Version
|
|
|
|
// Load defaults from YAML file?
|
|
if defaultsYaml := ctx.GlobalString("defaults-yaml"); defaultsYaml == "" {
|
|
log.Tracef("config: defaults yaml file not specified")
|
|
} else if c.DefaultsYaml = fs.Abs(defaultsYaml); !fs.FileExists(c.DefaultsYaml) {
|
|
log.Tracef("config: defaults file %s does not exist", clean.Log(c.DefaultsYaml))
|
|
} else if err := c.Load(c.DefaultsYaml); err != nil {
|
|
log.Warnf("config: failed loading defaults from %s (%s)", clean.Log(c.DefaultsYaml), err)
|
|
}
|
|
|
|
if err := c.SetContext(ctx); err != nil {
|
|
log.Error(err)
|
|
}
|
|
|
|
return c
|
|
}
|
|
|
|
// expandFilenames converts path in config to absolute path
|
|
func (c *Options) expandFilenames() {
|
|
c.ConfigPath = fs.Abs(c.ConfigPath)
|
|
c.StoragePath = fs.Abs(c.StoragePath)
|
|
c.BackupPath = fs.Abs(c.BackupPath)
|
|
c.AssetsPath = fs.Abs(c.AssetsPath)
|
|
c.CachePath = fs.Abs(c.CachePath)
|
|
c.OriginalsPath = fs.Abs(c.OriginalsPath)
|
|
c.ImportPath = fs.Abs(c.ImportPath)
|
|
c.TempPath = fs.Abs(c.TempPath)
|
|
c.PIDFilename = fs.Abs(c.PIDFilename)
|
|
c.LogFilename = fs.Abs(c.LogFilename)
|
|
}
|
|
|
|
// Load uses a yaml config file to initiate the configuration entity.
|
|
func (c *Options) Load(fileName string) error {
|
|
if fileName == "" {
|
|
return nil
|
|
}
|
|
|
|
if !fs.FileExists(fileName) {
|
|
return errors.New(fmt.Sprintf("%s not found", fileName))
|
|
}
|
|
|
|
yamlConfig, err := os.ReadFile(fileName)
|
|
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return yaml.Unmarshal(yamlConfig, c)
|
|
}
|
|
|
|
// SetContext uses options from the CLI to setup configuration overrides
|
|
// for the entity.
|
|
func (c *Options) SetContext(ctx *cli.Context) error {
|
|
v := reflect.ValueOf(c).Elem()
|
|
|
|
// Iterate through all config fields.
|
|
for i := 0; i < v.NumField(); i++ {
|
|
fieldValue := v.Field(i)
|
|
|
|
tagValue := v.Type().Field(i).Tag.Get("flag")
|
|
|
|
// Assign value to field with "flag" tag.
|
|
if tagValue != "" {
|
|
switch t := fieldValue.Interface().(type) {
|
|
case time.Duration:
|
|
var s string
|
|
|
|
// Get duration string.
|
|
if ctx.IsSet(tagValue) {
|
|
s = ctx.String(tagValue)
|
|
} else if ctx.GlobalIsSet(tagValue) || fieldValue.Interface().(time.Duration) == 0 {
|
|
s = ctx.GlobalString(tagValue)
|
|
}
|
|
|
|
// Parse duration string.
|
|
if s == "" {
|
|
// Omit.
|
|
} else if sec := txt.UInt(s); sec > 0 {
|
|
fieldValue.Set(reflect.ValueOf(time.Duration(sec) * time.Second))
|
|
} else if d, err := time.ParseDuration(s); err == nil {
|
|
fieldValue.Set(reflect.ValueOf(d))
|
|
}
|
|
case float64:
|
|
// Only if explicitly set or current value is empty (use default).
|
|
if ctx.IsSet(tagValue) {
|
|
f := ctx.Float64(tagValue)
|
|
fieldValue.SetFloat(f)
|
|
} else if ctx.GlobalIsSet(tagValue) || fieldValue.Float() == 0 {
|
|
f := ctx.GlobalFloat64(tagValue)
|
|
fieldValue.SetFloat(f)
|
|
}
|
|
case int, int64:
|
|
// Only if explicitly set or current value is empty (use default).
|
|
if ctx.IsSet(tagValue) {
|
|
f := ctx.Int64(tagValue)
|
|
fieldValue.SetInt(f)
|
|
} else if ctx.GlobalIsSet(tagValue) || fieldValue.Int() == 0 {
|
|
f := ctx.GlobalInt64(tagValue)
|
|
fieldValue.SetInt(f)
|
|
}
|
|
case uint, uint64:
|
|
// Only if explicitly set or current value is empty (use default).
|
|
if ctx.IsSet(tagValue) {
|
|
f := ctx.Uint64(tagValue)
|
|
fieldValue.SetUint(f)
|
|
} else if ctx.GlobalIsSet(tagValue) || fieldValue.Uint() == 0 {
|
|
f := ctx.GlobalUint64(tagValue)
|
|
fieldValue.SetUint(f)
|
|
}
|
|
case string:
|
|
// Only if explicitly set or current value is empty (use default)
|
|
if ctx.IsSet(tagValue) {
|
|
f := ctx.String(tagValue)
|
|
fieldValue.SetString(f)
|
|
} else if ctx.GlobalIsSet(tagValue) || fieldValue.String() == "" {
|
|
f := ctx.GlobalString(tagValue)
|
|
fieldValue.SetString(f)
|
|
}
|
|
case bool:
|
|
if ctx.IsSet(tagValue) {
|
|
f := ctx.Bool(tagValue)
|
|
fieldValue.SetBool(f)
|
|
} else if ctx.GlobalIsSet(tagValue) {
|
|
f := ctx.GlobalBool(tagValue)
|
|
fieldValue.SetBool(f)
|
|
}
|
|
default:
|
|
log.Warnf("cannot assign value of type %s from cli flag %s", t, tagValue)
|
|
}
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|