From d987650bd4cce096e30a23b70574f8c6fd01b2ab Mon Sep 17 00:00:00 2001
From: Paul Reichelt <paul.reichelt@outlook.com>
Date: Tue, 29 Mar 2016 16:56:29 +0200
Subject: [PATCH] first working version

---
 ReleaseNotes.md                               |  2 +-
 src/Cake.DocFx/Cake.DocFx.csproj              | 14 ++++
 src/Cake.DocFx/DocFxAliases.cs                | 82 +++++++++++++++++++
 src/Cake.DocFx/DocFxTool.cs                   | 35 ++++++++
 src/Cake.DocFx/Helper/Contract.cs             | 18 ++++
 .../Metadata/DocFxMetadataRunner.cs           | 40 +++++++++
 .../Metadata/DocFxMetadataSettings.cs         | 30 +++++++
 src/Cake.DocFx/Properties/AssemblyInfo.cs     |  6 +-
 src/Cake.DocFx/packages.config                |  4 +
 .../Cake.DocFx.Tests/Cake.DocFx.Tests.csproj  |  7 ++
 tests/Cake.DocFx.Tests/packages.config        |  4 +
 11 files changed, 238 insertions(+), 4 deletions(-)
 create mode 100644 src/Cake.DocFx/DocFxAliases.cs
 create mode 100644 src/Cake.DocFx/DocFxTool.cs
 create mode 100644 src/Cake.DocFx/Helper/Contract.cs
 create mode 100644 src/Cake.DocFx/Metadata/DocFxMetadataRunner.cs
 create mode 100644 src/Cake.DocFx/Metadata/DocFxMetadataSettings.cs
 create mode 100644 src/Cake.DocFx/packages.config
 create mode 100644 tests/Cake.DocFx.Tests/packages.config

diff --git a/ReleaseNotes.md b/ReleaseNotes.md
index 48f7b17..1441e01 100644
--- a/ReleaseNotes.md
+++ b/ReleaseNotes.md
@@ -1,3 +1,3 @@
-### New in 0.1.0
+### New in 0.1.1
 - Initial release
 - Generate your documentation with DocFxBuild
\ No newline at end of file
diff --git a/src/Cake.DocFx/Cake.DocFx.csproj b/src/Cake.DocFx/Cake.DocFx.csproj
index 0d60d9f..a7e7dae 100644
--- a/src/Cake.DocFx/Cake.DocFx.csproj
+++ b/src/Cake.DocFx/Cake.DocFx.csproj
@@ -32,6 +32,10 @@
     <DocumentationFile>bin\Release\Cake.DocFx.XML</DocumentationFile>
   </PropertyGroup>
   <ItemGroup>
+    <Reference Include="Cake.Core, Version=0.9.0.0, Culture=neutral, processorArchitecture=MSIL">
+      <HintPath>..\..\packages\Cake.Core.0.10.0\lib\net45\Cake.Core.dll</HintPath>
+      <Private>True</Private>
+    </Reference>
     <Reference Include="System" />
     <Reference Include="System.Core" />
     <Reference Include="System.Xml.Linq" />
@@ -42,9 +46,19 @@
     <Reference Include="System.Xml" />
   </ItemGroup>
   <ItemGroup>
+    <Compile Include="Build\DocFxBuildRunner.cs" />
+    <Compile Include="Build\DocFxBuildSettings.cs" />
+    <Compile Include="DocFxAliases.cs" />
+    <Compile Include="DocFxTool.cs" />
+    <Compile Include="Helper\Contract.cs" />
+    <Compile Include="Metadata\DocFxMetadataRunner.cs" />
+    <Compile Include="Metadata\DocFxMetadataSettings.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
     <Compile Include="Properties\AssemblyInfo.Static.cs" />
   </ItemGroup>
+  <ItemGroup>
+    <None Include="packages.config" />
+  </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
        Other similar extension points exist, see Microsoft.Common.targets.
diff --git a/src/Cake.DocFx/DocFxAliases.cs b/src/Cake.DocFx/DocFxAliases.cs
new file mode 100644
index 0000000..30d8b9e
--- /dev/null
+++ b/src/Cake.DocFx/DocFxAliases.cs
@@ -0,0 +1,82 @@
+using System.Collections.Generic;
+using Cake.Core;
+using Cake.Core.Annotations;
+using Cake.Core.IO;
+using Cake.DocFx.Build;
+using Cake.DocFx.Helper;
+using Cake.DocFx.Metadata;
+
+namespace Cake.DocFx
+{
+    /// <summary>
+    ///     Contains functionality related to <see href="http://dotnet.github.io/docfx/index.html">DocFx</see>
+    /// </summary>
+    [CakeAliasCategory("DocFx")]
+    public static class DocFxAliases
+    {
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxBuild(this ICakeContext context) => context.DocFxBuild(null, null);
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxBuild(this ICakeContext context, FilePath configFile)
+            => context.DocFxBuild(configFile, null);
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxBuild(this ICakeContext context, DocFxBuildSettings settings)
+            => context.DocFxBuild(null, settings);
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxBuild(this ICakeContext context, FilePath configFile, DocFxBuildSettings settings)
+        {
+            Contract.NotNull(context, nameof(context));
+
+            settings = settings ?? new DocFxBuildSettings();
+
+            var runner = new DocFxBuildRunner(context.FileSystem, context.Environment, context.ProcessRunner,
+                context.Globber);
+            runner.Run(configFile, settings);
+        }
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxMetadata(this ICakeContext context)
+            => context.DocFxMetadata((DocFxMetadataSettings) null);
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxMetadata(this ICakeContext context, FilePath configFile)
+        {
+            context.DocFxMetadata(new DocFxMetadataSettings
+            {
+                Projects = new[] {configFile}
+            });
+        }
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxMetadata(this ICakeContext context, IEnumerable<FilePath> files)
+        {
+            context.DocFxMetadata(new DocFxMetadataSettings
+            {
+                Projects = files
+            });
+        }
+
+        [CakeAliasCategory("Documentation")]
+        [CakeMethodAlias]
+        public static void DocFxMetadata(this ICakeContext context, DocFxMetadataSettings settings)
+        {
+            Contract.NotNull(context, nameof(context));
+
+            settings = settings ?? new DocFxMetadataSettings();
+
+            var runner = new DocFxMetadataRunner(context.FileSystem, context.Environment, context.ProcessRunner,
+                context.Globber);
+            runner.Run(settings);
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/Cake.DocFx/DocFxTool.cs b/src/Cake.DocFx/DocFxTool.cs
new file mode 100644
index 0000000..271e794
--- /dev/null
+++ b/src/Cake.DocFx/DocFxTool.cs
@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+using Cake.Core;
+using Cake.Core.IO;
+using Cake.Core.Tooling;
+
+namespace Cake.DocFx
+{
+    /// <summary>
+    /// Base class for docfx tools
+    /// </summary>
+    /// <typeparam name="TSettings"></typeparam>
+    public abstract class DocFxTool<TSettings> : Tool<TSettings> where TSettings : ToolSettings
+    {
+        protected DocFxTool(IFileSystem fileSystem, ICakeEnvironment environment, IProcessRunner processRunner, IGlobber globber) 
+            : base(fileSystem, environment, processRunner, globber)
+        {
+        }
+
+        /// <summary>
+        /// Gets the name of the tool.
+        /// </summary>
+        /// <returns>
+        /// The name of the tool.
+        /// </returns>
+        protected override string GetToolName() => "DocFx";
+
+        /// <summary>
+        /// Gets the possible names of the tool executable.
+        /// </summary>
+        /// <returns>
+        /// The tool executable name.
+        /// </returns>
+        protected override IEnumerable<string> GetToolExecutableNames() => new[] {"docfx", "docfx.exe"};
+    }
+}
diff --git a/src/Cake.DocFx/Helper/Contract.cs b/src/Cake.DocFx/Helper/Contract.cs
new file mode 100644
index 0000000..c8c6f6a
--- /dev/null
+++ b/src/Cake.DocFx/Helper/Contract.cs
@@ -0,0 +1,18 @@
+using System;
+
+namespace Cake.DocFx.Helper
+{
+    internal static class Contract
+    {
+        /// <summary>
+        /// Checks if param is not null and otherwise throws exception.
+        /// </summary>
+        /// <param name="parameter"></param>
+        /// <param name="paramName"></param>
+        internal static void NotNull(object parameter, string paramName)
+        {
+            if(parameter == null)
+                throw new ArgumentNullException(paramName);
+        }
+    }
+}
diff --git a/src/Cake.DocFx/Metadata/DocFxMetadataRunner.cs b/src/Cake.DocFx/Metadata/DocFxMetadataRunner.cs
new file mode 100644
index 0000000..f22a98a
--- /dev/null
+++ b/src/Cake.DocFx/Metadata/DocFxMetadataRunner.cs
@@ -0,0 +1,40 @@
+using System.Linq;
+using Cake.Core;
+using Cake.Core.IO;
+
+namespace Cake.DocFx.Metadata
+{
+    public sealed class DocFxMetadataRunner : DocFxTool<DocFxMetadataSettings>
+    {
+        public DocFxMetadataRunner(IFileSystem fileSystem, ICakeEnvironment environment, IProcessRunner processRunner, IGlobber globber) 
+            : base(fileSystem, environment, processRunner, globber)
+        {
+        }
+
+        /// <summary>
+        /// Runs docfx for current folder with the given configuration.
+        /// </summary>
+        /// <param name="settings"></param>
+        public void Run(DocFxMetadataSettings settings)
+        {
+            Run(settings, GetArguments(settings));
+        }
+
+        private ProcessArgumentBuilder GetArguments(DocFxMetadataSettings settings)
+        {
+            var builder = new ProcessArgumentBuilder();
+
+            // command
+            builder.Append("metadata");
+
+            // parameters
+            if (settings.Projects != null && settings.Projects.Any())
+                builder.Append(string.Join(",", settings.Projects.Select(val => val.FullPath)));
+
+            if (settings.OutputPath != null)
+                builder.Append("-o \"{0}\"", settings.OutputPath.FullPath);
+
+            return builder;
+        }
+    }
+}
diff --git a/src/Cake.DocFx/Metadata/DocFxMetadataSettings.cs b/src/Cake.DocFx/Metadata/DocFxMetadataSettings.cs
new file mode 100644
index 0000000..c26c491
--- /dev/null
+++ b/src/Cake.DocFx/Metadata/DocFxMetadataSettings.cs
@@ -0,0 +1,30 @@
+using System.Collections.Generic;
+using Cake.Core.IO;
+using Cake.Core.Tooling;
+
+namespace Cake.DocFx.Metadata
+{
+    /// <summary>
+    ///     Settings used for docfx metadata
+    /// </summary>
+    public class DocFxMetadataSettings : ToolSettings
+    {
+        /// <summary>
+        ///     Specifies the projects to have metadata extracted. There are several approaches to extract language metadata.
+        ///     1. From a supported project file or project file list
+        ///         Supported project file extensions include .csproj, .vbproj, .sln.
+        ///     2. From a supported source code file or source code file list
+        ///         Supported source code file extensions include .cs and .vb. Files can be combined using , as seperator and search
+        ///     pattern.
+        ///     3. From docfx.json file. If the argument is not specified, docfx.exe will try reading docfx.json under current
+        ///     directory.
+        /// </summary>
+        public IEnumerable<FilePath> Projects { get; set; }
+
+        /// <summary>
+        ///     Optional argument.
+        ///     The default output folder is _site/ folder
+        /// </summary>
+        public DirectoryPath OutputPath { get; set; }
+    }
+}
\ No newline at end of file
diff --git a/src/Cake.DocFx/Properties/AssemblyInfo.cs b/src/Cake.DocFx/Properties/AssemblyInfo.cs
index 175194d..ed210c4 100644
--- a/src/Cake.DocFx/Properties/AssemblyInfo.cs
+++ b/src/Cake.DocFx/Properties/AssemblyInfo.cs
@@ -6,8 +6,8 @@
 using System.Reflection;
 
 [assembly: AssemblyProduct("Cake.DocFx")]
-[assembly: AssemblyVersion("0.1.0")]
-[assembly: AssemblyFileVersion("0.1.0")]
-[assembly: AssemblyInformationalVersion("0.1.0")]
+[assembly: AssemblyVersion("0.1.1")]
+[assembly: AssemblyFileVersion("0.1.1")]
+[assembly: AssemblyInformationalVersion("0.1.1")]
 [assembly: AssemblyCopyright("Copyright 2016 (c) Paul Reichelt and contributors")]
 
diff --git a/src/Cake.DocFx/packages.config b/src/Cake.DocFx/packages.config
new file mode 100644
index 0000000..7faa83c
--- /dev/null
+++ b/src/Cake.DocFx/packages.config
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<packages>
+  <package id="Cake.Core" version="0.10.0" targetFramework="net452" />
+</packages>
\ No newline at end of file
diff --git a/tests/Cake.DocFx.Tests/Cake.DocFx.Tests.csproj b/tests/Cake.DocFx.Tests/Cake.DocFx.Tests.csproj
index 8e3ee2b..75c2a57 100644
--- a/tests/Cake.DocFx.Tests/Cake.DocFx.Tests.csproj
+++ b/tests/Cake.DocFx.Tests/Cake.DocFx.Tests.csproj
@@ -30,6 +30,10 @@
     <WarningLevel>4</WarningLevel>
   </PropertyGroup>
   <ItemGroup>
+    <Reference Include="Cake.Core, Version=0.9.0.0, Culture=neutral, processorArchitecture=MSIL">
+      <HintPath>..\..\packages\Cake.Core.0.10.0\lib\net45\Cake.Core.dll</HintPath>
+      <Private>True</Private>
+    </Reference>
     <Reference Include="System" />
     <Reference Include="System.Core" />
     <Reference Include="System.Xml.Linq" />
@@ -42,6 +46,9 @@
   <ItemGroup>
     <Compile Include="Properties\AssemblyInfo.cs" />
   </ItemGroup>
+  <ItemGroup>
+    <None Include="packages.config" />
+  </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
        Other similar extension points exist, see Microsoft.Common.targets.
diff --git a/tests/Cake.DocFx.Tests/packages.config b/tests/Cake.DocFx.Tests/packages.config
new file mode 100644
index 0000000..7faa83c
--- /dev/null
+++ b/tests/Cake.DocFx.Tests/packages.config
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<packages>
+  <package id="Cake.Core" version="0.10.0" targetFramework="net452" />
+</packages>
\ No newline at end of file