version

Documentation

Overview

Package version is a convenience utility that provides SDK consumers with a ready-to-use version command that produces apps versioning information based on flags passed at compile time.

Configure the version command

The version command can be just added to your cobra root command. At build time, the variables Name, Version, Commit, and BuildTags can be passed as build flags as shown in the following example:

go build -X github.com/cosmos/cosmos-sdk/version.Name=heimdall \
 -X github.com/cosmos/cosmos-sdk/version.ServerName=heimdalld \
 -X github.com/cosmos/cosmos-sdk/version.Version=1.0 \
 -X github.com/cosmos/cosmos-sdk/version.Commit=f0f7b7dab7e36c20b757cebce0e8f4fc5b95de60 \
 -X "github.com/cosmos/cosmos-sdk/version.BuildTags=linux darwin amd64"

Index

• Variables
• type Info
  • func NewInfo() Info
  • func (vi Info) String() string

Variables

var (
	// Name is the application's name
	Name = ""
	// ServerName is the server binary name
	ServerName = "<appd>"
	// ClientName is the client binary name
	ClientName = "<appcli>"
	// Version is the app's version string
	Version = ""
	// Commit is the app's commit hash
	Commit = ""
)

var Cmd = &cobra.Command{
	Use:   "version",
	Short: "Print the app version",
	RunE: func(_ *cobra.Command, _ []string) error {
		verInfo := NewInfo()

		if !viper.GetBool(flagLong) {
			fmt.Println(verInfo.Version)
			return nil
		}

		var bz []byte
		var err error

		switch viper.GetString(cli.OutputFlag) {
		case "json":
			bz, err = json.Marshal(verInfo)
		default:
			bz, err = yaml.Marshal(&verInfo)
		}

		if err != nil {
			return err
		}

		_, err = fmt.Println(string(bz))
		return err
	},
}

Cmd prints out the application's version information passed via build flags.

Types

type Info

type Info struct {
	Name       string `json:"name" yaml:"name"`
	ServerName string `json:"server_name" yaml:"server_name"`
	ClientName string `json:"client_name" yaml:"client_name"`
	Version    string `json:"version" yaml:"version"`
	GitCommit  string `json:"commit" yaml:"commit"`
	GoVersion  string `json:"go" yaml:"go"`
}

Info defines the application version information.

func NewInfo

func NewInfo() Info

func (Info) String

func (vi Info) String() string