72 lines
1.9 KiB
Go
72 lines
1.9 KiB
Go
package i3
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
"log"
|
||
)
|
||
|
||
// Version describes an i3 version.
|
||
//
|
||
// See https://i3wm.org/docs/ipc.html#_version_reply for more details.
|
||
type Version struct {
|
||
Major int64 `json:"major"`
|
||
Minor int64 `json:"minor"`
|
||
Patch int64 `json:"patch"`
|
||
Variant string `json:"variant,omitempty"`
|
||
HumanReadable string `json:"human_readable"`
|
||
LoadedConfigFileName string `json:"loaded_config_file_name"`
|
||
}
|
||
|
||
// GetVersion returns i3’s version.
|
||
//
|
||
// GetVersion is supported in i3 ≥ v4.3 (2012-09-19).
|
||
func GetVersion() (Version, error) {
|
||
reply, err := roundTrip(messageTypeGetVersion, nil)
|
||
if err != nil {
|
||
return Version{}, err
|
||
}
|
||
|
||
var v Version
|
||
err = json.Unmarshal(reply.Payload, &v)
|
||
return v, err
|
||
}
|
||
|
||
// version is a lazily-initialized, possibly stale copy of i3’s GET_VERSION
|
||
// reply. Access only values which don’t change, e.g. Major, Minor.
|
||
var version Version
|
||
|
||
// versionWarning is used to only warn a single time when unsupported versions are
|
||
// detected.
|
||
var versionWarning bool
|
||
|
||
// AtLeast returns nil if i3’s major version matches major and i3’s minor
|
||
// version is at least minor or newer. Otherwise, it returns an error message
|
||
// stating i3 is too old.
|
||
func AtLeast(major int64, minor int64) error {
|
||
if major == 0 {
|
||
return fmt.Errorf("BUG: major == 0 is non-sensical. Is a lookup table entry missing?")
|
||
}
|
||
if version.Major == 0 {
|
||
var err error
|
||
version, err = GetVersion()
|
||
if err != nil {
|
||
return err
|
||
}
|
||
}
|
||
|
||
if version.Variant != "" {
|
||
if !versionWarning {
|
||
versionWarning = true
|
||
log.Printf("non standard i3 payload variant '%s' detected. Ignoring version check. This is fully unsupported.", version.Variant)
|
||
}
|
||
return nil
|
||
}
|
||
|
||
if version.Major == major && version.Minor >= minor {
|
||
return nil
|
||
}
|
||
|
||
return fmt.Errorf("i3 version too old: got %d.%d, want ≥ %d.%d", version.Major, version.Minor, major, minor)
|
||
}
|