feat(sidekick/rust): Generate simple samples for simple RPCs (#3292)

Author: amanda-tarafa

internal/sidekick/api/model.go

@@ -362,6 +362,13 @@ func (m *Method) HasAutoPopulatedFields() bool {
 	return len(m.AutoPopulated) != 0
 }
 
+// IsSimple returns true if the method is not a streaming, pagination or LRO method.
+func (m *Method) IsSimple() bool {
+	return m.Pagination == nil &&
+		!m.ClientSideStreaming && !m.ServerSideStreaming &&
+		m.OperationInfo == nil && m.DiscoveryLro == nil
+}
+
 // PathInfo contains normalized request path information.
 type PathInfo struct {
 	// The list of bindings, including the top-level binding.

internal/sidekick/api/model_test.go

@@ -232,6 +232,56 @@ func TestPathTemplateBuilder(t *testing.T) {
 	}
 }
 
+func TestIsSimpleMethod(t *testing.T) {
+	somePagination := &Field{}
+	someOperationInfo := &OperationInfo{}
+	someDiscoverLro := &DiscoveryLro{}
+	testCases := []struct {
+		name     string
+		method   *Method
+		isSimple bool
+	}{
+		{
+			name:     "simple method",
+			method:   &Method{},
+			isSimple: true,
+		},
+		{
+			name:     "pagination method",
+			method:   &Method{Pagination: somePagination},
+			isSimple: false,
+		},
+		{
+			name:     "client streaming method",
+			method:   &Method{ClientSideStreaming: true},
+			isSimple: false,
+		},
+		{
+			name:     "server streaming method",
+			method:   &Method{ServerSideStreaming: true},
+			isSimple: false,
+		},
+		{
+			name:     "LRO method",
+			method:   &Method{OperationInfo: someOperationInfo},
+			isSimple: false,
+		},
+		{
+			name:     "Discovery LRO method",
+			method:   &Method{DiscoveryLro: someDiscoverLro},
+			isSimple: false,
+		},
+	}
+
+	for _, tc := range testCases {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := tc.method.IsSimple(); got != tc.isSimple {
+				t.Errorf("IsSimple() = %v, want %v", got, tc.isSimple)
+			}
+		})
+	}
+}
+
 func TestFieldTypePredicates(t *testing.T) {
 	type TestCase struct {
 		field    *Field

internal/sidekick/rust/templates/common/client_method_preamble.mustache

@@ -28,6 +28,7 @@ limitations under the License.
 /// [user guide]: https://googleapis.github.io/google-cloud-rust/
 /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
 {{/OperationInfo}}
+{{> /templates/common/client_method_samples/client_method_sample}}
 {{#Deprecated}}
 #[deprecated]
 {{/Deprecated}}

internal/sidekick/rust/templates/common/client_method_samples/builder_fields.mustache

@@ -0,0 +1,16 @@
+{{!
+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.
+}}
+///         /* set fields */

internal/sidekick/rust/templates/common/client_method_samples/client_method_sample.mustache

@@ -0,0 +1,42 @@
+{{!
+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.
+}}
+{{#IsSimple}}
+///
+/// # Example
+/// ```
+/// # use {{Service.Model.Codec.PackageNamespace}}::client::{{Service.Codec.Name}};
+/// async fn sample(
+{{> /templates/common/client_method_samples/parameters}}
+/// ) -> gax::Result<()> {
+{{#ReturnsEmpty}}
+///     client
+///         .{{Codec.Name}}()
+{{> /templates/common/client_method_samples/builder_fields}}
+///         .send()
+///         .await?;
+{{/ReturnsEmpty}}
+{{^ReturnsEmpty}}
+///     let response = client
+///         .{{Codec.Name}}()
+{{> /templates/common/client_method_samples/builder_fields}}
+///         .send()
+///         .await?;
+///     println!("response {:?}", response);
+{{/ReturnsEmpty}}
+///     Ok(())
+/// }
+/// ```
+{{/IsSimple}}

internal/sidekick/rust/templates/common/client_method_samples/parameters.mustache

@@ -0,0 +1,16 @@
+{{!
+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.
+}}
+///    client: &{{Service.Codec.Name}}