feat: Ability to include the repository URL of a package in pubspec.yaml (#2229)

Author: brianquinlan

internal/sidekick/internal/dart/annotate.go

@@ -52,6 +52,7 @@ type modelAnnotations struct {
 	Imports             []string
 	DevDependencies     []string
 	DoNotPublish        bool
+	RepositoryURL       string
 }
 
 // HasServices returns true if the model has services.
@@ -210,6 +211,7 @@ func (annotate *annotateModel) annotateModel(options map[string]string) error {
 		partFileReference   string
 		doNotPublish        bool
 		devDependencies     = []string{}
+		repositoryURL       string
 	)
 
 	for key, definition := range options {
@@ -234,6 +236,8 @@ func (annotate *annotateModel) annotateModel(options map[string]string) error {
 				)
 			}
 			doNotPublish = value
+		case key == "repository-url":
+			repositoryURL = definition
 		case strings.HasPrefix(key, "proto:"):
 			// "proto:google.protobuf" = "package:google_cloud_protobuf/protobuf.dart"
 			keys := strings.Split(key, ":")
@@ -315,6 +319,7 @@ func (annotate *annotateModel) annotateModel(options map[string]string) error {
 		PackageDependencies: packageDependencies,
 		DevDependencies:     devDependencies,
 		DoNotPublish:        doNotPublish,
+		RepositoryURL:       repositoryURL,
 	}
 
 	model.Codec = ann

internal/sidekick/internal/dart/annotate_test.go

@@ -44,7 +44,7 @@ func TestAnnotateModel(t *testing.T) {
 func TestAnnotateModel_Options(t *testing.T) {
 	model := api.NewTestAPI([]*api.Message{}, []*api.Enum{}, []*api.Service{})
 
-	var foo = []struct {
+	var tests = []struct {
 		options map[string]string
 		verify  func(*testing.T, *annotateModel)
 	}{
@@ -84,6 +84,15 @@ func TestAnnotateModel_Options(t *testing.T) {
 				}
 			},
 		},
+		{
+			map[string]string{"repository-url": "http://example.com/repo"},
+			func(t *testing.T, am *annotateModel) {
+				codec := model.Codec.(*modelAnnotations)
+				if diff := cmp.Diff("http://example.com/repo", codec.RepositoryURL); diff != "" {
+					t.Errorf("mismatch in Codec.RepositoryURL (-want, +got)\n:%s", diff)
+				}
+			},
+		},
 		{
 			map[string]string{"package:http": "1.2.0"},
 			func(t *testing.T, am *annotateModel) {
@@ -94,7 +103,7 @@ func TestAnnotateModel_Options(t *testing.T) {
 		},
 	}
 
-	for _, tt := range foo {
+	for _, tt := range tests {
 		annotate := newAnnotateModel(model)
 		err := annotate.annotateModel(tt.options)
 		if err != nil {

internal/sidekick/internal/dart/templates/pubspec.yaml.mustache

@@ -20,6 +20,9 @@ limitations under the License.
 
 name: {{Codec.PackageName}}
 description: The Google Cloud client library for the {{{Title}}}.
+{{#Codec.RepositoryURL}}
+repository: {{Codec.RepositoryURL}}
+{{/Codec.RepositoryURL}}
 {{^Codec.DoNotPublish}}
 version: {{Codec.PackageVersion}}
 {{/Codec.DoNotPublish}}