OLT.Utility.AssemblyScanner 1.0.0

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package OLT.Utility.AssemblyScanner --version 1.0.0                
NuGet\Install-Package OLT.Utility.AssemblyScanner -Version 1.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OLT.Utility.AssemblyScanner" Version="1.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add OLT.Utility.AssemblyScanner --version 1.0.0                
#r "nuget: OLT.Utility.AssemblyScanner, 1.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install OLT.Utility.AssemblyScanner as a Cake Addin
#addin nuget:?package=OLT.Utility.AssemblyScanner&version=1.0.0

// Install OLT.Utility.AssemblyScanner as a Cake Tool
#tool nuget:?package=OLT.Utility.AssemblyScanner&version=1.0.0                

<img src="https://user-images.githubusercontent.com/1365728/127748628-47575d74-a2fb-4539-a31e-74d8b435fc21.png" width="30%" >

.NET Utility Library to scan for referenced assemblies

<code>OltAssemblyScanBuilder</code> is a flexible utility for filtering and loading .NET assemblies dynamically. Using a builder pattern, it allows you to include or exclude assemblies based on specified criteria, making it ideal for scenarios where you need to manage assembly loading at runtime.

Nuget CI

Features

  • Filter Assemblies: Include or exclude assemblies based on name patterns.
  • Dynamic Loading: Optionally load assemblies into the current AppDomain.
  • Chainable API: Utilizes a builder pattern for flexible configuration.
  • Distinct List: Ensures a distinct list of assemblies is returned after filtering

Installation

Add the AssemblyScanner source files to your .NET project or include it as a class library.

dotnet add package OLT.Utility.AssemblyScanner

Usage

Here's a basic example of how to use the <code>OltAssemblyScanBuilder</code> to filter and load assemblies:

using OLT.Utility

class Program
{
    static void Main()
    {
        var assemblies = new OltAssemblyScanBuilder()
            .IncludeFilter("OLT.", "MyApp.")
            .LoadAssemblies()
            .Build();
        
        foreach (var assembly in assemblies)
        {
            Console.WriteLine($"Loaded Assembly: {assembly.FullName}");
        }
    }
}

Including and Excluding Assemblies

You can include and exclude assemblies using patterns:

using OLT.Utility

class Program
{
    static void Main()
    {
        var scanAssemblies = new List<Assembly>()
        {
            typeof(MyDatabaseContext).Assembly,
            typeof(IAnotherInterface).Assembly
        };

        var assemblies = new OltAssemblyScanBuilder()
            .IncludeFilter("OLT.", "MyApp.")
            .ExcludeFilter("System.")
            .ExcludeFilter("Microsoft.")
            .IncludeAssemblies(scanAssemblies)
            .IncludeAssembly(typeof(Program).Assembly)
            .ExcludeMicrosoft()
            .ExcludeAutomapper()
            .DeepScan()
            .LoadAssemblies()
            .Build();
        
        foreach (var assembly in assemblies)
        {
            Console.WriteLine($"Loaded Assembly: {assembly.FullName}");
        }
    }
}

Loading Assemblies

The LoadAssemblies() method will attempt to load the filtered assemblies into the current AppDomain. You can remove this step if you only need the assembly names without actually loading them.

Methods

IncludeFilter

Adds a filter to include assemblies based on a name pattern.

IncludeFilter(string filter);
ExcludeFilter

Adds a filter to exclude assemblies based on a name pattern.

ExcludeFilter(string filter);
DeepScan

Scans all referenced assemblies for the included filter

DeepScan(string filter);
Build

Filters the assemblies based on the specified criteria and returns a distinct list.

IEnumerable<Assembly> Build();
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on OLT.Utility.AssemblyScanner:

Package Downloads
OLT.Extensions.DependencyInjection

Add Exenestions to service collection for OLT Default injection

OLT.Extensions.DependencyInjection.AutoMapper

Auto Mapper Extensions for Data Adapters

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 79 12/2/2024
1.0.0 230 11/14/2024
1.0.0-beta-0008 81 10/28/2024
1.0.0-beta-0005 73 10/26/2024