git-bundle-server: add 'version' command

Add a command to report the version of the compiled bundle server
executables. The version string is set using the '-ldflags' build flag in
'go build' (specifically, setting the 'Version' string in
'cmd/utils/version.go').

In a later patch, the version will be automatically during the build process
(using 'make') with 'git describe'.

Signed-off-by: Victoria Dye <[email protected]>

Author: vdye

cmd/git-bundle-server/main.go

@@ -21,6 +21,7 @@ func all(logger log.TraceLogger) []argparse.Subcommand {
 		NewUpdateCommand(logger, container),
 		NewUpdateAllCommand(logger, container),
 		NewListCommand(logger, container),
+		NewVersionCommand(logger, container),
 		NewWebServerCommand(logger, container),
 	}
 }

cmd/git-bundle-server/version.go

@@ -0,0 +1,45 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/github/git-bundle-server/cmd/utils"
+	"github.com/github/git-bundle-server/internal/argparse"
+	"github.com/github/git-bundle-server/internal/log"
+)
+
+type versionCmd struct {
+	logger    log.TraceLogger
+	container *utils.DependencyContainer
+}
+
+func NewVersionCommand(logger log.TraceLogger, container *utils.DependencyContainer) argparse.Subcommand {
+	return &versionCmd{
+		logger:    logger,
+		container: container,
+	}
+}
+
+func (versionCmd) Name() string {
+	return "version"
+}
+
+func (versionCmd) Description() string {
+	return `
+Display the version information for the bundle server CLI.`
+}
+
+func (v *versionCmd) Run(ctx context.Context, args []string) error {
+	parser := argparse.NewArgParser(v.logger, "git-bundle-server version")
+	parser.Parse(ctx, args)
+
+	versionStr := utils.Version
+	if versionStr == "" {
+		versionStr = "<no version>"
+	}
+
+	fmt.Printf("git-bundle-server version %s\n", versionStr)
+
+	return nil
+}

cmd/utils/version.go

@@ -0,0 +1,9 @@
+package utils
+
+// The purpose of this file is to contain globally-accessible variables that
+// specify version information for the bundle server. The values of these
+// variables are set during the build process when using 'make'.
+
+// The executable's version string with no leading 'v' (e.g. "1.0.0" or
+// "1.0.1-g1a2b3c4d").
+var Version string

docs/man/git-bundle-server.adoc

@@ -53,6 +53,9 @@ the server.
 
 == COMMANDS
 
+*version*::
+  Display the version information for the bundle server CLI
+
 *init* _url_ [_route_]::
   Initialize a repository for which bundles should be served. The repository is
   cloned into a bare repo from _url_. A base bundle is created for the