Merge pull request #204 from segmentio/worktree-reported-version-fix

Fix reported version string and centralize version source of truth

Author: MichaelGHSeg

RELEASING.md

@@ -0,0 +1,23 @@
+# Releasing
+
+1. **Update the version constant** in `analytics.go`:
+   ```go
+   const Version = "x.y.z"
+   ```
+
+2. **Update `History.md`** with a summary of changes and the release date.
+
+3. Commit both files:
+   ```
+   git commit -m "Release vx.y.z"
+   ```
+
+4. Push and merge to `v3.0`.
+
+5. Tag the release from `v3.0` after the merge:
+   ```
+   git tag vx.y.z
+   git push origin vx.y.z
+   ```
+
+> **Note:** The `Version` constant in `analytics.go` is the single source of truth — it is sent in the `User-Agent` header on every API request and is automatically used by the test fixtures. No other files need to be updated.

analytics.go

@@ -14,7 +14,7 @@ import (
 )
 
 // Version of the client.
-const Version = "3.0.0"
+const Version = "3.3.0"
 
 // This interface is the main API exposed by the analytics package.
 // Values that satsify this interface are returned by the client constructors

analytics_test.go

@@ -139,7 +139,7 @@ func fixture(name string) string {
 	if err != nil {
 		panic(err)
 	}
-	return string(b)
+	return strings.ReplaceAll(string(b), `"__VERSION__"`, `"`+Version+`"`)
 }
 
 func mockId() string { return "I'm unique" }
@@ -195,32 +195,9 @@ func ExampleTrack() {
 		},
 	})
 
-	fmt.Printf("%s\n", <-body)
-	// Output:
-	// {
-	//   "batch": [
-	//     {
-	//       "event": "Download",
-	//       "messageId": "I'm unique",
-	//       "properties": {
-	//         "application": "Segment Desktop",
-	//         "platform": "osx",
-	//         "version": "1.1.0"
-	//       },
-	//       "timestamp": "2009-11-10T23:00:00Z",
-	//       "type": "track",
-	//       "userId": "123456"
-	//     }
-	//   ],
-	//   "context": {
-	//     "library": {
-	//       "name": "analytics-go",
-	//       "version": "3.0.0"
-	//     }
-	//   },
-	//   "messageId": "I'm unique",
-	//   "sentAt": "2009-11-10T23:00:00Z"
-	// }
+	if res := string(<-body); res != fixture("test-enqueue-track.json") {
+		fmt.Printf("unexpected output:\n%s\n", res)
+	}
 }
 
 func TestEnqueue(t *testing.T) {

fixtures/test-context-track.json

@@ -19,7 +19,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",

fixtures/test-enqueue-alias.json

@@ -11,7 +11,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",

fixtures/test-enqueue-group.json

@@ -11,7 +11,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",

fixtures/test-enqueue-identify.json

@@ -10,7 +10,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",

fixtures/test-enqueue-page.json

@@ -11,7 +11,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",

fixtures/test-enqueue-screen.json

@@ -11,7 +11,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",

fixtures/test-enqueue-track.json

@@ -16,7 +16,7 @@
   "context": {
     "library": {
       "name": "analytics-go",
-      "version": "3.0.0"
+      "version": "__VERSION__"
     }
   },
   "messageId": "I'm unique",