Merging snippet generation logic into OneDrive/apidoctor (#59)

* Snippet generations running on pipelines

* Add before checking for changes

* Handling exception tests

* Updates to include sdk documentation links into docs

* Updates to include header to show auto-generated files in snippet generation.

* Reworks Snippet injection to around the http tab section

* Makes PR title and commit message parameters and enables tabs renaming

* Try it updates

* Fix locale and only dump new files

* Tiny fix

* Fix runs

* Update apidoctor to consume snippet generation command line tool instead of HTTP endpoint (#1)

* add skip-publishing-changes flag to skip creating pull request upon generation

* integrate snippet generator tool

* consider the version information

* apply fixes from generate-snippets branch

* remove Github helper

* clean up command line options

* remove unused git commands, make GitHelper closer to that of master's

* add summary tags

* fix static method call

* add custom metadata path

* Fix broken test

* Update ApiDoctor.Validation/Http/HttpParser.cs

Co-authored-by: Vincent Biret <[email protected]>

Co-authored-by: Andrew Omondi <[email protected]>
Co-authored-by: Andrew Omondi <[email protected]>
Co-authored-by: Andrew Omondi <ApiDoctor>
Co-authored-by: Eastman <[email protected]>
Co-authored-by: Andrew Omondi <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

ApiDoctor.Console/ApiDoctor.ConsoleApp.csproj

@@ -13,6 +13,7 @@
     <FileAlignment>512</FileAlignment>
     <SolutionDir Condition="$(SolutionDir) == '' Or $(SolutionDir) == '*Undefined*'">..\</SolutionDir>
     <RestorePackages>true</RestorePackages>
+    <IsWebBootstrapper>false</IsWebBootstrapper>
     <PublishUrl>publish\</PublishUrl>
     <Install>true</Install>
     <InstallFrom>Disk</InstallFrom>
@@ -25,7 +26,6 @@
     <MapFileExtensions>true</MapFileExtensions>
     <ApplicationRevision>0</ApplicationRevision>
     <ApplicationVersion>1.0.0.%2a</ApplicationVersion>
-    <IsWebBootstrapper>false</IsWebBootstrapper>
     <UseApplicationTrust>false</UseApplicationTrust>
     <BootstrapperEnabled>true</BootstrapperEnabled>
   </PropertyGroup>
@@ -78,6 +78,8 @@
     </Reference>
     <Reference Include="System" />
     <Reference Include="System.Core" />
+    <Reference Include="System.Net.Http" />
+    <Reference Include="System.Web" />
     <Reference Include="System.Xml.Linq" />
     <Reference Include="System.Data.DataSetExtensions" />
     <Reference Include="Microsoft.CSharp" />

ApiDoctor.Console/CommandLineOptions.cs

@@ -50,6 +50,7 @@ class CommandLineOptions
         public const string VerbPublishMetadata = "publish-edmx";
 
         public const string VerbGenerateDocs = "generate-docs";
+        public const string VerbGenerateSnippets = "generate-snippets";
 
         [VerbOption(VerbPrint, HelpText = "Print files, resources, and methods discovered in the documentation.")]
         public PrintOptions PrintVerbOptions { get; set; }
@@ -81,6 +82,9 @@ class CommandLineOptions
         [VerbOption(VerbGenerateDocs, HelpText = "Generate documentation from an CSDL model")]
         public GenerateDocsOptions GenerateDocsVerb { get; set; }
 
+        [VerbOption(VerbGenerateSnippets, HelpText = "Generate code snippets from requests in documentation")]
+        public GenerateSnippetsOptions GenerateSnippetsVerb { get; set; }
+
         [VerbOption(VerbAbout, HelpText = "Print about information for this application.")]
         public BaseOptions AboutVerb { get; set; }
 
@@ -620,4 +624,16 @@ class GenerateDocsOptions : CheckMetadataOptions
         [Option("resource-template", HelpText = "Specifies the path to a mustache template file to use for generating documentation for resources (complex and entity types)", Required = false)]
         public string ResourceTemplateFile { get; set; }
     }
+
+    class GenerateSnippetsOptions : BasicCheckOptions
+    {
+        [Option("snippet-generator-path", HelpText = "Full Path to the snippet generator url", Required = true)]
+        public string SnippetGeneratorPath { get; set; }
+
+        [Option("lang", HelpText = "The programming languages for snippet generation(comma separated list)", Required = true)]
+        public string Languages { get; set; }
+
+        [Option("custom-metadata-path", HelpText = "Path to custom metadata that snippet generation can consume", Required = false)]
+        public string CustomMetadataPath { get; set; }
+    }
 }

ApiDoctor.Console/GitHelper.cs

@@ -1,4 +1,4 @@
-/*
+/*
  * API Doctor
  * Copyright (c) Microsoft Corporation
  * All rights reserved. 
@@ -96,16 +96,18 @@ public static string FindGitLocation()
 
         private static string RunCommand(string executable, string arguments, string workingDirectory = null)
         {
-            ProcessStartInfo parameters = new ProcessStartInfo();
-            parameters.CreateNoWindow = true;
-            parameters.UseShellExecute = false;
-            parameters.RedirectStandardError = true;
-            parameters.RedirectStandardOutput = true;
-            parameters.FileName = executable;
-            parameters.Arguments = arguments;
-            if (null != workingDirectory)
-            parameters.WorkingDirectory = workingDirectory;
+            ProcessStartInfo parameters = new ProcessStartInfo
+            {
+                CreateNoWindow = true,
+                UseShellExecute = false,
+                RedirectStandardError = true,
+                RedirectStandardOutput = true,
+                FileName = executable,
+                Arguments = arguments
+            };
 
+            if (null != workingDirectory)
+                parameters.WorkingDirectory = workingDirectory;
 
             var p = Process.Start(parameters);
 
@@ -116,6 +118,8 @@ private static string RunCommand(string executable, string arguments, string wor
                 sb.AppendLine(currentLine);
             }
 
+            p.WaitForExit();
+
             return sb.ToString();
 
         }