1
0
mirror of https://github.com/ipfs/kubo.git synced 2025-09-10 05:52:20 +08:00

refactor(repo/config) move config under repo

This commit is contained in:
Brian Tiger Chow
2015-01-12 11:01:15 -08:00
parent e9ba183ecb
commit 5b3164de5c
22 changed files with 17 additions and 17 deletions

144
repo/config/version.go Normal file
View File

@ -0,0 +1,144 @@
package config
import (
"errors"
"strconv"
"strings"
"time"
)
// CurrentVersionNumber is the current application's version literal
const CurrentVersionNumber = "0.1.7"
// Version regulates checking if the most recent version is run
type Version struct {
// Current is the ipfs version for which config was generated
Current string
// Check signals how to react on updates:
// - "ignore" for not checking
// - "warn" for issuing a warning and proceeding
// - "error" for exiting with an error
Check string
// CheckDate is a timestamp for the last time API endpoint was checked for updates
CheckDate time.Time
// CheckPeriod is the time duration over which the update check will not be performed
// (Note: cannot use time.Duration because marshalling with json breaks it)
CheckPeriod string
// AutoUpdate is optional
AutoUpdate AutoUpdateSetting
}
// supported Version.Check values
const (
// CheckError value for Version.Check to raise error and exit if version is obsolete
CheckError = "error"
// CheckWarn value for Version.Check to show warning message if version is obsolete
CheckWarn = "warn"
// CheckIgnore value for Version.Check to not perform update check
CheckIgnore = "ignore"
)
// AutoUpdateSetting implements json.Unmarshaler to check values in config
type AutoUpdateSetting int
// AutoUpdateSetting values
const (
AutoUpdateNever AutoUpdateSetting = iota // do not auto-update
AutoUpdatePatch // only on new patch versions
AutoUpdateMinor // on new minor or patch versions (Default)
AutoUpdateMajor // on all, even Major, version changes
)
// ErrUnknownAutoUpdateSetting is returned when an unknown value is read from the config
var ErrUnknownAutoUpdateSetting = errors.New("unknown value for AutoUpdate")
// defaultCheckPeriod governs h
var defaultCheckPeriod = time.Hour * 48
// UnmarshalJSON checks the input against known strings
func (s *AutoUpdateSetting) UnmarshalJSON(in []byte) error {
switch strings.ToLower(string(in)) {
case `"never"`:
*s = AutoUpdateNever
case `"major"`:
*s = AutoUpdateMajor
case `"minor"`:
*s = AutoUpdateMinor
case `"patch"`:
*s = AutoUpdatePatch
default:
*s = AutoUpdateMinor
return ErrUnknownAutoUpdateSetting
}
return nil
}
// MarshalJSON converts the value back to JSON string
func (s AutoUpdateSetting) MarshalJSON() ([]byte, error) {
return []byte(`"` + s.String() + `"`), nil
}
// String converts valye to human readable string
func (s AutoUpdateSetting) String() string {
switch s {
case AutoUpdateNever:
return "never"
case AutoUpdateMajor:
return "major"
case AutoUpdateMinor:
return "minor"
case AutoUpdatePatch:
return "patch"
default:
return ErrUnknownAutoUpdateSetting.Error()
}
}
func (v *Version) checkPeriodDuration() time.Duration {
d, err := strconv.Atoi(v.CheckPeriod)
if err != nil {
log.Error("config.Version.CheckPeriod parse error. Using default.")
return defaultCheckPeriod
}
return time.Duration(d)
}
// ShouldCheckForUpdate returns if update check API endpoint is needed for this specific runtime
func (v *Version) ShouldCheckForUpdate() bool {
period := v.checkPeriodDuration()
if v.Check == CheckIgnore || v.CheckDate.Add(period).After(time.Now()) {
return false
}
return true
}
// RecordUpdateCheck is called to record that an update check was performed,
// showing that the running version is the most recent one.
func RecordUpdateCheck(cfg *Config, filename string) {
cfg.Version.CheckDate = time.Now()
if cfg.Version.CheckPeriod == "" {
// CheckPeriod was not initialized for some reason (e.g. config file broken)
log.Error("config.Version.CheckPeriod not set. config broken?")
}
WriteConfigFile(filename, cfg)
}
// VersionDefaultValue returns the default version config value (for init).
func VersionDefaultValue() Version {
return Version{
Current: CurrentVersionNumber,
Check: "error",
CheckPeriod: strconv.Itoa(int(defaultCheckPeriod)),
AutoUpdate: AutoUpdateMinor,
}
}