Migrate @azure-tools/typespec-go from autorest.go into this repo

.chronus/changes/typespec-go-move-into-typespec-azure-2026-06-11-14-30-00.md

@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@azure-tools/typespec-go"
+---
+
+Move `@azure-tools/typespec-go` from `Azure/autorest.go` into `Azure/typespec-azure`. The previously-private workspace packages `@azure-tools/codegen.go`, `@azure-tools/codemodel.go`, and `@azure-tools/naming.go` are now inlined into `src/codegen`, `src/codemodel`, and `src/naming` respectively. No behavior changes for emitter consumers.

.github/actions/setup-go/action.yml

@@ -0,0 +1,21 @@
+name: Setup Go
+description: Setup Go for typespec-go package development and CI
+inputs:
+  go-version:
+    required: false
+    description: Go version for setup-go
+    default: "1.26.1"
+
+runs:
+  using: composite
+
+  steps:
+    - name: Setup Go ${{ inputs.go-version }}
+      uses: actions/setup-go@v5
+      with:
+        go-version: ${{ inputs.go-version }}
+        cache: false
+
+    - name: Log Go version
+      shell: bash
+      run: go version

.github/workflows/ci-go.yml

@@ -0,0 +1,127 @@
+name: "go / test e2e"
+
+on:
+  pull_request:
+    branches:
+      - main
+      - release/*
+    paths:
+      - "packages/typespec-go/**"
+      - ".github/workflows/ci-go.yml"
+      - ".github/actions/setup-go/**"
+  merge_group:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: "Build"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - uses: ./.github/actions/setup
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        run: pnpm turbo run --filter "@azure-tools/typespec-go..." build
+
+  test:
+    name: "Mock API Tests (Go ${{ matrix.go-version }})"
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        go-version: ["1.26.1", "1.25.8"]
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - uses: ./.github/actions/setup
+
+      - uses: ./.github/actions/setup-go
+        with:
+          go-version: ${{ matrix.go-version }}
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        run: pnpm turbo run --filter "@azure-tools/typespec-go..." build
+
+      - name: Build spector and specs
+        run: |
+          pnpm turbo run --filter "@typespec/spector..." build
+          pnpm --filter "@typespec/http-specs" exec tsc -p ./tsconfig.build.json
+          pnpm --filter "@azure-tools/azure-http-specs" exec tsc -p ./tsconfig.build.json
+
+      - name: Install Go lint tools
+        run: |
+          go install golang.org/x/tools/go/analysis/passes/shadow/cmd/shadow@latest
+          curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v2.11.4
+          echo "$(go env GOPATH)/bin" >> $GITHUB_PATH
+
+      - name: Regenerate
+        run: pnpm run regenerate
+        working-directory: packages/typespec-go
+
+      - name: Lint
+        run: pnpm run lint:go
+        working-directory: packages/typespec-go
+
+      - name: Run Go e2e tests against spector
+        run: pnpm run test:go:e2e
+        working-directory: packages/typespec-go
+
+  unit:
+    name: "Unit Tests"
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - uses: ./.github/actions/setup
+
+      - name: Install dependencies
+        run: pnpm install --filter "@azure-tools/typespec-go..."
+
+      - name: Build
+        run: pnpm turbo run --filter "@azure-tools/typespec-go..." build
+
+      - name: Test
+        run: pnpm run test:ci
+        working-directory: packages/typespec-go
+
+  docs:
+    name: "Docs Validation"
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - uses: ./.github/actions/setup
+
+      - name: Install dependencies
+        run: pnpm install --filter "@azure-tools/typespec-go..."
+
+      - name: Build
+        run: pnpm turbo run --filter "@azure-tools/typespec-go..." build
+
+      - name: Regenerate emitter docs
+        run: pnpm run regen-docs
+        working-directory: packages/typespec-go

.gitignore

@@ -225,3 +225,10 @@ packages/samples/test/output/azure/templates-contoso/setup.*
 # python emitter
 packages/typespec-python/tests/generated/**
 packages/typespec-python/alpha
+
+# go emitter
+packages/typespec-go/test/**/zz_*.go
+packages/typespec-go/test/**/go.mod
+packages/typespec-go/test/**/go.sum
+packages/typespec-go/test/**/LICENSE.txt
+packages/typespec-go/test/**/testdata

eng/config/labels.ts

@@ -31,6 +31,10 @@ export const AreaLabels = defineLabels({
     color: "957300",
     description: "Issues for @azure-tools/typespec-python emitter",
   },
+  "emitter:go": {
+    color: "957300",
+    description: "Issues for @azure-tools/typespec-go emitter",
+  },
   "emitter:typescript": {
     color: "957300",
     description: "Issues for @azure-tools/typespec-ts emitter",
@@ -67,6 +71,7 @@ export const AreaPaths: Record<keyof typeof AreaLabels, string[]> = {
   "lib:azure-resource-manager": ["packages/typespec-azure-resource-manager/"],
   "emitter:autorest": ["packages/typespec-autorest/"],
   "emitter:python": ["packages/typespec-python/"],
+  "emitter:go": ["packages/typespec-go/"],
   "emitter:typescript": ["packages/typespec-ts/"],
   "lib:tcgc": ["packages/typespec-client-generator-core/"],
   "lib:azure-http-specs": ["packages/azure-http-specs/"],

eng/pipelines/jobs/build-for-publish.yml

@@ -41,6 +41,25 @@ jobs:
           PackagePath: packages/typespec-python
           GeneratorName: "@azure-tools/typespec-python"
 
+      # Go e2e tests and spector coverage upload
+      - task: GoTool@0
+        displayName: "Use Go 1.26.1"
+        inputs:
+          version: "1.26.1"
+
+      - script: pnpm run regenerate
+        displayName: "Regenerate Go test code"
+        workingDirectory: packages/typespec-go
+
+      - script: pnpm run test:go:e2e
+        displayName: "Run Go e2e tests"
+        workingDirectory: packages/typespec-go
+
+      - template: /eng/pipelines/templates/upload-spector-coverage.yml
+        parameters:
+          PackagePath: packages/typespec-go
+          GeneratorName: "@azure-tools/typespec-go"
+
       - template: /eng/pipelines/templates/pack.yml
         parameters:
           artifactName: npm-packages-stable

packages/typespec-go/.scripts/azure-rest-api-specs.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "./azure-rest-api-specs.schema.json",
+  "_description": "Pinned commit of Azure/azure-rest-api-specs used by .scripts/sync-azure-rest-api-specs.js and tspcompile.js. To update specs, change `commit` to a newer SHA from https://github.com/Azure/azure-rest-api-specs/commits/main, then run `pnpm tspcompile`.",
+  "repository": "https://github.com/Azure/azure-rest-api-specs.git",
+  "commit": "f437f2fe14e41383b15850c619b599468333007b",
+  "sparseCheckoutPaths": [
+    "specification/apicenter/ApiCenter.Management",
+    "specification/azurelargeinstance/resource-manager/Microsoft.AzureLargeInstance/AzureLargeInstance",
+    "specification/billingbenefits/BillingBenefits.Management",
+    "specification/codesigning/CodeSigning.Management",
+    "specification/cognitiveservices/CognitiveServices.Management",
+    "specification/communitytraining/Community.Management",
+    "specification/computeschedule/ComputeSchedule.Management",
+    "specification/databasewatcher/DatabaseWatcher.Management",
+    "specification/devopsinfrastructure/Microsoft.DevOpsInfrastructure.Management",
+    "specification/hardwaresecuritymodules/resource-manager/Microsoft.HardwareSecurityModules/HardwareSecurityModules",
+    "specification/healthbot/HealthBot.Management",
+    "specification/keyvault/data-plane/Keys",
+    "specification/kubernetesruntime/KubernetesRuntime.Management",
+    "specification/loadtestservice/resource-manager/Microsoft.LoadTestService/loadtesting",
+    "specification/mongocluster/resource-manager/Microsoft.DocumentDB/MongoCluster",
+    "specification/oracle/Oracle.Database.Management",
+    "specification/storage/data-plane/BlobStorage"
+  ]
+}

packages/typespec-go/.scripts/go-test.js

@@ -0,0 +1,49 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for license information.
+//
+// Runs `go test ./...` under every directory below test/local/ that contains
+// `_test.go` files. Assumes the tsp-spector mock server is already running;
+// use `pnpm spector --start`/`--stop` (see spector.js) to manage it.
+
+import { spawnSync } from "child_process";
+import { existsSync, readdirSync, statSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = resolve(scriptDir, "..");
+const testLocal = resolve(pkgRoot, "test", "local");
+
+function findTestDirs(root) {
+  const dirs = new Set();
+  if (!existsSync(root)) return [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir)) {
+      const p = resolve(dir, entry);
+      if (statSync(p).isDirectory()) walk(p);
+      else if (entry.endsWith("_test.go")) dirs.add(dir);
+    }
+  };
+  walk(root);
+  return [...dirs].sort();
+}
+
+const dirs = findTestDirs(testLocal);
+console.log(`Discovered ${dirs.length} go test directories under ${testLocal}`);
+
+let failed = false;
+for (const dir of dirs) {
+  console.log(`\n=== go test ./... in ${dir} ===`);
+  const result = spawnSync("go", ["test", "-run", "^Test", "-v", "./..."], {
+    cwd: dir,
+    stdio: "inherit",
+  });
+  if (result.status !== 0) {
+    console.error(`go test failed in ${dir}`);
+    failed = true;
+  }
+}
+
+if (failed) {
+  process.exit(1);
+}

packages/typespec-go/.scripts/lint-go.js

@@ -0,0 +1,57 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for license information.
+//
+// Runs golangci-lint and shadow against every Go module under test/local/.
+// Expects golangci-lint and `shadow` to be available on PATH (installed by CI).
+
+import { spawnSync } from "child_process";
+import { existsSync, readdirSync, statSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = resolve(scriptDir, "..");
+const testLocal = resolve(pkgRoot, "test", "local");
+
+function findModuleDirs(root) {
+  const dirs = new Set();
+  if (!existsSync(root)) return [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir)) {
+      const p = resolve(dir, entry);
+      if (entry === "go.mod" && !statSync(p).isDirectory()) {
+        dirs.add(dir);
+        return;
+      }
+    }
+    for (const entry of readdirSync(dir)) {
+      const p = resolve(dir, entry);
+      if (statSync(p).isDirectory()) walk(p);
+    }
+  };
+  walk(root);
+  return [...dirs].sort();
+}
+
+const dirs = findModuleDirs(testLocal);
+console.log(`Linting ${dirs.length} go modules under ${testLocal}`);
+
+let failed = false;
+for (const dir of dirs) {
+  console.log(`\n=== golangci-lint in ${dir} ===`);
+  let result = spawnSync("golangci-lint", ["run", "./..."], { cwd: dir, stdio: "inherit" });
+  if (result.status !== 0) {
+    console.error(`golangci-lint failed in ${dir}`);
+    failed = true;
+  }
+  console.log(`=== shadow in ${dir} ===`);
+  result = spawnSync("shadow", ["./..."], { cwd: dir, stdio: "inherit" });
+  if (result.status !== 0) {
+    console.error(`shadow failed in ${dir}`);
+    failed = true;
+  }
+}
+
+if (failed) {
+  process.exit(1);
+}