private static PdfJsonConfig ParseOptions(PdfCommandOptions options)
{
var configFile = BuildCommand.GetConfigFilePath(options);
PdfJsonConfig config;
if (configFile == null)
{
if (options.Content == null && options.Resource == null)
{
throw new OptionParserException("Either provide config file or specify content files to start building documentation.");
}
config = new PdfJsonConfig()
{
BaseDirectory = EnvironmentContext.BaseDirectory
};
MergeOptionsToConfig(options, config);
return(config);
}
config = CommandUtility.GetConfig <PdfConfig>(configFile).Item;
if (config == null)
{
throw new DocumentException($"Unable to find pdf subcommand config in file '{configFile}'.");
}
config.BaseDirectory = Path.GetDirectoryName(configFile);
MergeOptionsToConfig(options, config);
return(config);
}
private MetadataJsonConfig ParseOptions(MetadataCommandOptions options)
{
string configFile;
if (TryGetJsonConfig(options.Projects, out configFile))
{
var config = CommandUtility.GetConfig<MetadataConfig>(configFile).Item;
if (config == null) throw new DocumentException($"Unable to find metadata subcommand config in file '{configFile}'.");
config.BaseDirectory = Path.GetDirectoryName(configFile);
config.OutputFolder = options.OutputFolder;
foreach (var item in config)
{
item.Raw |= options.PreserveRawInlineComments;
item.Force |= options.ForceRebuild;
item.FilterConfigFile = options.FilterConfigFile ?? item.FilterConfigFile;
}
return config;
}
else
{
var config = new MetadataJsonConfig();
config.Add(new MetadataJsonItemConfig
{
Force = options.ForceRebuild,
Destination = options.OutputFolder,
Raw = options.PreserveRawInlineComments,
Source = new FileMapping(new FileMappingItem(options.Projects.ToArray())) { Expanded = true },
FilterConfigFile = options.FilterConfigFile
});
return config;
}
}
/// <summary>
/// TODO: refactor
/// </summary>
/// <param name="options"></param>
/// <returns></returns>
private static BuildJsonConfig ParseOptions(BuildCommandOptions options)
{
var configFile = GetConfigFilePath(options);
BuildJsonConfig config;
if (configFile == null)
{
if (options.Content == null && options.Resource == null)
{
throw new OptionParserException("Either provide config file or specify content files to start building documentation.");
}
config = new BuildJsonConfig();
MergeOptionsToConfig(options, config);
return(config);
}
config = CommandUtility.GetConfig <BuildConfig>(configFile).Item;
if (config == null)
{
var message = $"Unable to find build subcommand config in file '{configFile}'.";
Logger.LogError(message, code: ErrorCodes.Config.BuildConfigNotFound);
throw new DocumentException(message);
}
config.BaseDirectory = Path.GetDirectoryName(configFile);
MergeOptionsToConfig(options, config);
return(config);
}
private IEnumerable <KeyValuePair <string, JToken> > ToOrderedKeyValuePair(string path)
{
var jObject = CommandUtility.GetConfig <JObject>(path);
foreach (var item in jObject)
{
yield return(item);
}
}
private static MergeJsonConfig ParseOptions(MergeCommandOptions options)
{
var configFile = options.ConfigFile;
MergeJsonConfig config;
if (string.IsNullOrEmpty(configFile))
{
if (!File.Exists(DocAsCode.Constants.ConfigFileName))
{
if (options.Content == null)
{
throw new ArgumentException("Either provide config file or specify content files to start building documentation.");
}
else
{
config = new MergeJsonConfig();
var item = new MergeJsonItemConfig();
MergeOptionsToConfig(options, ref item);
config.Add(item);
return(config);
}
}
else
{
Logger.Log(LogLevel.Verbose, $"Config file {DocAsCode.Constants.ConfigFileName} is found.");
configFile = DocAsCode.Constants.ConfigFileName;
}
}
config = CommandUtility.GetConfig <MergeConfig>(configFile).Item;
if (config == null)
{
var message = $"Unable to find build subcommand config in file '{configFile}'.";
Logger.LogError(message, code: ErrorCodes.Config.BuildConfigNotFound);
throw new DocumentException(message);
}
for (int i = 0; i < config.Count; i++)
{
var round = config[i];
round.BaseDirectory = Path.GetDirectoryName(configFile);
MergeOptionsToConfig(options, ref round);
}
return(config);
}
private static BuildJsonConfig ParseOptions(BuildCommandOptions options)
{
var configFile = options.ConfigFile;
BuildJsonConfig config;
if (string.IsNullOrEmpty(configFile))
{
if (!File.Exists(DocAsCode.Constants.ConfigFileName))
{
if (options.Content == null && options.Resource == null)
{
throw new ArgumentException("Either provide config file or specify content files to start building documentation.");
}
else
{
config = new BuildJsonConfig();
MergeOptionsToConfig(options, config);
return(config);
}
}
else
{
Logger.Log(LogLevel.Verbose, $"Config file {DocAsCode.Constants.ConfigFileName} is found.");
configFile = DocAsCode.Constants.ConfigFileName;
}
}
config = CommandUtility.GetConfig <BuildConfig>(configFile).Item;
if (config == null)
{
throw new DocumentException($"Unable to find build subcommand config in file '{configFile}'.");
}
config.BaseDirectory = Path.GetDirectoryName(configFile);
MergeOptionsToConfig(options, config);
MergeNewFileRepositoryToConfig(config);
return(config);
}
private MetadataJsonConfig ParseOptions(MetadataCommandOptions options, out string baseDirectory, out string outputFolder)
{
MetadataJsonConfig config;
baseDirectory = null;
if (TryGetJsonConfig(options.Projects, out string configFile))
{
config = CommandUtility.GetConfig <MetadataConfig>(configFile).Item;
if (config == null)
{
throw new DocumentException($"Unable to find metadata subcommand config in file '{configFile}'.");
}
baseDirectory = Path.GetDirectoryName(configFile);
}
else
{
config = new MetadataJsonConfig
{
new MetadataJsonItemConfig
{
Destination = options.OutputFolder,
Source = new FileMapping(new FileMappingItem(options.Projects.ToArray()))
{
Expanded = true
}
}
};
}
var msbuildProperties = ResolveMSBuildProperties(options);
foreach (var item in config)
{
item.Force |= options.ForceRebuild;
item.Raw |= options.PreserveRawInlineComments;
item.ShouldSkipMarkup |= options.ShouldSkipMarkup;
item.DisableGitFeatures |= options.DisableGitFeatures;
item.DisableDefaultFilter |= options.DisableDefaultFilter;
if (!string.IsNullOrEmpty(options.FilterConfigFile))
{
item.FilterConfigFile = Path.GetFullPath(options.FilterConfigFile);
}
if (!string.IsNullOrEmpty(options.GlobalNamespaceId))
{
item.GlobalNamespaceId = options.GlobalNamespaceId;
}
if (item.MSBuildProperties == null)
{
item.MSBuildProperties = msbuildProperties;
}
else
{
// Command line properties overwrites the one defined in docfx.json
foreach (var pair in msbuildProperties)
{
item.MSBuildProperties[pair.Key] = pair.Value;
}
}
}
outputFolder = options.OutputFolder;
return(config);
}
