forgejo/vendor/code.gitea.io/sdk/gitea/version.go

// Copyright 2020 The Gitea Authors. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.

package gitea

import (
	"fmt"

	"github.com/hashicorp/go-version"
)

// ServerVersion returns the version of the server
func (c *Client) ServerVersion() (string, *Response, error) {
	var v = struct {
		Version string `json:"version"`
	}{}
	resp, err := c.getParsedResponse("GET", "/version", nil, nil, &v)
	return v.Version, resp, err
}

// CheckServerVersionConstraint validates that the login's server satisfies a
// given version constraint such as ">= 1.11.0+dev"
func (c *Client) CheckServerVersionConstraint(constraint string) error {
	c.versionLock.RLock()
	if c.serverVersion == nil {
		c.versionLock.RUnlock()
		if err := c.loadClientServerVersion(); err != nil {
			return err
		}
	} else {
		c.versionLock.RUnlock()
	}

	check, err := version.NewConstraint(constraint)
	if err != nil {
		return err
	}
	if !check.Check(c.serverVersion) {
		return fmt.Errorf("gitea server at %s does not satisfy version constraint %s", c.url, constraint)
	}
	return nil
}

// predefined versions only have to be parsed by library once
var (
	version1_10_0, _ = version.NewVersion("1.10.0")
	version1_11_0, _ = version.NewVersion("1.11.0")
	version1_12_0, _ = version.NewVersion("1.12.0")
	version1_13_0, _ = version.NewVersion("1.13.0")
)

// checkServerVersionGreaterThanOrEqual is internally used to speed up things and ignore issues with prerelease
func (c *Client) checkServerVersionGreaterThanOrEqual(v *version.Version) error {
	c.versionLock.RLock()
	if c.serverVersion == nil {
		c.versionLock.RUnlock()
		if err := c.loadClientServerVersion(); err != nil {
			return err
		}
	} else {
		c.versionLock.RUnlock()
	}

	if !c.serverVersion.GreaterThanOrEqual(v) {
		return fmt.Errorf("gitea server at %s is older than %s", c.url, v.Original())
	}
	return nil
}

// loadClientServerVersion init the serverVersion variable
func (c *Client) loadClientServerVersion() error {
	c.versionLock.Lock()
	defer c.versionLock.Unlock()

	raw, _, err := c.ServerVersion()
	if err != nil {
		return err
	}
	if c.serverVersion, err = version.NewVersion(raw); err != nil {
		return err
	}
	return nil
}