Set user-agent and package version

The openapi-generator has a parameter to specify the default UserAgent
for the generated code so we don't have to duplicate the metal-go UA in
client projects.

The generator also supports a package version parameter, but the value
only gets written to the API.md doc, so client projects can't read the
version.  To work around this, `version.go` parses the default User-Agent
to extract the package version.

API.md

@@ -87,7 +87,7 @@ To exclude resources, and optimize response delivery, use the `exclude` query pa
 This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project.  By using the [OpenAPI-spec](https://www.openapis.org/) from a remote server, you can easily generate an API client.
 
 - API version: 1.0.0
-- Package version: 1.0.0
+- Package version: 0.7.0
 - Build package: org.openapitools.codegen.languages.GoClientCodegen
 
 ## Installation

Makefile

@@ -18,6 +18,7 @@ GIT_ORG=equinix-labs
 GIT_REPO=metal-go
 PACKAGE_PREFIX=metal
 PACKAGE_MAJOR=v1
+PACKAGE_VERSION=0.7.0
 CRI=docker # nerdctl
 
 OPENAPI_GENERATOR=${CRI} run --rm -u ${CURRENT_UID}:${CURRENT_GID} -v $(CURDIR):/local ${OPENAPI_IMAGE}
@@ -59,7 +60,9 @@ clean:
 gen:
 	${OPENAPI_GENERATOR} generate -g go \
 		--package-name ${PACKAGE_MAJOR} \
+		--http-user-agent "${GIT_REPO}/${PACKAGE_VERSION}" \
 		-p isGoSubmodule=true \
+		-p packageVersion=${PACKAGE_VERSION} \
 		--model-package types \
 		--api-package models \
 		--git-user-id ${GIT_ORG} \

metal/v1/version.go

@@ -0,0 +1,13 @@
+package v1
+
+import "strings"
+
+// Version of the metal-go package.  The version is passed in as a parameter
+// to the generator, and we parse it out of the default UserAgent at runtime
+var Version = "(unused)"
+
+func init() {
+	defaultConfig := NewConfiguration()
+	defaultUserAgent := defaultConfig.UserAgent
+	Version = defaultUserAgent[strings.Index(defaultUserAgent, "/")+1:]
+}

patches/post/20230321-version.patch

@@ -0,0 +1,19 @@
+diff --git a/metal/v1/version.go b/metal/v1/version.go
+new file mode 100644
+index 0000000..30f0c65
+--- /dev/null
++++ b/metal/v1/version.go
+@@ -0,0 +1,13 @@
++package v1
++
++import "strings"
++
++// Version of the metal-go package.  The version is passed in as a parameter
++// to the generator, and we parse it out of the default UserAgent at runtime
++var Version = "(unused)"
++
++func init() {
++	defaultConfig := NewConfiguration()
++	defaultUserAgent := defaultConfig.UserAgent
++	Version = defaultUserAgent[strings.Index(defaultUserAgent, "/")+1:]
++}