Handle ambiguity

src/AutoRest.CSharp/LowLevel/Output/OperationMethodChainBuilder.cs

@@ -118,7 +118,14 @@ private bool IsConvenienceMethodMeaningful()
 
         private bool HasAmbiguityBetweenProtocolAndConvenience()
         {
-            return _orderedParameters.Where(parameter => parameter.Convenience != KnownParameters.CancellationTokenParameter).All(parameter => IsParameterTypeHasValueOverlap(parameter.Convenience, parameter.Protocol));
+            var userDefinedParameters = _orderedParameters.Where(parameter => parameter.Convenience != KnownParameters.CancellationTokenParameter);
+            int protocolRequired = userDefinedParameters.Select(p => p.Protocol).WhereNotNull().Where(p => !p.IsOptionalInSignature).Count();
+            int convenienceRequired = userDefinedParameters.Select(p => p.Convenience).WhereNotNull().Where(p => !p.IsOptionalInSignature).Count();
+            if (protocolRequired != convenienceRequired)
+            {
+                return false;
+            }
+            return userDefinedParameters.Where(p => p.Protocol != null && !p.Protocol.IsOptionalInSignature).All(parameter => IsParameterTypeSame(parameter.Convenience, parameter.Protocol));
         }
 
         private bool ShouldRequestContextOptional()
@@ -150,21 +157,6 @@ private bool IsParameterTypeSame(Parameter? first, Parameter? second)
             return object.Equals(first?.Type, second?.Type);
         }
 
-        private bool IsParameterTypeHasValueOverlap(Parameter? first, Parameter? second)
-        {
-            if (IsParameterTypeSame(first, second))
-            {
-                return true;
-            }
-
-            if (first != null && second != null && first.Type.IsNullable && second.Type.IsNullable)
-            {
-                return true;
-            }
-
-            return false;
-        }
-
         private ReturnTypeChain BuildReturnTypes()
         {
             var operationBodyTypes = Operation.Responses.Where(r => !r.IsErrorResponse).Select(r => r.BodyType).Distinct().ToArray();

test/AutoRest.TestServer.Tests/ConvenienceMethodTests.cs

@@ -99,8 +99,8 @@ public void ProtocolRequiredQueryScenario()
         [Test]
         public void ProtocolOptionalModelScenario()
         {
-            var protocolInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ProtocolOptionalModel");
-            var convenienceInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ProtocolOptionalModelValue");
+            var protocolInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ProtocolOptionalModel", new[] { typeof(RequestContent), typeof(RequestContext) });
+            var convenienceInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ProtocolOptionalModel", new[] { typeof(Model), typeof(CancellationToken) });
             Assert.AreEqual(true, protocolInUpdate.GetParameters().Last().IsOptional);
             Assert.AreEqual(false, protocolInUpdate.GetParameters().First().IsOptional); // This is RequestContent, which is actually optional.
             Assert.AreEqual(true, convenienceInUpdate.GetParameters().First().IsOptional);
@@ -165,8 +165,8 @@ public void ConvenienceRequiredQueryWithRequiredScenario()
         [Test]
         public void ConvenienceOptionalModelWithOptionalScenario()
         {
-            var protocolInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ConvenienceOptionalModelWithOptional");
-            var convenienceInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ConvenienceOptionalModelWithOptionalValue");
+            var protocolInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ConvenienceOptionalModelWithOptional", new[] { typeof(RequestContent), typeof(RequestContext) });
+            var convenienceInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ConvenienceOptionalModelWithOptional", new[] { typeof(Model), typeof(CancellationToken) });
             Assert.AreEqual(true, protocolInUpdate.GetParameters().Last().IsOptional);
             Assert.AreEqual(false, protocolInUpdate.GetParameters().First().IsOptional); // This is RequestContent, which is actually optional.
             Assert.AreEqual(true, convenienceInUpdate.GetParameters().First().IsOptional);
@@ -189,7 +189,7 @@ public void ConvenienceOptionalModelWithRequiredScenario()
         {
             var protocolInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ConvenienceOptionalModelWithRequired", new[] { typeof(RequestContent), typeof(RequestContext) });
             var convenienceInUpdate = typeof(ConvenienceInCadlClient).GetMethod("ConvenienceOptionalModelWithRequired", new[] { typeof(Model), typeof(CancellationToken) });
-            Assert.AreEqual(false, protocolInUpdate.GetParameters().Last().IsOptional);
+            Assert.AreEqual(true, protocolInUpdate.GetParameters().Last().IsOptional);
             Assert.AreEqual(false, protocolInUpdate.GetParameters().First().IsOptional); // This is RequestContent, which is actually optional.
             Assert.AreEqual(true, convenienceInUpdate.GetParameters().First().IsOptional);
         }
@@ -232,7 +232,7 @@ public void NoConvenienceRequiredBodyScenario()
         public void NoConvenienceOptionalBodyScenario()
         {
             var protocolInUpdate = typeof(ConvenienceInCadlClient).GetMethod("NoConvenienceOptionalBody");
-            Assert.AreEqual(false, protocolInUpdate.GetParameters().Last().IsOptional);
+            Assert.AreEqual(true, protocolInUpdate.GetParameters().Last().IsOptional);
         }
 
         [Test]

test/AutoRest.TestServerLowLevel.Tests/LowLevel/ParameterSequenceTests.cs

@@ -17,7 +17,7 @@ public class ParameterSequenceTests
     {
         [TestCase(typeof(ParametersLowlevelClient), "OptionalPathParameters", new Type[] { typeof(int), typeof(string), typeof(int), typeof(RequestContext) }, new string[] { "id", "name", "skip", "context" }, new bool[] { false, false, false, true })]
         [TestCase(typeof(ParametersLowlevelClient), "OptionalPathParametersWithMixedSequence", new Type[] { typeof(int), typeof(string), typeof(int), typeof(RequestContext) }, new string[] { "id", "name", "skip", "context" }, new bool[] { false, false, false, true })]
-        [TestCase(typeof(ParametersLowlevelClient), "OptionalPathBodyParametersWithMixedSequence", new Type[] { typeof(int), typeof(string), typeof(int), typeof(int), typeof(RequestContent), typeof(int), typeof(RequestContext) }, new string[] { "id", "name", "skip", "max", "content", "top", "context" }, new bool[] { false, false, false, false, false, false, false })]
+        [TestCase(typeof(ParametersLowlevelClient), "OptionalPathBodyParametersWithMixedSequence", new Type[] { typeof(int), typeof(string), typeof(int), typeof(int), typeof(RequestContent), typeof(int), typeof(RequestContext) }, new string[] { "id", "name", "skip", "max", "content", "top", "context" }, new bool[] { false, false, false, false, false, true, true })]
         [TestCase(typeof(ParametersCadlClient), "Operation", new Type[] { typeof(int), typeof(int), typeof(CancellationToken) }, new string[] { "start", "end", "cancellationToken" }, new bool[] { false, true, true })]
         [TestCase(typeof(ParametersCadlClient), "Operation", new Type[] { typeof(int), typeof(int), typeof(RequestContext) }, new string[] { "start", "end", "context" }, new bool[] { false, false, false })]
         [TestCase(typeof(ParametersCadlClient), "Operation2", new Type[] { typeof(int), typeof(int), typeof(CancellationToken) }, new string[] { "end", "start", "cancellationToken" }, new bool[] { false, true, true })]

test/AutoRest.TestServerLowLevel.Tests/RequestContextAllOptionalTests.cs

@@ -50,7 +50,7 @@ public void RequestBodyResponseBody()
             Assert.AreEqual(parameters[0].ParameterType, typeof(RequestContent));
             Assert.AreEqual(parameters[0].IsOptional, false);
             Assert.AreEqual(parameters[1].ParameterType, typeof(RequestContext));
-            Assert.AreEqual(parameters[1].IsOptional, false);
+            Assert.AreEqual(parameters[1].IsOptional, true);
         }
 
         [Test]
@@ -76,7 +76,7 @@ public void RequestBodyNoResponseBody()
             Assert.AreEqual(parameters[0].ParameterType, typeof(RequestContent));
             Assert.AreEqual(parameters[0].IsOptional, false);
             Assert.AreEqual(parameters[1].ParameterType, typeof(RequestContext));
-            Assert.AreEqual(parameters[1].IsOptional, false);
+            Assert.AreEqual(parameters[1].IsOptional, true);
         }
     }
 }

test/TestProjects/Accessibility-LowLevel-NoAuth/src/Generated/Docs/AccessibilityClient.xml

@@ -3,26 +3,26 @@
   <members>
     <member name="OperationAsync(RequestContent,RequestContext)">
 <example>
-This sample shows how to call OperationAsync with required parameters and request content.
+This sample shows how to call OperationAsync with required request content.
 <code><![CDATA[
 var client = new AccessibilityClient();
 
 var data = "<String>";
 
-Response response = await client.OperationAsync(RequestContent.Create(data), new RequestContext());
+Response response = await client.OperationAsync(RequestContent.Create(data));
 Console.WriteLine(response.Status);
 ]]></code>
 </example>
     </member>
     <member name="Operation(RequestContent,RequestContext)">
 <example>
-This sample shows how to call Operation with required parameters and request content.
+This sample shows how to call Operation with required request content.
 <code><![CDATA[
 var client = new AccessibilityClient();
 
 var data = "<String>";
 
-Response response = client.Operation(RequestContent.Create(data), new RequestContext());
+Response response = client.Operation(RequestContent.Create(data));
 Console.WriteLine(response.Status);
 ]]></code>
 </example>

test/TestProjects/Accessibility-LowLevel-NoAuth/tests/Generated/Samples/Samples_AccessibilityClient.cs

@@ -27,7 +27,7 @@ public void Example_Operation()
 
             var data = "<String>";
 
-            Response response = client.Operation(RequestContent.Create(data), new RequestContext());
+            Response response = client.Operation(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
 
@@ -39,7 +39,7 @@ public void Example_Operation_AllParameters()
 
             var data = "<String>";
 
-            Response response = client.Operation(RequestContent.Create(data), new RequestContext());
+            Response response = client.Operation(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
 
@@ -51,7 +51,7 @@ public async Task Example_Operation_Async()
 
             var data = "<String>";
 
-            Response response = await client.OperationAsync(RequestContent.Create(data), new RequestContext());
+            Response response = await client.OperationAsync(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
 
@@ -63,7 +63,7 @@ public async Task Example_Operation_AllParameters_Async()
 
             var data = "<String>";
 
-            Response response = await client.OperationAsync(RequestContent.Create(data), new RequestContext());
+            Response response = await client.OperationAsync(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
     }

test/TestProjects/Accessibility-LowLevel-TokenAuth/src/Generated/Docs/AccessibilityClient.xml

@@ -3,28 +3,28 @@
   <members>
     <member name="OperationAsync(RequestContent,RequestContext)">
 <example>
-This sample shows how to call OperationAsync with required parameters and request content.
+This sample shows how to call OperationAsync with required request content.
 <code><![CDATA[
 var credential = new DefaultAzureCredential();
 var client = new AccessibilityClient(credential);
 
 var data = "<String>";
 
-Response response = await client.OperationAsync(RequestContent.Create(data), new RequestContext());
+Response response = await client.OperationAsync(RequestContent.Create(data));
 Console.WriteLine(response.Status);
 ]]></code>
 </example>
     </member>
     <member name="Operation(RequestContent,RequestContext)">
 <example>
-This sample shows how to call Operation with required parameters and request content.
+This sample shows how to call Operation with required request content.
 <code><![CDATA[
 var credential = new DefaultAzureCredential();
 var client = new AccessibilityClient(credential);
 
 var data = "<String>";
 
-Response response = client.Operation(RequestContent.Create(data), new RequestContext());
+Response response = client.Operation(RequestContent.Create(data));
 Console.WriteLine(response.Status);
 ]]></code>
 </example>

test/TestProjects/Accessibility-LowLevel-TokenAuth/tests/Generated/Samples/Samples_AccessibilityClient.cs

@@ -28,7 +28,7 @@ public void Example_Operation()
 
             var data = "<String>";
 
-            Response response = client.Operation(RequestContent.Create(data), new RequestContext());
+            Response response = client.Operation(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
 
@@ -41,7 +41,7 @@ public void Example_Operation_AllParameters()
 
             var data = "<String>";
 
-            Response response = client.Operation(RequestContent.Create(data), new RequestContext());
+            Response response = client.Operation(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
 
@@ -54,7 +54,7 @@ public async Task Example_Operation_Async()
 
             var data = "<String>";
 
-            Response response = await client.OperationAsync(RequestContent.Create(data), new RequestContext());
+            Response response = await client.OperationAsync(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
 
@@ -67,7 +67,7 @@ public async Task Example_Operation_AllParameters_Async()
 
             var data = "<String>";
 
-            Response response = await client.OperationAsync(RequestContent.Create(data), new RequestContext());
+            Response response = await client.OperationAsync(RequestContent.Create(data));
             Console.WriteLine(response.Status);
         }
     }