Support customizing filename in M.E.ApiDescription.Server tool

src/Tools/GetDocumentInsider/src/Commands/GetDocumentCommand.cs

@@ -19,6 +19,7 @@ internal sealed class GetDocumentCommand : ProjectCommandBase
     private CommandOption _output;
     private CommandOption _openApiVersion;
     private CommandOption _documentName;
+    private CommandOption _projectNameOverride;
 
     public GetDocumentCommand(IConsole console) : base(console)
     {
@@ -32,6 +33,7 @@ public override void Configure(CommandLineApplication command)
         _output = command.Option("--output <Directory>", Resources.OutputDescription);
         _openApiVersion = command.Option("--openapi-version <Version>", Resources.OpenApiVersionDescription);
         _documentName = command.Option("--document-name <Name>", Resources.DocumentNameDescription);
+        _projectNameOverride = command.Option("--projectName-override <Name>", Resources.ProjectNameOverrideDescription);
     }
 
     protected override void Validate()
@@ -142,6 +144,7 @@ protected override int Execute()
                 DocumentName = _documentName.Value(),
                 ProjectName = ProjectName.Value(),
                 Reporter = Reporter,
+                ProjectNameOverride = _projectNameOverride.Value()
             };
 
             return new GetDocumentCommandWorker(context).Process();

src/Tools/GetDocumentInsider/src/Commands/GetDocumentCommandContext.cs

@@ -30,5 +30,10 @@ public class GetDocumentCommandContext
     // Generates all documents if not provided.
     public string DocumentName { get; set; }
 
+    //Override the default projectName
+    //By default if document name == v1 => output = projectName.json
+    //else projectName_documentName.json
+    public string ProjectNameOverride { get; set; }
+
     public IReporter Reporter { get; set; }
 }

src/Tools/GetDocumentInsider/src/Commands/GetDocumentCommandWorker.cs

@@ -279,7 +279,8 @@ private bool GetDocuments(IServiceProvider services)
                 _context.OutputDirectory,
                 generateMethod,
                 service,
-                generateWithVersionMethod);
+                generateWithVersionMethod,
+                _context.ProjectNameOverride);
             if (filePath == null)
             {
                 return false;
@@ -308,7 +309,8 @@ private string GetDocument(
         string outputDirectory,
         MethodInfo generateMethod,
         object service,
-        MethodInfo? generateWithVersionMethod)
+        MethodInfo? generateWithVersionMethod,
+        string projectNameOverride)
     {
         _reporter.WriteInformation(Resources.FormatGeneratingDocument(documentName));
 
@@ -352,7 +354,7 @@ private string GetDocument(
             return null;
         }
 
-        var filePath = GetDocumentPath(documentName, projectName, outputDirectory);
+        var filePath = GetDocumentPath(documentName, projectName, outputDirectory, projectNameOverride);
         _reporter.WriteInformation(Resources.FormatWritingDocument(documentName, filePath));
         try
         {
@@ -371,9 +373,16 @@ private string GetDocument(
         return filePath;
     }
 
-    private static string GetDocumentPath(string documentName, string projectName, string outputDirectory)
+    private static string GetDocumentPath(string documentName, string projectName, string outputDirectory, string projectNameOverride)
     {
         string path;
+
+        //Override the default projectName with the one provided
+        if (!string.IsNullOrWhiteSpace(projectNameOverride))
+        {
+            projectName = projectNameOverride;
+        }
+
         if (string.Equals(DefaultDocumentName, documentName, StringComparison.Ordinal))
         {
             // Leave default document name out of the filename.

src/Tools/GetDocumentInsider/src/Resources.resx

@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <root>
-  <!--
-    Microsoft ResX Schema
-
+  <!-- 
+    Microsoft ResX Schema 
+    
     Version 2.0
-
-    The primary goals of this format is to allow a simple XML format
-    that is mostly human readable. The generation and parsing of the
-    various data types are done through the TypeConverter classes
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
     associated with the data types.
-
+    
     Example:
-
+    
     ... ado.net/XML headers & schema ...
     <resheader name="resmimetype">text/microsoft-resx</resheader>
     <resheader name="version">2.0</resheader>
@@ -26,36 +26,36 @@
         <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
         <comment>This is a comment</comment>
     </data>
-
-    There are any number of "resheader" rows that contain simple
+                
+    There are any number of "resheader" rows that contain simple 
     name/value pairs.
-
-    Each data row contains a name, and value. The row also contains a
-    type or mimetype. Type corresponds to a .NET class that support
-    text/value conversion through the TypeConverter architecture.
-    Classes that don't support this are serialized and stored with the
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
     mimetype set.
-
-    The mimetype is used for serialized objects, and tells the
-    ResXResourceReader how to depersist the object. This is currently not
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
     extensible. For a given mimetype the value must be set accordingly:
-
-    Note - application/x-microsoft.net.object.binary.base64 is the format
-    that the ResXResourceWriter will generate, however the reader can
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
     read any of the formats listed below.
-
+    
     mimetype: application/x-microsoft.net.object.binary.base64
-    value   : The object must be serialized with
+    value   : The object must be serialized with 
             : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
             : and then encoded with base64 encoding.
-
+    
     mimetype: application/x-microsoft.net.object.soap.base64
-    value   : The object must be serialized with
+    value   : The object must be serialized with 
             : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
             : and then encoded with base64 encoding.
 
     mimetype: application/x-microsoft.net.object.bytearray.base64
-    value   : The object must be serialized into a byte array
+    value   : The object must be serialized into a byte array 
             : using a System.ComponentModel.TypeConverter
             : and then encoded with base64 encoding.
     -->
@@ -209,4 +209,7 @@
   <data name="VersionedGenerateMethod" xml:space="preserve">
     <value>Using discovered `GenerateAsync` overload with version parameter.</value>
   </data>
-</root>
+  <data name="ProjectNameOverrideDescription" xml:space="preserve">
+    <value>Custom projectName that replace the default one, used to generate OpenAPI JSON file</value>
+  </data>
+</root>

src/Tools/dotnet-getdocument/src/ProjectOptions.cs

@@ -27,6 +27,12 @@ public void Configure(CommandLineApplication command)
         Platform = command.Option("--platform <Target>", Resources.PlatformDescription);
         ProjectName = command.Option("--project <Name>", Resources.ProjectDescription);
         RuntimeFrameworkVersion = command.Option("--runtime <RUNTIME_IDENTIFIER>", Resources.RuntimeDescription);
+        command.Option("--prefix-output", Resources.PrefixDescription);
+        command.Option("--file-list <Path>", Resources.FileListDescription);
+        command.Option("--output <Directory>", Resources.OutputDescription);
+        command.Option("--openapi-version <Version>", Resources.OpenApiVersionDescription);
+        command.Option("--document-name <Name>", Resources.DocumentNameDescription);
+        command.Option("--projectName-override <Name>", Resources.ProjectNameOverrideDescription);
     }
 
     public void Validate()

src/Tools/dotnet-getdocument/src/Resources.resx

@@ -162,4 +162,19 @@
   <data name="QuietDescription" xml:space="preserve">
     <value>Suppresses all output except warnings and errors.</value>
   </data>
+  <data name="FileListDescription" xml:space="preserve">
+    <value>The path where the list of document files should be written. Required.</value>
+  </data>
+  <data name="OutputDescription" xml:space="preserve">
+    <value>The directory where the document files should be written. Required.</value>
+  </data>
+  <data name="OpenApiVersionDescription" xml:space="preserve">
+    <value>The OpenAPI spec version to use when generating the document. Optional.</value>
+  </data>
+  <data name="DocumentNameDescription" xml:space="preserve">
+    <value>The name of the OpenAPI document to generate. Optional.</value>
+  </data>
+  <data name="ProjectNameOverrideDescription" xml:space="preserve">
+    <value>Custom projectName that replace the default one, used to generate OpenAPI JSON file</value>
+  </data>
 </root>