// Copyright (c) Umbraco. // See LICENSE for more details. using System.Diagnostics.CodeAnalysis; using System.Reflection; using Umbraco.Cms.Core.Semver; namespace Umbraco.Extensions; public static class AssemblyExtensions { private static string _rootDir = string.Empty; /// /// Utility method that returns the path to the root of the application, by getting the path to where the assembly /// where this /// method is included is present, then traversing until it's past the /bin directory. Ie. this makes it work /// even if the assembly is in a /bin/debug or /bin/release folder /// /// public static string GetRootDirectorySafe(this Assembly executingAssembly) { if (string.IsNullOrEmpty(_rootDir) == false) { return _rootDir; } var codeBase = executingAssembly.Location; var uri = new Uri(codeBase); var path = uri.LocalPath; var baseDirectory = Path.GetDirectoryName(path); if (string.IsNullOrEmpty(baseDirectory)) { throw new Exception( "No root directory could be resolved. Please ensure that your Umbraco solution is correctly configured."); } _rootDir = baseDirectory.Contains("bin") ? baseDirectory[..(baseDirectory.LastIndexOf("bin", StringComparison.OrdinalIgnoreCase) - 1)] : baseDirectory; return _rootDir; } /// /// Returns the file used to load the assembly /// /// /// public static FileInfo GetAssemblyFile(this Assembly assembly) { var codeBase = assembly.Location; var uri = new Uri(codeBase); var path = uri.LocalPath; return new FileInfo(path); } /// /// Returns true if the assembly is the App_Code assembly /// /// /// public static bool IsAppCodeAssembly(this Assembly assembly) { if (assembly.FullName!.StartsWith("App_Code")) { try { Assembly.Load("App_Code"); return true; } catch (FileNotFoundException) { // this will occur if it cannot load the assembly return false; } } return false; } /// /// Returns true if the assembly is the compiled global asax. /// /// /// public static bool IsGlobalAsaxAssembly(this Assembly assembly) => // only way I can figure out how to test is by the name assembly.FullName!.StartsWith("App_global.asax"); /// /// Returns the file used to load the assembly /// /// /// public static FileInfo? GetAssemblyFile(this AssemblyName assemblyName) { var codeBase = assemblyName.CodeBase; if (!string.IsNullOrEmpty(codeBase)) { var uri = new Uri(codeBase); var path = uri.LocalPath; return new FileInfo(path); } return null; } /// /// Gets the assembly informational version for the specified . /// /// The assembly. /// The assembly version. /// /// true if the assembly information version is retrieved; otherwise, false. /// public static bool TryGetInformationalVersion(this Assembly assembly, [NotNullWhen(true)] out string? version) { AssemblyInformationalVersionAttribute? assemblyInformationalVersionAttribute = assembly.GetCustomAttribute(); if (assemblyInformationalVersionAttribute is not null && SemVersion.TryParse(assemblyInformationalVersionAttribute.InformationalVersion, out SemVersion? semVersion)) { version = semVersion.ToSemanticStringWithoutBuild(); return true; } else { AssemblyName assemblyName = assembly.GetName(); if (assemblyName.Version is not null) { version = assemblyName.Version.ToString(3); return true; } } version = null; return false; } }