Move VERSION to top-level package (webrpc#169)

Author: VojtechVitek

.github/workflows/.goreleaser.yml

@@ -13,7 +13,7 @@ builds:
       - amd64
       - arm64
     ldflags:
-      - -s -w -X github.com/webrpc/webrpc/gen.VERSION=v{{.Version}}
+      - -s -w -X github.com/webrpc/webrpc.VERSION=v{{.Version}}
   - id: webrpc-test
     main: ./cmd/webrpc-test
     binary: webrpc-test
@@ -25,7 +25,7 @@ builds:
       - amd64
       - arm64
     ldflags:
-      - -s -w -X github.com/webrpc/webrpc/gen.VERSION=v{{.Version}}
+      - -s -w -X github.com/webrpc/webrpc.VERSION=v{{.Version}}
 
 archives:
   - id: webrpc-gen
@@ -59,7 +59,7 @@ release:
 
     ## Build from source
     ```
-    go install -ldflags="-s -w -X github.com/webrpc/webrpc/gen.VERSION=v{{.Version}}" github.com/webrpc/webrpc/cmd/webrpc-gen@v{{.Version}}
+    go install -ldflags="-s -w -X github.com/webrpc/webrpc.VERSION=v{{.Version}}" github.com/webrpc/webrpc/cmd/webrpc-gen@v{{.Version}}
     ```
 
     ## Download binaries

Dockerfile

@@ -9,7 +9,7 @@ RUN apk add --update git
 ADD ./ /src
 
 WORKDIR /src
-RUN go build -ldflags="-s -w -X github.com/webrpc/webrpc/gen.VERSION=${VERSION}" -o /usr/bin/webrpc-gen ./cmd/webrpc-gen
+RUN go build -ldflags="-s -w -X github.com/webrpc/webrpc.VERSION=${VERSION}" -o /usr/bin/webrpc-gen ./cmd/webrpc-gen
 
 # -----------------------------------------------------------------
 # Runner

cmd/webrpc-gen/main.go

@@ -16,7 +16,7 @@ import (
 var flags = flag.NewFlagSet("webrpc-gen", flag.ExitOnError)
 
 func main() {
-	versionFlag := flags.Bool("version", false, "print webrpc version and exit")
+	versionFlag := flags.Bool("version", false, "print version and exit")
 	schemaFlag := flags.String("schema", "", "webrpc schema file (required)")
 	targetFlag := flags.String("target", "", "target generator (required), ie. golang or [email protected]")
 	outFlag := flags.String("out", "", "generated output file, default: stdout")
@@ -51,7 +51,7 @@ func main() {
 	flags.Parse(cliFlags)
 
 	if *versionFlag {
-		fmt.Printf("%s %s\n", flags.Name(), gen.VERSION)
+		fmt.Println("webrpc-gen", webrpc.VERSION)
 		os.Exit(0)
 	}
 
@@ -119,7 +119,7 @@ func main() {
 	fmt.Println("=======================================")
 	fmt.Println("|      webrpc generated summary       |")
 	fmt.Println("=======================================")
-	fmt.Println(" webrpc-gen version :", gen.VERSION)
+	fmt.Println(" webrpc-gen version :", webrpc.VERSION)
 	fmt.Println(" target             :", genOutput.TmplVersion)
 	if !genOutput.IsLocal {
 		fmt.Println(" target cache       :", genOutput.TmplDir)

cmd/webrpc-test/main.go

@@ -9,14 +9,16 @@ import (
 	"os"
 	"time"
 
+	"github.com/webrpc/webrpc"
 	"github.com/webrpc/webrpc/tests/client"
 	"github.com/webrpc/webrpc/tests/server"
 )
 
 var (
-	flags      = flag.NewFlagSet("webrpc-test", flag.ContinueOnError)
-	clientFlag = flags.Bool("client", false, "client mode")
-	serverFlag = flags.Bool("server", false, "server mode")
+	flags       = flag.NewFlagSet("webrpc-test", flag.ContinueOnError)
+	clientFlag  = flags.Bool("client", false, "client mode")
+	serverFlag  = flags.Bool("server", false, "server mode")
+	versionFlag = flags.Bool("version", false, "print version and exit")
 
 	// -client
 	clientFlags = flag.NewFlagSet("webrpc-test -client", flag.ExitOnError)
@@ -35,6 +37,12 @@ func main() {
 	}
 
 	_ = flags.Parse(os.Args[1:2])
+
+	if *versionFlag {
+		fmt.Println("webrpc-test", webrpc.VERSION)
+		os.Exit(0)
+	}
+
 	if !*serverFlag && !*clientFlag {
 		fmt.Fprintf(os.Stderr, "-server or -client flag is required\n")
 		os.Exit(1)

gen/gen.go

@@ -7,6 +7,7 @@ import (
 	"path/filepath"
 	"strings"
 
+	"github.com/webrpc/webrpc"
 	"github.com/webrpc/webrpc/schema"
 )
 
@@ -49,7 +50,7 @@ func Generate(proto *schema.WebRPCSchema, target string, config *Config) (*GenOu
 	}{
 		proto,
 		schemaHash,
-		VERSION,
+		webrpc.VERSION,
 		getWebrpcGenCommand(),
 		target,
 		config.TemplateOptions,

gen/version.go

@@ -0,0 +1,12 @@
+package webrpc
+
+// VERSION defines version of webrpc tools, such as webrpc-gen.
+//
+// Please update major/minor version by hand when changing webrpc-gen
+// Template Functions API or when making any backward-incompatible changes.
+// The patch value is automatically updated with the latest git tag in CI.
+//
+// Available as {{.WebrpcGenVersion}} in generator templates. Templates can
+// check against {{.WebrpcGenVersion}} to require minimal major/minor version
+// to guarantees certain Template functions API.
+var VERSION = "v0.8.x-dev"