/// <summary>
/// Generated the help web site
/// </summary>
private void GenerateWebSite()
{
try
{
WebHelpGenerator webHelpGenerator = new WebHelpGenerator(Document, UI, Project, WebDecorator);
webHelpGenerator.Generate(AdditionalFiles);
}
catch (Exception ex)
{
UI.Log(ex);
}
}
/// <summary>
/// Runs one or more generation tasks.
/// </summary>
/// <param name="options"></param>
public void Execute(GeneratorOptions options)
{
// this is just to record the run duration, so we can monitor and optimize
// build-time perf
_startTimeTicks = DateTime.Now.Ticks;
if (options.Tasks == null || options.Tasks.Count == 0)
{
throw new Exception("No tasks specified for the generator to run");
}
if (options.Verbose)
{
// todo: echo out generator options
}
#if DEBUG
var configuration = "Debug";
#else
var configuration = "Release";
#endif
BinSubFolder = Path.Combine("bin", configuration, options.TargetFramework);
var fqRootPath = Path.GetFullPath(options.RootPath);
var sdkNugetFolder = Path.GetFullPath(options.SdkNugetFolder);
var awsPowerShellSourcePath = Path.Combine(fqRootPath, ModulesSubFolder, AWSPowerShellModuleName);
var deploymentArtifactsPath = Path.Combine(fqRootPath, options.GetEditionOutputFolder(DeploymentArtifactsSubFolder));
if (options.ShouldRunTask(GeneratorTasknames.GenerateCmdlets))
{
Console.WriteLine("Executing task 'GenerateCmdlets'");
var cmdletGenerator = new CmdletGenerator
{
SdkNugetFolder = sdkNugetFolder,
OutputFolder = awsPowerShellSourcePath,
Options = options
};
cmdletGenerator.Generate();
// Note: the remaining tasks rely on having a built copy of the AWSPowerShell module,
// so we exit so that a build can take place and the generator then re-run with the
// new tasks
Console.WriteLine("Task 'GenerateCmdlets' complete, exiting...");
return;
}
var basePath = string.IsNullOrEmpty(options.BuiltModulesLocation) ? Path.Combine(awsPowerShellSourcePath, BinSubFolder)
: options.BuiltModulesLocation;
var awsPsXmlPath = Path.Combine(basePath, options.AssemblyName + ".XML");
var awsPsDllPath = Path.Combine(basePath, options.AssemblyName + ".dll");
var awsPowerShellAssembly = Assembly.LoadFrom(awsPsDllPath);
if (options.ShouldRunTask(GeneratorTasknames.GenerateFormats))
{
Console.WriteLine("Executing task 'GenerateFormats'");
bool includeCore = options.AssemblyName.Equals(AWSPowerShellDllName, StringComparison.OrdinalIgnoreCase) ||
options.AssemblyName.Equals(AWSPowerShellCommonDllName, StringComparison.OrdinalIgnoreCase);
var targetAssemblies = new List <Assembly> {
awsPowerShellAssembly
};
var sdkAssemblies = awsPowerShellAssembly.GetReferencedAssemblies()
.Where(assembly => assembly.Name.StartsWith("AWSSDK.", StringComparison.OrdinalIgnoreCase) &&
(includeCore || !assembly.Name.Equals("AWSSDK.Core", StringComparison.OrdinalIgnoreCase)))
.ToArray();
targetAssemblies.AddRange(sdkAssemblies.Select(assembly => Assembly.LoadFrom(Path.Combine(sdkNugetFolder, "..", GenerationSources.ExtractedNugetFolderName, GenerationSources.DotNetPlatformNetStandard20, assembly.Name + ".dll"))));
targetAssemblies.AddRange(AppDomain.CurrentDomain.GetAssemblies().Where(assembly => sdkAssemblies.Contains(assembly.GetName())));
var formatsGenerator = new FormatGenerator
{
OutputFolder = basePath,
Name = options.AssemblyName,
TargetAssemblies = targetAssemblies,
Options = options
};
formatsGenerator.Generate();
}
if (options.ShouldRunTask(GeneratorTasknames.GeneratePsHelp))
{
Console.WriteLine("Executing task 'GeneratePshelp'");
var cmdletDocumentation = new XmlDocument();
cmdletDocumentation.Load(awsPsXmlPath);
var pshelpGenerator = new PsHelpGenerator
{
CmdletAssembly = awsPowerShellAssembly,
AssemblyDocumentation = cmdletDocumentation,
Name = options.AssemblyName,
OutputFolder = basePath,
Options = options
};
pshelpGenerator.Generate();
}
if (options.ShouldRunTask(GeneratorTasknames.GenerateWebHelp))
{
Console.WriteLine("Executing task 'GenerateWebhelp'");
var cmdletDocumentation = new XmlDocument();
cmdletDocumentation.Load(awsPsXmlPath);
string docOutputFolder;
if (string.IsNullOrEmpty(options.DocOutputFolder))
{
docOutputFolder = Path.Combine(fqRootPath, DocBuildOutputSubFolder);
}
else
{
docOutputFolder = options.DocOutputFolder;
}
var webhelpGenerator = new WebHelpGenerator
{
CmdletAssembly = awsPowerShellAssembly,
AssemblyDocumentation = cmdletDocumentation,
Name = AWSPowerShellModuleName,
OutputFolder = docOutputFolder,
CNNorth1RegionDocsDomain = options.CNNorth1RegionDocsDomain,
Options = options
};
webhelpGenerator.Generate();
}
}