Metalama.Framework 2025.0.3-preview

Prefix Reserved
This is a prerelease version of Metalama.Framework.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Metalama.Framework --version 2025.0.3-preview
                    
NuGet\Install-Package Metalama.Framework -Version 2025.0.3-preview
                    
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="Metalama.Framework" Version="2025.0.3-preview" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Metalama.Framework" Version="2025.0.3-preview" />
                    
Directory.Packages.props
<PackageReference Include="Metalama.Framework" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Metalama.Framework --version 2025.0.3-preview
                    
#r "nuget: Metalama.Framework, 2025.0.3-preview"
                    
#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.
#:package Metalama.Framework@2025.0.3-preview
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Metalama.Framework&version=2025.0.3-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Metalama.Framework&version=2025.0.3-preview&prerelease
                    
Install as a Cake Tool

Metalama Logo

Metalama is a Roslyn-based framework for on-the-fly code generation and validation in C#.

Using Metalama, you can:

  • Reduce boilerplate by generating it dynamically during compilation. Your source code remains crystal-clear.
  • Verify code in real time against architecture, patterns, and conventions. No need to wait for code reviews.
  • Provide coding assistance to your team with customized feedback and suggestions.
  • Do it by your rules. Automate your own implementation patterns and architecture guidelines.

For more information, see the Metalama website or Metalama documentation.

About this package

The Metalama.Framework package is the principal package of Metalama. Reference this package if you want to use Metalama in your code.

Referencing this package replaces the compiler with Metalama.Compiler, a shallow fork of Roslyn that adds an extension point to allow us to transform the syntax trees. If you need to reference Metalama without replacing the compiler, use the Metalama.Framework.Redist package.

Package Name Description
Metalama.Compiler Metalama Compiler package. Referencing this package directly is not recommended. A fork of Roslyn.
Metalama.Compiler.Sdk Defines APIs for writing source transformers for Metalama.Compiler.
Metalama.Extensions.Architecture Verifies code against architecture rules in Metalama.
Metalama.Extensions.DependencyInjection Allows aspects to consume dependencies from an arbitrary dependency injection framework.
Metalama.Extensions.DependencyInjection.ServiceLocator Locates and pulls dependencies from a global service provider.
Metalama.Extensions.Metrics Exposes code metrics to the code model in Metalama.
Metalama.Extensions.Multicast Emulates PostSharp multicasting within Metalama.
Metalama.Framework The principal package.
Metalama.Framework.Introspection Provides introspection of Metalama aspect classes, instances, and diagnostics.
Metalama.Framework.Redist Redistributable components for Metalama.Framework. Should be installed as a dependency.
Metalama.Framework.RunTime Run-time components for Metalama.Framework. Usually installed as a dependency.
Metalama.Framework.Sdk A tool for custom source code modifying extensions using the Roslyn API.
Metalama.Framework.Workspaces Allows loading solutions and projects, executing Metalama, and introspection of compilation results.
Metalama.Migration Annotated PostSharp API documenting its Metalama equivalent.
Metalama.Patterns.Caching A caching front-end that can be plugged into different backends and helps with building the cache key, coping with special return types, and invalidating the cache.
Metalama.Patterns.Caching.Aspects A set of aspects that simplify the caching: [Cache] to cache a method result as a function of its parameters, [InvalidateCache] to invalidate the cache, or [CacheKey] to mark a cache key.
Metalama.Patterns.Caching.Backend Backend components for Metalama.Patterns.Caching.
Metalama.Patterns.Caching.Backends.Azure Synchronizes the invalidation of distributed Metalama.Patterns.Caching caches over Azure Service Bus.
Metalama.Patterns.Caching.Backends.Redis Redis back-end for Metalama.Patterns.Caching. Implements both caching and cache invalidation over Redis Pub/Sub.
Metalama.Patterns.Contracts Contract-Based Programming (or Design-by-Contract) with custom attributes such as [NotNull] or [Url] thanks to Metalama: pre-conditions, post-conditions and invariants.
Metalama.Patterns.Immutability Represents the concept of Immutable Type so that it can be used by other packages like Metalama.Patterns.Observability.
Metalama.Patterns.Memoization Simple and high-performance caching of properties or parameterless methods with a single [Memo] custom attribute thanks to Metalama.
Metalama.Patterns.Observability Implements the Observable pattern and the INotifyPropertyChanged interface with a single [Observable] attribute thanks to Metalama. Supports both automatic and explicit properties and child objects.
Metalama.Patterns.Xaml Provides custom observability features for XAML applications.
Metalama.Testing.AspectTesting Test framework for Metalama aspects and fabrics.
Metalama.Testing.UnitTesting A package for unit testing compile-time code.
Metalama.Tool Command line tool for registering a license key or accessing configuration settings.
Metalama.Community.AutoCancellationToken A Metalama weaver that automatically adds CancellationToken to your method definitions and your method calls.
Metalama.Community.Costura A Metalama weaver that embeds dependent assemblies as managed resources. A fork of Costura.Fody.
Metalama.Community.Costura.Redist Redistributable components for package Metalama.Community.Costura. Should only be installed as a dependency.
Metalama.Community.Virtuosity A Metalama weaver that makes all methods in a type virtual.

Change log

We maintain a detailed change log on GitHub.

Feedback and support

If you have any feedback regarding Metalama, please open an issue, start a discussion on GitHub, or contact us directly at hello@postsharp.net.

You can also join our Slack community and ask your technical questions in real time.

Slack

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages (28)

Showing the top 5 NuGet packages that depend on Metalama.Framework:

Package Downloads
Metalama.Extensions.DependencyInjection

An official and open-source Metalama extension that allows aspects to consume dependencies from an arbitrary dependency injection framework.

Tofi.Framework.Aspects

Package Description

Metalama.Patterns.Contracts

Contract-Based Programming (or Design-by-Contract) with custom attributes such as [NotNull] or [Url] thanks to Metalama: pre-conditions, post-conditions and invariants.

Shinya.Core

Shinya.Framework

Metalama.Extensions.Multicast

An official and open-source Metalama extension that emulates PostSharp multicasting.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Metalama.Framework:

Repository Stars
metalama/Metalama
A meta-programming framework for code generation, aspect-oriented programming, and architecture verification of large C# codebases.
Version Downloads Last Updated
2025.2.2-preview 881 9/19/2025
2025.2.1-preview 569 9/9/2025
2025.1.13 3,334 9/5/2025
2025.1.12 3,541 8/7/2025
2025.1.11 4,101 7/23/2025
2025.1.10 6,071 7/3/2025
2025.1.9 11,035 5/29/2025
2025.1.8 1,621 5/26/2025
2025.1.7 1,233 5/22/2025
2025.1.6 1,478 5/15/2025
2025.1.5 6,745 5/2/2025
2025.1.4-rc 1,256 4/15/2025
2025.1.3-rc 1,088 4/9/2025
2025.1.2-preview 888 4/1/2025
2025.1.1-preview 879 3/18/2025
2025.0.12 716 5/22/2025
2025.0.11 604 5/2/2025
2025.0.10 9,444 3/31/2025
2025.0.9 12,430 3/7/2025
2025.0.8 41,517 1/6/2025
2025.0.7-rc 1,915 12/6/2024
2025.0.6-rc 2,867 11/15/2024
2025.0.5-preview 2,263 11/8/2024
2025.0.4-preview 559 10/31/2024
2025.0.3-preview 888 10/25/2024
2025.0.2-preview 691 10/24/2024
2025.0.1-preview 663 10/14/2024
2024.2.32 1,544 3/7/2025
2024.2.31 5,835 12/6/2024
2024.2.30 10,021 11/15/2024
2024.2.29 3,559 10/31/2024
2024.2.28 1,278 10/25/2024
2024.2.27 938 10/24/2024
2024.2.26 18,594 10/14/2024
2024.2.25 3,698 10/2/2024
2024.2.24 34,121 9/10/2024
2024.2.23 16,843 8/30/2024
2024.2.22 1,092 8/29/2024
2024.2.21 8,701 8/28/2024
2024.2.20 22,182 8/15/2024
2024.2.19 6,372 8/1/2024
2024.2.18 1,374 7/29/2024
2024.2.17-rc 740 7/22/2024
2024.2.16-rc 4,083 7/18/2024
2024.2.15-rc 910 7/12/2024
2024.2.14-rc 3,910 7/8/2024
2024.2.13-rc 896 7/2/2024
2024.2.12-preview 1,051 6/28/2024
2024.2.11-preview 884 6/26/2024
2024.2.10-preview 890 6/20/2024
2024.2.9-preview 1,017 6/11/2024
2024.2.8-preview 800 6/6/2024
2024.2.7-preview 907 5/30/2024
2024.2.6-preview 924 5/25/2024
2024.2.5-preview 962 5/6/2024
2024.2.4-preview 856 5/4/2024
2024.2.3-preview 912 4/30/2024
2024.2.2-preview 831 4/23/2024
2024.2.1-preview 903 4/11/2024
2024.1.30 929 10/24/2024
2024.1.29 813 10/11/2024
2024.1.28 1,031 9/9/2024
2024.1.27 991 8/28/2024
2024.1.26 1,222 8/15/2024
2024.1.25 2,397 7/22/2024
2024.1.24 8,556 7/12/2024
2024.1.23 6,881 6/26/2024
2024.1.22 2,531 6/15/2024
2024.1.21 12,805 6/6/2024
2024.1.20 4,806 5/30/2024
2024.1.19 1,624 5/24/2024
2024.1.18 35,588 5/6/2024
2024.1.17 2,766 5/3/2024
2024.1.16 19,010 4/30/2024
2024.1.15 2,438 4/29/2024
2024.1.14 2,940 4/23/2024
2024.1.13 1,081 4/23/2024
2024.1.12 1,608 4/17/2024
2024.1.11-rc 823 4/11/2024
2024.1.10-rc 873 4/4/2024
2024.1.9-rc 974 3/27/2024
2024.1.8-preview 889 3/25/2024
2024.1.7-preview 1,030 3/19/2024
2024.1.6-preview 1,113 3/6/2024
2024.1.5-preview 1,094 2/29/2024
2024.1.4-preview 1,318 2/27/2024
2024.1.3-preview 1,163 2/23/2024
2024.1.2-preview 1,509 2/7/2024
2024.1.1-preview 1,404 1/30/2024
2024.0.16 953 6/15/2024
2024.0.15 888 6/6/2024
2024.0.14 864 5/30/2024
2024.0.13 837 5/24/2024
2024.0.12 1,036 4/17/2024
2024.0.11 37,764 3/21/2024
2024.0.10 1,751 3/19/2024
2024.0.9 6,500 2/29/2024
2024.0.8 2,786 2/23/2024
2024.0.7 14,572 2/7/2024
2024.0.6 17,453 1/3/2024
2024.0.5-rc 1,387 12/21/2023
2024.0.4-rc 1,682 12/12/2023
2024.0.3-preview 1,664 12/6/2023
2024.0.2-preview 4,129 11/14/2023
2024.0.1-preview 1,794 11/6/2023
2023.4.9 5,301 2/7/2024
2023.4.8 9,697 12/21/2023
2023.4.7 2,229 12/12/2023
2023.4.6 21,009 11/7/2023
2023.4.5-rc 1,867 10/26/2023
2023.4.4-preview 1,688 10/18/2023
2023.4.3-preview 2,980 10/4/2023
2023.4.2-preview 1,685 9/26/2023
2023.4.1-preview 1,689 9/13/2023
2023.3.10 1,396 12/21/2023
2023.3.9 1,548 12/12/2023
2023.3.8 12,138 10/17/2023
2023.3.7-rc 1,669 9/29/2023
2023.3.6-rc 1,727 9/26/2023
2023.3.5-rc 1,743 9/13/2023
2023.3.4-preview 1,981 8/30/2023
2023.3.3-preview 1,754 8/29/2023
2023.3.2-preview 4,015 8/1/2023
2023.3.1-preview 2,102 7/28/2023
2023.2.5 22,020 9/12/2023
2023.2.4 11,572 8/7/2023
2023.2.3-rc 2,088 8/3/2023
2023.2.2-rc 2,320 7/21/2023
2023.2.1-preview 3,210 6/27/2023
2023.1.12 1,952 9/12/2023
2023.1.11 2,741 8/7/2023
2023.1.10 3,635 7/17/2023
2023.1.9 2,582 6/27/2023
2023.1.8-rc 1,780 6/19/2023
2023.1.7-rc 1,568 6/14/2023
2023.1.6-rc 2,158 6/12/2023
2023.1.5-preview 2,368 5/26/2023
2023.1.4-preview 1,445 5/26/2023
2023.1.3-preview 2,100 5/25/2023
2023.1.2-preview 2,077 5/24/2023
2023.1.1-preview 4,861 5/10/2023
2023.0.121 1,561 7/17/2023
2023.0.120 1,601 6/27/2023
2023.0.119 14,661 6/14/2023
2023.0.118 1,885 6/7/2023
2023.0.117 2,707 5/25/2023
2023.0.116 1,949 5/23/2023
2023.0.115 5,940 5/4/2023
2023.0.113-rc 2,811 4/21/2023
2023.0.112-rc 1,633 4/14/2023
2023.0.111-rc 2,990 4/5/2023
2023.0.110-rc 2,101 3/30/2023
2023.0.109-rc 2,506 3/23/2023
2023.0.108-rc 2,081 3/15/2023
2023.0.107-rc 3,243 3/1/2023
2023.0.106-rc 343 2/27/2023
2023.0.105-rc 3,269 2/22/2023
2023.0.104-rc 2,199 2/21/2023
2023.0.102-rc 5,727 2/9/2023
2023.0.101-rc 4,491 1/25/2023
0.5.83-preview 2,442 1/23/2023
0.5.82-preview 2,304 1/23/2023
0.5.81-preview 2,248 1/18/2023
0.5.80-preview 2,243 1/15/2023
0.5.79-preview 2,166 1/13/2023
0.5.78-preview 2,366 1/10/2023
0.5.77-preview 2,136 1/9/2023
0.5.76-preview 2,283 1/6/2023
0.5.75-preview 2,197 1/5/2023
0.5.74-preview 2,210 1/3/2023
0.5.73-preview 2,967 12/15/2022
0.5.72-preview 2,147 12/13/2022
0.5.71-preview 2,816 12/10/2022
0.5.70-preview 2,217 12/9/2022
0.5.69-preview 2,130 12/8/2022
0.5.68-preview 1,562 12/5/2022
0.5.67-preview 1,702 12/2/2022
0.5.66-preview 1,585 11/30/2022
0.5.65-preview 1,483 11/30/2022
0.5.64-preview 1,498 11/29/2022
0.5.63-preview 2,200 11/25/2022
0.5.62-preview 1,501 11/24/2022
0.5.61-preview 1,428 11/17/2022
0.5.60-preview 1,457 11/17/2022
0.5.59-preview 1,387 11/16/2022
0.5.58-preview 1,514 11/15/2022
0.5.57-preview 1,545 11/10/2022
0.5.56-preview 1,691 11/8/2022
0.5.55-preview 1,465 11/3/2022
0.5.54-preview 1,441 11/2/2022
0.5.53-preview 1,432 11/1/2022
0.5.52-preview 1,506 10/28/2022
0.5.51-preview 2,116 10/27/2022
0.5.50-preview 904 10/24/2022
0.5.49-preview 459 10/20/2022
0.5.48-preview 797 10/18/2022
0.5.47-preview 723 10/12/2022
0.5.46-preview 580 10/6/2022
0.5.45-preview 360 10/6/2022
0.5.44-preview 633 10/4/2022
0.5.43-preview 691 10/1/2022
0.5.42-preview 469 9/29/2022
0.5.41-preview 1,005 9/28/2022
0.5.40-preview 1,233 9/9/2022
0.5.39-preview 544 9/6/2022
0.5.38-preview 492 9/3/2022
0.5.37-preview 1,547 8/19/2022
0.5.36-preview 736 8/9/2022
0.5.35-preview 430 8/6/2022
0.5.34-preview 600 8/4/2022
0.5.33-preview 292 8/2/2022
0.5.32-preview 464 7/28/2022
0.5.31-preview 421 7/26/2022
0.5.30-preview 712 7/22/2022
0.5.29-preview 638 7/21/2022
0.5.28-preview 690 7/20/2022
0.5.27-preview 392 7/19/2022
0.5.26-preview 597 7/12/2022
0.5.25-preview 971 6/25/2022
0.5.24-preview 575 6/23/2022
0.5.23-preview 1,063 6/7/2022
0.5.22-preview 589 5/31/2022
0.5.21-preview 445 5/27/2022
0.5.20-preview 418 5/24/2022
0.5.19-preview 813 5/17/2022
0.5.18-preview 400 5/12/2022
0.5.16-preview 449 5/9/2022
0.5.15-preview 409 5/7/2022
0.5.13-preview 825 4/28/2022
0.5.12-preview 464 4/27/2022
0.5.11-preview 447 4/15/2022
0.5.10-preview 441 4/15/2022
0.5.9-preview 390 4/14/2022
0.5.8-preview 512 4/7/2022
0.5.7-preview 438 3/22/2022
0.5.6-preview 463 3/16/2022
0.5.5-preview 430 3/15/2022
0.5.4-preview 404 3/14/2022
0.5.3-preview 407 3/9/2022
0.5.2-preview 412 2/23/2022
0.5.1-preview 441 2/18/2022
0.5.0-preview 369 2/7/2022