Пример #1
0
 /// <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);
     }
 }
Пример #2
0
        /// <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();
            }
        }