feat: version snippets (#8)

Generate a snippet with the latest release for each major version of the
SDKs.
These variables can be imported in any MDX file.

Author: kai687

.golangci.yml

@@ -6,6 +6,12 @@ linters:
     - mnd
     - prealloc
     - testpackage
+  exclusions:
+    warn-unused: true
+    rules:
+      - path: _test\.go
+        linters:
+          - funlen
 formatters:
   enable:
     - gofmt

devbox.lock

@@ -2,8 +2,8 @@
   "lockfile_version": "1",
   "packages": {
     "github:NixOS/nixpkgs/nixpkgs-unstable": {
-      "last_modified": "2025-06-24T02:18:21Z",
-      "resolved": "github:NixOS/nixpkgs/69dfebb3d175bde602f612915c5576a41b18486b?lastModified=1750731501&narHash=sha256-Ah4qq%2BSbwMaGkuXCibyg%2BFwn00el4KmI3XFX6htfDuk%3D"
+      "last_modified": "2025-06-30T12:09:31Z",
+      "resolved": "github:NixOS/nixpkgs/b9c03fbbaf84d85bb28eee530c7e9edc4021ca1b?lastModified=1751285371&narHash=sha256-%2FhDU%2B2AUeFFu5qGHO%2FUyFMc4UG%2Fx5Cw5uXO36KGTk6c%3D"
     },
     "go-task@3.43.3": {
       "last_modified": "2025-06-20T02:24:11Z",

pkg/cmd/generate/sla/sla.go

@@ -16,17 +16,16 @@ import (
 )
 
 type Options struct {
-	DataFile string
-	Output   string
+	DataFile     string
+	Output       string
+	VersionsFile string
 }
 
 // VersionInfo represents the version information for a single version of an API client.
 type VersionInfo struct {
 	ReleaseDate string `json:"releaseDate"`
 	SlaStatus   string `json:"slaStatus"`
 	SlaEndDate  string `json:"slaEndDate,omitempty"`
-	// SupportStatus  string `json:"supportStatus"`
-	// SupportEndDate string `json:"supportEndDate,omitempty"`
 }
 
 // Version maps a version string to its version information.
@@ -66,6 +65,8 @@ func NewSlaCommand() *cobra.Command {
 	}
 
 	cmd.Flags().StringVarP(&opts.Output, "output", "o", "", "Output file")
+	cmd.Flags().
+		StringVarP(&opts.VersionsFile, "versions", "v", "", "Generate file with latest versions")
 
 	return cmd
 }
@@ -102,6 +103,18 @@ func runCommand(opts *Options) {
 	if err = renderPage(output, pageTemplate, sorted, funcMap); err != nil {
 		log.Fatalf("error: %v", err)
 	}
+
+	var versionsOutput io.Writer
+	if opts.VersionsFile == "" {
+		versionsOutput = os.Stdout
+	} else {
+		versionsOutput, err = os.Create(opts.VersionsFile)
+		if err != nil {
+			log.Fatalf("error: %v", err)
+		}
+	}
+
+	renderVersionsFile(versionsOutput, sorted)
 }
 
 // parseVersions reads a JSON file and parses it into a Clients struct.
@@ -177,3 +190,26 @@ func renderPage(
 
 	return nil
 }
+
+func renderVersionsFile(w io.Writer, data []ClientEntry) {
+	fmt.Fprintln(w, "export const sdkVersions = {")
+
+	for _, client := range data {
+		fmt.Fprintf(w, "  %s: {\n", client.Language)
+
+		seenMajors := make(map[string]bool)
+
+		for _, ver := range client.Versions {
+			major := semver.Major("v" + ver.Version)
+			if !seenMajors[major] {
+				seenMajors[major] = true
+
+				fmt.Fprintf(w, "    %s: \"%s\",\n", major, ver.Version)
+			}
+		}
+
+		fmt.Fprintln(w, "  },")
+	}
+
+	fmt.Fprintln(w, "};")
+}

pkg/cmd/generate/sla/sla_test.go

@@ -1,6 +1,7 @@
 package sla
 
 import (
+	"bytes"
 	"reflect"
 	"testing"
 )
@@ -53,3 +54,73 @@ func TestParseVersions(t *testing.T) {
 		t.Errorf("parsed mismatch.\nGot: %#v\nExpected: %#v", got, expected)
 	}
 }
+
+func TestRenderVersionsFile(t *testing.T) {
+	tests := []struct {
+		name     string
+		input    []ClientEntry
+		expected string
+	}{
+		{
+			name: "multiple majors and patches",
+			input: []ClientEntry{
+				{
+					Language: "csharp",
+					Versions: []VersionEntry{
+						{Version: "7.2.3"},
+						{Version: "7.1.0"},
+						{Version: "6.5.1"},
+						{Version: "6.4.0"},
+					},
+				},
+				{
+					Language: "dart",
+					Versions: []VersionEntry{
+						{Version: "1.3.0"},
+						{Version: "1.2.0"},
+					},
+				},
+			},
+			expected: `export const sdkVersions = {
+  csharp: {
+    v7: "7.2.3",
+    v6: "6.5.1",
+  },
+  dart: {
+    v1: "1.3.0",
+  },
+};
+`,
+		},
+		{
+			name: "single major only",
+			input: []ClientEntry{
+				{
+					Language: "go",
+					Versions: []VersionEntry{
+						{Version: "2.0.0"},
+						{Version: "2.0.0-beta"},
+					},
+				},
+			},
+			expected: `export const sdkVersions = {
+  go: {
+    v2: "2.0.0",
+  },
+};
+`,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			var buf bytes.Buffer
+
+			renderVersionsFile(&buf, tt.input)
+
+			if got := buf.String(); got != tt.expected {
+				t.Errorf("renderVersionsFile() =\n%q\nwant\n%q", got, tt.expected)
+			}
+		})
+	}
+}

pkg/cmd/generate/snippets/snippets_test.go

@@ -114,7 +114,7 @@ func TestSortLanguages(t *testing.T) {
 	}
 }
 
-func TestGenerateMarkdownSnippet(t *testing.T) { //nolint:funlen
+func TestGenerateMarkdownSnippet(t *testing.T) {
 	tests := []struct {
 		name    string
 		snippet map[string]string

pkg/cmd/generate/utils/utils_test.go

@@ -9,7 +9,7 @@ import (
 	"gopkg.in/yaml.v3"
 )
 
-func TestGetLanguageName(t *testing.T) { //nolint:funlen
+func TestGetLanguageName(t *testing.T) {
 	tests := []struct {
 		name     string
 		label    string
@@ -305,7 +305,7 @@ func mockOp(extensions *yaml.Node) v3.Operation {
 	return op
 }
 
-func TestGetAcl(t *testing.T) { //nolint:funlen
+func TestGetAcl(t *testing.T) {
 	tests := []struct {
 		name        string
 		extensions  *yaml.Node

pkg/cmd/update/cdn/cdn_test.go

@@ -10,7 +10,7 @@ import (
 	"testing"
 )
 
-func TestReadData(t *testing.T) { //nolint:funlen
+func TestReadData(t *testing.T) {
 	type want struct {
 		packages []Package
 		err      bool