feat(internal/automation): refactor publish-release command (#2814)

Add `publish-release` command in automation package so we can auto
generate documentation.

For #2416

Author: JoeWang1127

cmd/automation/doc.go

@@ -25,5 +25,19 @@ Usage:
 	librarian <command> [arguments]
 
 The commands are:
+
+# publish-release
+
+The publish-release command runs a Cloud Build job to create a tag on a merged release pull
+request.
+
+Usage:
+
+	automation publish-release [flags]
+
+Flags:
+
+	-project string
+	  	Google Cloud Platform project ID (default "cloud-sdk-librarian-prod")
 */
 package main

internal/automation/automation.go

@@ -0,0 +1,52 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//	https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package automation
+
+import (
+	"context"
+
+	"github.com/googleapis/librarian/internal/cli"
+)
+
+func newAutomationCommand() *cli.Command {
+	cmd := &cli.Command{
+		Short:     "automation manages Cloud Build resources to run Librarian CLI.",
+		UsageLine: "automation <command> [arguments]",
+		Long:      "Automation manages Cloud Build resources to run Librarian CLI.",
+		Commands: []*cli.Command{
+			newCmdPublishRelease(),
+		},
+	}
+
+	cmd.Init()
+	return cmd
+}
+
+func newCmdPublishRelease() *cli.Command {
+	cmdPublishRelease := &cli.Command{
+		Short:     "publish-release",
+		UsageLine: "automation publish-release [flags]",
+		Long:      publishLongHelp,
+		Action: func(ctx context.Context, cmd *cli.Command) error {
+			runner := newPublishRunner(cmd.Config)
+			return runner.run(ctx)
+		},
+	}
+
+	cmdPublishRelease.Init()
+	addFlagProject(cmdPublishRelease.Flags, cmdPublishRelease.Config)
+
+	return cmdPublishRelease
+}

internal/automation/cli.go

@@ -27,6 +27,11 @@ var runCommandFn = RunCommand
 
 // Run parses the command line arguments and triggers the specified command.
 func Run(ctx context.Context, args []string) error {
+	if len(args) == 0 || args[0] == publishCmdName {
+		cmd := newAutomationCommand()
+		return cmd.Run(ctx, args)
+	}
+
 	options, err := parseFlags(args)
 	if err != nil {
 		slog.Error("error parsing command", slog.Any("err", err))

internal/automation/flags.go

@@ -0,0 +1,25 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//	https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package automation
+
+import (
+	"flag"
+
+	"github.com/googleapis/librarian/internal/config"
+)
+
+func addFlagProject(fs *flag.FlagSet, cfg *config.Config) {
+	fs.StringVar(&cfg.Project, "project", "cloud-sdk-librarian-prod", `Google Cloud Platform project ID`)
+}

internal/automation/help.go

@@ -0,0 +1,20 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//	https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package automation
+
+const (
+	publishLongHelp = `The publish-release command runs a Cloud Build job to create a tag on a merged release pull
+request.`
+)

internal/automation/publish_release.go

@@ -0,0 +1,40 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//	https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package automation
+
+import (
+	"context"
+
+	"github.com/googleapis/librarian/internal/config"
+)
+
+const (
+	publishCmdName = "publish-release"
+)
+
+type publishRunner struct {
+	projectID string
+	push      bool
+}
+
+func newPublishRunner(cfg *config.Config) *publishRunner {
+	return &publishRunner{
+		projectID: cfg.Project,
+	}
+}
+
+func (r *publishRunner) run(ctx context.Context) error {
+	return runCommandFn(ctx, publishCmdName, r.projectID, r.push, false)
+}

internal/automation/publish_release_test.go

@@ -0,0 +1,74 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//	https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package automation
+
+import (
+	"context"
+	"errors"
+	"testing"
+
+	"github.com/googleapis/librarian/internal/config"
+)
+
+func TestNewPublishRunner(t *testing.T) {
+	t.Parallel()
+	for _, test := range []struct {
+		name string
+		cfg  *config.Config
+	}{
+		{
+			name: "create_a_runner",
+			cfg: &config.Config{
+				Project: "example-project",
+			},
+		},
+	} {
+		t.Run(test.name, func(t *testing.T) {
+			t.Parallel()
+			runner := newPublishRunner(test.cfg)
+			if runner.projectID != test.cfg.Project {
+				t.Errorf("newPublishRunner() projectID is not set")
+			}
+		})
+	}
+}
+
+func TestPublishRunnerRun(t *testing.T) {
+	t.Parallel()
+	tests := []struct {
+		name          string
+		args          []string
+		runCommandErr error
+		wantErr       bool
+	}{
+		{
+			name:          "error from RunCommand",
+			runCommandErr: errors.New("run command failed"),
+			wantErr:       true,
+		},
+	}
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+			t.Parallel()
+			runCommandFn = func(ctx context.Context, command string, projectId string, push bool, build bool) error {
+				return test.runCommandErr
+			}
+			runner := &publishRunner{}
+			if err := runner.run(t.Context()); (err != nil) != test.wantErr {
+				t.Errorf("run() error = %v, wantErr %v", err, test.wantErr)
+			}
+		})
+	}
+}

internal/automation/repositories.go

@@ -58,7 +58,7 @@ func (c *RepositoryConfig) GitURL() (string, error) {
 	return c.FullName, nil
 }
 
-// Validate checks the the RepositoryConfig is valid.
+// Validate checks the RepositoryConfig is valid.
 func (c *RepositoryConfig) Validate() error {
 	if c.FullName == "" && c.Name == "" {
 		return fmt.Errorf("name or full name is required")
@@ -77,7 +77,7 @@ func (c *RepositoryConfig) Validate() error {
 	return nil
 }
 
-// Validate checks the the RepositoriesConfig is valid.
+// Validate checks the RepositoriesConfig is valid.
 func (c *RepositoriesConfig) Validate() error {
 	for i, r := range c.Repositories {
 		err := r.Validate()

internal/config/config.go

@@ -194,6 +194,9 @@ type Config struct {
 	// Requires the --library flag to be specified.
 	LibraryVersion string
 
+	// Project is the ID of the Google Cloud project to use.
+	Project string
+
 	// PullRequest to target and operate one in the context of a release.
 	//
 	// The pull request should be in the format `https://github.com/{owner}/{repo}/pull/{number}`.