Order swagger input files

tools/apiview/parsers/swagger-api-parser/SwaggerApiParser/ReadmeParser.cs

@@ -54,8 +54,8 @@ public static IEnumerable<string> GetSwaggerFilesFromReadme(string readme, strin
             readmeTag = parser.basicConfig.tag;
         }
 
-        parser.inputSwaggerFilesMap.TryGetValue(readmeTag, out InputSwaggerFiles ret);
-        return ret != null ? ret.input : new List<string>();
+        parser.inputSwaggerFilesMap.TryGetValue(readmeTag, out InputSwaggerFiles inputFiles);
+        return inputFiles?.input ?? Enumerable.Empty<string>();
     }
     private void ParseReadmeConfig()
     {
@@ -93,6 +93,8 @@ private void ParseReadmeConfig()
                 }
 
                 var tag = ReadmeParser.GetTagFromYamlArguments(argument);
+
+                inputSwaggerFiles.input?.Sort(StringComparer.InvariantCultureIgnoreCase);
                 inputSwaggerFilesMap.Add(tag, inputSwaggerFiles);
             }
         }

tools/apiview/parsers/swagger-api-parser/SwaggerApiParserTest/ReadmeParserTest.cs

@@ -72,4 +72,12 @@ public void TestGetTagFromYamlArgumentsInvalidCase()
         Assert.Equal("", result);
 
     }
+
+    [Fact]
+    public void TestOrderedInputFiles()
+    {
+        const string readmeFilePath = "./fixtures/unordered.md";
+        var inputFiles = ReadmeParser.GetSwaggerFilesFromReadme(readmeFilePath, "package-2023-02");
+        Assert.Collection(inputFiles, x => Assert.Equal("a.json", x), x => Assert.Equal("z.json", x));
+    }
 }

tools/apiview/parsers/swagger-api-parser/SwaggerApiParserTest/SwaggerApiParserTest.csproj

@@ -25,5 +25,8 @@
     <ItemGroup>
       <Content Include="fixtures/**" CopyToOutputDirectory="PreserveNewest" />
     </ItemGroup>
+    <ItemGroup>
+      <None Remove="fixtures\unordered.md" />
+    </ItemGroup>
 
 </Project>

tools/apiview/parsers/swagger-api-parser/SwaggerApiParserTest/fixtures/unordered.md

@@ -0,0 +1,42 @@
+# Unordered
+
+> see https://aka.ms/autorest
+
+This is the AutoRest configuration file for Unordered.
+
+---
+
+## Getting Started
+
+To build the SDK for ApiManagement, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:
+
+> `autorest`
+
+To see additional help and options, run:
+
+> `autorest --help`
+
+---
+
+## Configuration
+
+### Basic Information
+
+These are the global settings for the ApiManagement API.
+
+``` yaml
+title: UnorderedClient
+description: Unordered Client
+tag: package-2023-02
+```
+
+
+### Tag: package-2023-02
+
+These settings apply only when `--tag=package-2023-02` is specified on the command line.
+
+```yaml $(tag) == 'package-2023-02'
+input-file:
+  - z.json
+  - a.json
+```