Sake Documentation¶

use namespace="System"
use namespace="System.IO"

functions
   @{
      void WriteLine(string text, string colorText)
      {
         ConsoleColor color;

         if (Enum.TryParse<ConsoleColor>(colorText, true, out color))
         {
            WriteLine(text, color);
            return;
         }         

         WriteLine(text);
      }

      void WriteLine(string text = null, ConsoleColor? color = null)
      {
         if (text != null && color != null)
         {
            Console.ForegroundColor = color.Value;
         }

         Console.WriteLine(text);

         if (text != null && color != null)
         {
            Console.ResetColor();
         }
      }

      void Write(string text, string colorText)
      {
         ConsoleColor color;

         if (Enum.TryParse<ConsoleColor>(colorText, true, out color))
         {
            Write(text, color);
            return;
         }         

         Write(text);
      }

      void Write(string text = null, ConsoleColor? color = null)
      {
         if (text != null && color != null)
         {
            Console.ForegroundColor = color.Value;
         }

         Console.Write(text);

         if (text != null && color != null)
         {
            Console.ResetColor();
         }
      }
   }

use namespace="System.Linq"
use import="Console"

#default
   @{
      WriteLine();
      WriteLine("   Colors in ConsoleColor", "yellow");
      WriteLine("   ======================", "cyan");
      foreach(var color in Enum.GetValues(typeof(ConsoleColor)).Cast<ConsoleColor>())
      {
         Write("   ");
         WriteLine(color.ToString(), color);
      }
      WriteLine();
      WriteLine("   ======================", "cyan");
      WriteLine();
   }

use namespace="System"
use namespace="System.IO"
use namespace="System.Collections"
use namespace="System.Collections.Generic"
use import="Console"

functions
   @{
      void WriteHelp()
      {
         WriteHelpHeader();

         var groups = GetTargetGroups();

         WriteHelpGroups(groups);
         WriteHelpFooter();
      }

      void WriteHelpHeader()
      {
         WriteLine();
         Write("********************************", ConsoleColor.DarkGreen);
         Write(" HELP ", ConsoleColor.Green);
         WriteLine("********************************", ConsoleColor.DarkGreen);
         WriteLine();
         Write("This build script has the following build ");
         Write("targets", ConsoleColor.Green);
         WriteLine(" set up:");
      }

      TargetGroups GetTargetGroups()
      {
         var groups = new TargetGroups();

         foreach(var kvp in Targets)
         {
            var target = kvp.Value;
            var tokens = target.Description.Split((char)'|'); 

            if (tokens.Length == 2)
            {
               groups.Add(tokens[0], target.Name, tokens[1]);
            }
            else
            {
               groups.AddUngrouped(target.Name, target.Description);
            }
         }

         return groups;
      }

      void WriteHelpGroups(TargetGroups groups)
      {
         // write out any ungrouped targets first
         foreach(var target in groups.UngroupedItems)
         {
            WriteLine();
            Write(" ");
            Write(target.Name, ConsoleColor.Green);
            Write(" = ");
            WriteLine(target.Description);
         }

         // write out groups
         foreach(var group in groups)
         {
            WriteLine();
            Write(" ");
            WriteLine(group.Name, ConsoleColor.DarkGreen);

            foreach(var target in group.Targets)
            {
               Write("  > ");
               Write(target.Name, ConsoleColor.Green);
               Write(" = ");
               WriteLine(target.Description);
            }
         }
      }

      void WriteHelpFooter()
      {
         WriteLine();
         WriteLine(" For a complete list of build tasks, view makefile.shade.");
         WriteLine();
         WriteLine("**********************************************************************", ConsoleColor.DarkGreen);
      }

      public class TargetItem
      {
         public TargetItem(string name, string description)
         {
            Name = name;
            Description = description;
         }

         public string Name { get; private set; }

         public string Description { get; private set; }
      }

      public class TargetGroup
      {
         private readonly List<TargetItem> _targets;

         public TargetGroup(string name) 
         {
            _targets = new List<TargetItem>();
            Name = name;
         }

         public string Name { get; private set; }

         public List<TargetItem> Targets { get { return _targets; } }

         public TargetItem Add(string name, string description)
         {
            var item = new TargetItem(name, description);
            _targets.Add(item);
            return item;
         }
      }

      public class TargetGroups : IEnumerable<TargetGroup>
      {
         private readonly Dictionary<string, TargetGroup> _groups;
         private readonly List<TargetItem> _ungrouped;

         public TargetGroups()
         {
            _groups = new Dictionary<string, TargetGroup>();	
            _ungrouped = new List<TargetItem>();			
         }

         public List<TargetItem> UngroupedItems 
         { 
            get { return _ungrouped; }
         }

         public TargetGroup Add(string groupName, string itemName, string itemDescription)
         {
            var group = _groups.ContainsKey(groupName) ? _groups[groupName] : null;

            if (group == null)
            {
               group = new TargetGroup(groupName);
               _groups.Add(group.Name, group);
            }

            group.Add(itemName, itemDescription);

            return group;
         }

         public TargetItem AddUngrouped(string itemName, string itemDescription)
         {
         	var item = new TargetItem(itemName, itemDescription);
            _ungrouped.Add(item);
            return item;
         }

         System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator()
         {
            return this.GetEnumerator();
         }

         public IEnumerator<TargetGroup> GetEnumerator()
         {
            foreach(var kvp in _groups)
            {
               yield return kvp.Value;
            }
         }
      }
   }

use import="Console"
use import="Help"

#default description="Comprehensive|Performs a full clean, build and test"

#clean description="Build|Remove artifacts of a previous build"

#dnx description="Build|Check for and install DNX."

#restore description="Build|Restore packages for the project"

#build description="Build|Build the project"

#alltest description="Test|Run all tests"

#unittest description="Test|Run unit tests"

#inttest description="Test|Run integration tests"

#help description="Help|Displays a list of build commands"
   @{
      WriteHelp();
   }

@{/*

build 
    Executes msbuild to compile your project or solution

projectFile='' 
    Required. Path to the project or solution file to build.

configuration='Release'
    Determines which configuration to use when building.

outputDir=''
    Directs all compiler outputs into the target path. Note:  this will be relative to the project files (not the solution file if building a solution).

extra=''
    Additional commandline parameters for msbuild

*/}

default configuration='Release'
default outputDir=''
default extra=''

use namespace="System"
use namespace="System.IO"
use namespace="System.Reflection"

var buildProgram=''

@{
   Assembly buildUtilities = null;
   string toolsVersion = null;

   try
   {
      buildUtilities = Assembly.Load("Microsoft.Build.Utilities.Core, Version=14.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a");
      toolsVersion = "14.0";
   }
   catch
   {
      buildUtilities = Assembly.Load("Microsoft.Build.Utilities.v12.0, Version=12.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a");
      toolsVersion = "12.0";
   }

   var helper = buildUtilities.GetType("Microsoft.Build.Utilities.ToolLocationHelper");
   var method = helper.GetMethod("GetPathToBuildTools", new Type[] { typeof(string) } );
   var path = method.Invoke(helper, new object[] { toolsVersion }).ToString();

   buildProgram = Path.Combine(path, "msbuild.exe");
}

var OutDirProperty=''
set OutDirProperty='OutDir=${outputDir}${Path.DirectorySeparatorChar};' if='!string.IsNullOrWhiteSpace(outputDir)'

exec program="${buildProgram}" commandline='${projectFile} "/p:${OutDirProperty}Configuration=${configuration}" ${extra}'

#default .build

#clean
   msbuild projectFile="src/SakeMsBuild.sln" outputDir="../../output" extra="/t:Clean"

#build .clean
   msbuild projectFile="src/SakeMsBuild.sln" outputDir="../../output" extra="/t:Rebuild /m"