Centralize all configuration files under /config

Author: Mpdreamz

Directory.Packages.props

@@ -16,6 +16,7 @@
     <PackageVersion Include="AWSSDK.Core" Version="4.0.0.2" />
     <PackageVersion Include="AWSSDK.SQS" Version="4.0.0.1" />
     <PackageVersion Include="AWSSDK.S3" Version="4.0.0.1" />
+    <PackageVersion Include="Chorn.EmbeddedResourceAccessGenerator" Version="1.1.5" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
     <PackageVersion Include="FakeItEasy" Version="8.3.0" />
     <PackageVersion Include="Elastic.Ingest.Elasticsearch" Version="0.11.3" />
     <PackageVersion Include="Microsoft.OpenApi" Version="2.0.0-preview9" />

src/tooling/docs-assembler/assembler.yml renamed to config/assembler.yml

@@ -111,6 +111,14 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Elastic.Documentation.Legac
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Elastic.Documentation.LegacyDocs.Tests", "tests\Elastic.Documentation.LegacyDocs.Tests\Elastic.Documentation.LegacyDocs.Tests.csproj", "{164F55EC-9412-4CD4-81AD-3598B57632A6}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "config", "config", "{6FAB566B-76E3-4E90-8A5C-E75B0F1E1C63}"
+	ProjectSection(SolutionItems) = preProject
+		config\versions.yml = config\versions.yml
+		config\assembler.yml = config\assembler.yml
+		config\legacy-url-mappings.yml = config\legacy-url-mappings.yml
+		config\navigation.yml = config\navigation.yml
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

src/tooling/docs-assembler/legacy-url-mappings.yml renamed to config/legacy-url-mappings.yml

@@ -3,13 +3,17 @@
 // See the LICENSE file in the project root for more information
 
 using System.Text.RegularExpressions;
+using Elastic.Documentation.Extensions;
 using YamlDotNet.Serialization;
 using YamlStaticContext = Elastic.Documentation.Configuration.Serialization.YamlStaticContext;
 
 namespace Elastic.Documentation.Configuration.Assembler;
 
 public record AssemblyConfiguration
 {
+	public static AssemblyConfiguration Create(ConfigurationFileProvider provider) =>
+		Deserialize(provider.AssemblerFile.ReadToEnd());
+
 	public static AssemblyConfiguration Deserialize(string yaml)
 	{
 		var input = new StringReader(yaml);

src/tooling/docs-assembler/navigation.yml renamed to config/navigation.yml

@@ -0,0 +1,78 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+using System.IO.Abstractions;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Elastic.Documentation.Configuration;
+
+public class ConfigurationFileProvider
+{
+	private readonly IFileSystem _fileSystem;
+
+	public ConfigurationFileProvider(IFileSystem fileSystem)
+	{
+		_fileSystem = fileSystem;
+		TemporaryDirectory = fileSystem.Directory.CreateTempSubdirectory("docs-builder-config");
+
+		VersionFile = CreateTemporaryConfigurationFile(EmbeddedResource.______config_versions_yml);
+		AssemblerFile = CreateTemporaryConfigurationFile(EmbeddedResource.______config_assembler_yml);
+		NavigationFile = CreateTemporaryConfigurationFile(EmbeddedResource.______config_navigation_yml);
+		LegacyUrlMappingsFile = CreateTemporaryConfigurationFile(EmbeddedResource.______config_legacy_url_mappings_yml);
+	}
+
+	private IDirectoryInfo TemporaryDirectory { get; }
+
+	public IFileInfo NavigationFile { get; }
+
+	public IFileInfo VersionFile { get; }
+
+	public IFileInfo AssemblerFile { get; }
+
+	public IFileInfo LegacyUrlMappingsFile { get; }
+
+	private IFileInfo CreateTemporaryConfigurationFile(EmbeddedResource resource)
+	{
+		var fileName = resource.GetResourceName().Split('_').Last();
+		using var stream = GetLocalOrEmbedded(resource);
+		var context = stream.ReadToEnd();
+		var fi = _fileSystem.FileInfo.New(Path.Combine(TemporaryDirectory.FullName, fileName));
+		_fileSystem.File.WriteAllText(fi.FullName, context);
+		return fi;
+	}
+
+	private StreamReader GetLocalOrEmbedded(EmbeddedResource resource)
+	{
+		var fileName = resource.GetResourceName().Split('_').Last();
+		var configPath = GetLocalPath(fileName);
+		if (!_fileSystem.File.Exists(configPath))
+			return GetEmbeddedStream(resource);
+		var stream = resource.GetStream();
+		var reader = new StreamReader(stream, leaveOpen: false);
+		return reader;
+	}
+
+	private static StreamReader GetEmbeddedStream(EmbeddedResource resource)
+	{
+		var stream = resource.GetStream();
+		var reader = new StreamReader(stream, leaveOpen: false);
+		return reader;
+	}
+
+	public static string LocalConfigurationDirectory => Path.Combine(Paths.WorkingDirectoryRoot.FullName, "config");
+
+	private static string GetLocalPath(string file) => Path.Combine(LocalConfigurationDirectory, file);
+}
+
+public static class ConfigurationFileProviderServiceCollectionExtensions
+{
+	public static IServiceCollection AddConfigurationFileProvider(this IServiceCollection services,
+		Action<IServiceCollection, ConfigurationFileProvider> configure)
+	{
+		var provider = new ConfigurationFileProvider(new FileSystem());
+		_ = services.AddSingleton(provider);
+		configure(services, provider);
+		return services;
+	}
+}

src/Elastic.Documentation.Configuration/versions.yml renamed to config/versions.yml

@@ -11,13 +11,17 @@
   </ItemGroup>
 
   <ItemGroup>
+    <PackageReference Include="Chorn.EmbeddedResourceAccessGenerator" />
     <PackageReference Include="DotNet.Glob" />
     <PackageReference Include="Samboy063.Tomlet" />
     <PackageReference Include="Vecc.YamlDotNet.Analyzers.StaticGenerator"/>
     <PackageReference Include="YamlDotNet"/>
   </ItemGroup>
 
   <ItemGroup>
-    <EmbeddedResource Include="versions.yml" />
+    <EmbeddedResource Include="$(SolutionRoot)\config\versions.yml" />
+    <EmbeddedResource Include="$(SolutionRoot)\config\assembler.yml" />
+    <EmbeddedResource Include="$(SolutionRoot)\config\navigation.yml" />
+    <EmbeddedResource Include="$(SolutionRoot)\config\legacy-url-mappings.yml" />
   </ItemGroup>
 </Project>