Add depedency loader for NuGet package loading
This commit is contained in:
parent
7c2501b765
commit
be3bc5c365
343
src/Connected.Host/DependencyLoader.cs
Normal file
343
src/Connected.Host/DependencyLoader.cs
Normal file
@ -0,0 +1,343 @@
|
||||
using System.Reflection;
|
||||
using System.Runtime.Versioning;
|
||||
using Connected.Host.Configuration;
|
||||
using Microsoft.Extensions.DependencyModel;
|
||||
using NuGet.Configuration;
|
||||
using NuGet.Frameworks;
|
||||
using NuGet.Packaging;
|
||||
using NuGet.Packaging.Core;
|
||||
using NuGet.Packaging.Signing;
|
||||
using NuGet.Protocol.Core.Types;
|
||||
using NuGet.Resolver;
|
||||
using NuGet.Versioning;
|
||||
|
||||
|
||||
namespace Connected.Host;
|
||||
|
||||
public class DependencyLoader
|
||||
{
|
||||
/// <summary>
|
||||
/// Loads packages from the specified repositories into memory.
|
||||
/// </summary>
|
||||
/// <param name="packages">A list of package Id and version descriptors to load.</param>
|
||||
/// <param name="repositoryLocations">A list of NuGet repositories to check.</param>
|
||||
/// <param name="cancellationToken"></param>
|
||||
/// <exception cref="InvalidOperationException">Thrown when a package identity could not be resolved.</exception>
|
||||
private async Task Load(IEnumerable<MicroServiceDescriptor> packages, IEnumerable<string> repositoryLocations, CancellationToken? cancellationToken = null)
|
||||
{
|
||||
cancellationToken ??= CancellationToken.None;
|
||||
|
||||
//TODO: Wire up actual logger
|
||||
var logger = new NuGet.Common.NullLogger();
|
||||
|
||||
/*
|
||||
* Define a source provider with specified sources.
|
||||
*/
|
||||
var packageSources = GetPackageSources(repositoryLocations);
|
||||
/*
|
||||
* Define a package source provider with empty settings with the specified package sources.
|
||||
*/
|
||||
var packageSourceProvider = new PackageSourceProvider(Settings.LoadMachineWideSettings(Settings.DefaultSettingsFileName), packageSources);
|
||||
/*
|
||||
* Define a repository provider with our package source and the latest API capabilities.
|
||||
*/
|
||||
var repositoryProvider = new SourceRepositoryProvider(packageSourceProvider, Repository.Provider.GetCoreV3());
|
||||
/*
|
||||
* Setup contexts for dependency resolution and package downloading.
|
||||
* First, the disposable cache
|
||||
*/
|
||||
using var sourceCacheContext = new SourceCacheContext();
|
||||
/*
|
||||
* Next, the compatible framework versions.
|
||||
*/
|
||||
var version = Assembly.GetExecutingAssembly()
|
||||
.GetCustomAttributes(typeof(TargetFrameworkAttribute), false)
|
||||
.SingleOrDefault() as TargetFrameworkAttribute;
|
||||
|
||||
var targetFramework = NuGetFramework.ParseFrameworkName(version.FrameworkName, DefaultFrameworkNameProvider.Instance);
|
||||
/*
|
||||
* Complete list of all touched packages, to be filled out by installer and downloader.
|
||||
*/
|
||||
var allPackages = new HashSet<SourcePackageDependencyInfo>();
|
||||
/*
|
||||
* Default dependency context.
|
||||
*/
|
||||
var dependencyContext = DependencyContext.Default;
|
||||
/*
|
||||
* Extract list of repositories.
|
||||
*/
|
||||
var repositories = repositoryProvider.GetRepositories();
|
||||
/*
|
||||
* Get all package identities and packages.
|
||||
*/
|
||||
foreach (var dependency in packages)
|
||||
{
|
||||
var packageIdentity = await GetPackageIdentity(dependency, sourceCacheContext, logger, repositories, cancellationToken.Value);
|
||||
|
||||
if (packageIdentity is null)
|
||||
throw new InvalidOperationException($"Cannot find package {dependency.Name}.");
|
||||
|
||||
await GetPackageDependencies(packageIdentity, sourceCacheContext, targetFramework, logger, repositories, dependencyContext, allPackages, cancellationToken.Value);
|
||||
}
|
||||
|
||||
var packagesToInstall = GetPackagesToInstall(repositoryProvider, logger, packages, allPackages);
|
||||
/*
|
||||
* Install packages in standard location.
|
||||
*/
|
||||
var packageDirectory = Path.Combine(Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location)!, ".packages");
|
||||
|
||||
var nugetSettings = Settings.LoadDefaultSettings(packageDirectory);
|
||||
|
||||
await InstallPackages(sourceCacheContext, logger, packagesToInstall, packageDirectory, nugetSettings, cancellationToken.Value);
|
||||
}
|
||||
/// <summary>
|
||||
/// Installs the list of packages and loads them into memory.
|
||||
/// </summary>
|
||||
/// <param name="sourceCacheContext">The shared context for resolved packages.</param>
|
||||
/// <param name="logger">A standard NuGet logger.</param>
|
||||
/// <param name="packagesToInstall">A list of packages to install.</param>
|
||||
/// <param name="rootPackagesDirectory">The root directory into which the packages are downloaded and extracted.</param>
|
||||
/// <param name="nugetSettings">A set of NuGet settings, containing local repos and download behavior settings.</param>
|
||||
/// <param name="cancellationToken"></param>
|
||||
private async Task InstallPackages(SourceCacheContext sourceCacheContext, NuGet.Common.ILogger logger,
|
||||
IEnumerable<SourcePackageDependencyInfo> packagesToInstall, string rootPackagesDirectory,
|
||||
ISettings nugetSettings, CancellationToken cancellationToken)
|
||||
{
|
||||
var packagePathResolver = new PackagePathResolver(rootPackagesDirectory, true);
|
||||
var packageExtractionContext = new PackageExtractionContext(
|
||||
PackageSaveMode.Defaultv3,
|
||||
XmlDocFileSaveMode.Skip,
|
||||
ClientPolicyContext.GetClientPolicy(nugetSettings, logger),
|
||||
logger);
|
||||
|
||||
foreach (var package in packagesToInstall)
|
||||
{
|
||||
var downloadResource = await package.Source.GetResourceAsync<DownloadResource>(cancellationToken);
|
||||
|
||||
/*
|
||||
* Download package (from online, local or shared cache).
|
||||
*/
|
||||
var downloadResult = await downloadResource.GetDownloadResourceResultAsync(
|
||||
package,
|
||||
new PackageDownloadContext(sourceCacheContext),
|
||||
SettingsUtility.GetGlobalPackagesFolder(nugetSettings),
|
||||
logger,
|
||||
cancellationToken);
|
||||
|
||||
/*
|
||||
* Extract package.
|
||||
*/
|
||||
var extractedFiles = await PackageExtractor.ExtractPackageAsync(
|
||||
downloadResult.PackageSource,
|
||||
downloadResult.PackageStream,
|
||||
packagePathResolver,
|
||||
packageExtractionContext,
|
||||
cancellationToken);
|
||||
|
||||
/*
|
||||
* Install applicable dlls.
|
||||
*/
|
||||
foreach (var assembly in extractedFiles.Where(e => e.EndsWith(".dll")))
|
||||
{
|
||||
try
|
||||
{
|
||||
Assembly.LoadFrom(assembly);
|
||||
}
|
||||
catch (Exception e)
|
||||
{
|
||||
logger.LogWarning($"Could not load assembly. {e}");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Generates a list of package sources from a list of repository urls.
|
||||
/// </summary>
|
||||
/// <param name="sources">A list of URIs of specified sources.</param>
|
||||
/// <returns>A list of package sources for the specified NuGet repository URIs.</returns>
|
||||
private IEnumerable<PackageSource> GetPackageSources(IEnumerable<string> sources)
|
||||
{
|
||||
foreach (var source in sources)
|
||||
yield return new PackageSource(source);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Returns a list of missing packages to satisfy all dependencies.
|
||||
/// </summary>
|
||||
/// <param name="sourceRepositoryProvider">A source repository provider for all resources to load packages from.</param>
|
||||
/// <param name="logger">A standard NuGet logger.</param>
|
||||
/// <param name="packages">A list of packages for which to resolve all dependencies.</param>
|
||||
/// <param name="availablePackages">A list of available packages to resolve from.</param>
|
||||
/// <returns></returns>
|
||||
private IEnumerable<SourcePackageDependencyInfo> GetPackagesToInstall(SourceRepositoryProvider sourceRepositoryProvider, NuGet.Common.ILogger logger, IEnumerable<MicroServiceDescriptor> packages, HashSet<SourcePackageDependencyInfo> availablePackages)
|
||||
{
|
||||
/*
|
||||
* Create resolver to resolve missing packages
|
||||
*/
|
||||
var resolverContext = new PackageResolverContext(
|
||||
DependencyBehavior.Lowest,
|
||||
packages.Select(x => x.Name),
|
||||
Enumerable.Empty<string>(),
|
||||
Enumerable.Empty<PackageReference>(),
|
||||
Enumerable.Empty<PackageIdentity>(),
|
||||
availablePackages,
|
||||
sourceRepositoryProvider.GetRepositories().Select(s => s.PackageSource),
|
||||
logger);
|
||||
|
||||
var packagesToInstall = new PackageResolver()
|
||||
.Resolve(resolverContext, CancellationToken.None)
|
||||
.Select(p => availablePackages.Single(x => PackageIdentityComparer.Default.Equals(x, p)));
|
||||
|
||||
return packagesToInstall;
|
||||
}
|
||||
/// <summary>
|
||||
/// Resolves a package identity from the supplied Id and version.
|
||||
/// </summary>
|
||||
/// <param name="microserviceDescriptor">The version and id of the required package.</param>
|
||||
/// <param name="cache">The shared cache in which resolved packages are stored.</param>
|
||||
/// <param name="nugetLogger">A standard NuGet logger.</param>
|
||||
/// <param name="repositories">A list of repositories to check when resolving the package version.</param>
|
||||
/// <param name="cancelToken"></param>
|
||||
/// <returns>Returns the resolved package identity or null if it could not be resolved.</returns>
|
||||
/// <exception cref="InvalidOperationException">Thrown when the version range could not be parsed.</exception>
|
||||
private async Task<PackageIdentity?> GetPackageIdentity(MicroServiceDescriptor microserviceDescriptor, SourceCacheContext cache, NuGet.Common.ILogger nugetLogger, IEnumerable<SourceRepository> repositories, CancellationToken cancelToken)
|
||||
{
|
||||
/*
|
||||
* Go through repositories in order.
|
||||
*/
|
||||
foreach (var sourceRepository in repositories)
|
||||
{
|
||||
/*
|
||||
* Get resource, available versions and attempt to resolve the appropriate version. If none is available, take the last one.
|
||||
*/
|
||||
var findPackageResource = await sourceRepository.GetResourceAsync<FindPackageByIdResource>();
|
||||
|
||||
var availableVersions = await findPackageResource.GetAllVersionsAsync(microserviceDescriptor.Name, cache, nugetLogger, cancelToken);
|
||||
|
||||
NuGetVersion selected;
|
||||
|
||||
if (microserviceDescriptor.Version is not null)
|
||||
{
|
||||
if (!VersionRange.TryParse(microserviceDescriptor.Version, out var range))
|
||||
throw new InvalidOperationException("Invalid version range provided.");
|
||||
|
||||
var bestVersion = range.FindBestMatch(availableVersions);
|
||||
|
||||
selected = bestVersion;
|
||||
}
|
||||
else
|
||||
selected = availableVersions.LastOrDefault();
|
||||
|
||||
if (selected is not null)
|
||||
return new PackageIdentity(microserviceDescriptor.Name, selected);
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
/// <summary>
|
||||
/// Searches the package dependency graph for the chain of all packages to install.
|
||||
/// </summary>
|
||||
private async Task GetPackageDependencies(PackageIdentity package,
|
||||
SourceCacheContext cacheContext,
|
||||
NuGetFramework framework,
|
||||
NuGet.Common.ILogger logger,
|
||||
IEnumerable<SourceRepository> repositories,
|
||||
DependencyContext hostDependencies,
|
||||
ISet<SourcePackageDependencyInfo> availablePackages,
|
||||
CancellationToken cancelToken)
|
||||
{
|
||||
/*
|
||||
* Already present, skip.
|
||||
*/
|
||||
if (availablePackages.Contains(package))
|
||||
return;
|
||||
|
||||
foreach (var sourceRepository in repositories)
|
||||
{
|
||||
/*
|
||||
* Get dependency info.
|
||||
*/
|
||||
var dependencyInfoResource = await sourceRepository.GetResourceAsync<DependencyInfoResource>();
|
||||
|
||||
var dependencyInfo = await dependencyInfoResource.ResolvePackage(
|
||||
package,
|
||||
framework,
|
||||
cacheContext,
|
||||
logger,
|
||||
cancelToken);
|
||||
|
||||
if (dependencyInfo is null)
|
||||
continue;
|
||||
/*
|
||||
* Only return packages not provided by the host.
|
||||
*/
|
||||
var sourceDependencies = new SourcePackageDependencyInfo(
|
||||
dependencyInfo.Id,
|
||||
dependencyInfo.Version,
|
||||
dependencyInfo.Dependencies.Where(dependency => !DependencySuppliedByHost(hostDependencies, dependency)),
|
||||
dependencyInfo.Listed,
|
||||
dependencyInfo.Source);
|
||||
|
||||
availablePackages.Add(sourceDependencies);
|
||||
/*
|
||||
* Get the dependency's packages.
|
||||
*/
|
||||
foreach (var dependency in sourceDependencies.Dependencies)
|
||||
{
|
||||
await GetPackageDependencies(
|
||||
new PackageIdentity(dependency.Id, dependency.VersionRange.MinVersion),
|
||||
cacheContext,
|
||||
framework,
|
||||
logger,
|
||||
repositories,
|
||||
hostDependencies,
|
||||
availablePackages,
|
||||
cancelToken);
|
||||
}
|
||||
|
||||
break;
|
||||
}
|
||||
}
|
||||
/// <summary>
|
||||
/// Checks if a package dependency is already provided by the host.
|
||||
/// </summary>
|
||||
/// <param name="hostDependencies">The context packages.</param>
|
||||
/// <param name="dependency">The dependency to check for.</param>
|
||||
/// <returns>True if the host provides the dependency, false otherwise.</returns>
|
||||
private bool DependencySuppliedByHost(DependencyContext hostDependencies, PackageDependency dependency)
|
||||
{
|
||||
/*
|
||||
* Check runtimes for package with same id.
|
||||
*/
|
||||
var runtimeLib = hostDependencies.RuntimeLibraries.FirstOrDefault(r => r.Name == dependency.Id);
|
||||
|
||||
if (runtimeLib is null)
|
||||
return false;
|
||||
/*
|
||||
* Check for version compatibility.
|
||||
*/
|
||||
var parsedLibVersion = NuGetVersion.Parse(runtimeLib.Version);
|
||||
|
||||
if (parsedLibVersion.IsPrerelease)
|
||||
/*
|
||||
* Latest and greatest. Always accept due to system compatiblity reasons.
|
||||
*/
|
||||
return true;
|
||||
|
||||
/*
|
||||
* Check for version compatibility.
|
||||
*/
|
||||
return dependency.VersionRange.Satisfies(parsedLibVersion);
|
||||
|
||||
}
|
||||
/// <summary>
|
||||
/// Loads packages from the specified repositories into memory.
|
||||
/// </summary>
|
||||
/// <param name="packages">A list of package Id and version descriptors to load.</param>
|
||||
/// <param name="repositories">A list of NuGet repositories to check.</param>
|
||||
internal static async Task LoadPackages(IEnumerable<MicroServiceDescriptor> packages, IEnumerable<string> repositories)
|
||||
{
|
||||
await new DependencyLoader().Load(packages, repositories);
|
||||
}
|
||||
}
|
Loading…
x
Reference in New Issue
Block a user