Metalama.Framework 2025.0.4-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.4-preview
                    
NuGet\Install-Package Metalama.Framework -Version 2025.0.4-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.4-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.4-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.4-preview
                    
#r "nuget: Metalama.Framework, 2025.0.4-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.4-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.4-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Metalama.Framework&version=2025.0.4-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
2026.0.1-preview 39 10/4/2025
2025.2.4-rc 314 10/1/2025
2025.2.2-preview 1,225 9/19/2025
2025.2.1-preview 705 9/9/2025
2025.1.14 730 9/30/2025
2025.1.13 4,592 9/5/2025
2025.1.12 3,881 8/7/2025
2025.1.11 4,334 7/23/2025
2025.1.10 6,495 7/3/2025
2025.1.9 11,621 5/29/2025
2025.1.8 1,780 5/26/2025
2025.1.7 1,399 5/22/2025
2025.1.6 1,646 5/15/2025
2025.1.5 6,977 5/2/2025
2025.1.4-rc 1,396 4/15/2025
2025.1.3-rc 1,221 4/9/2025
2025.1.2-preview 1,072 4/1/2025
2025.1.1-preview 1,053 3/18/2025
2025.0.12 841 5/22/2025
2025.0.11 738 5/2/2025
2025.0.10 9,857 3/31/2025
2025.0.9 12,659 3/7/2025
2025.0.8 41,856 1/6/2025
2025.0.7-rc 2,046 12/6/2024
2025.0.6-rc 3,005 11/15/2024
2025.0.5-preview 2,368 11/8/2024
2025.0.4-preview 635 10/31/2024
2025.0.3-preview 1,005 10/25/2024
2025.0.2-preview 818 10/24/2024
2025.0.1-preview 786 10/14/2024
2024.2.32 1,654 3/7/2025
2024.2.31 5,941 12/6/2024
2024.2.30 10,197 11/15/2024
2024.2.29 3,694 10/31/2024
2024.2.28 1,388 10/25/2024
2024.2.27 1,058 10/24/2024
2024.2.26 18,866 10/14/2024
2024.2.25 3,832 10/2/2024
2024.2.24 34,713 9/10/2024
2024.2.23 17,042 8/30/2024
2024.2.22 1,212 8/29/2024
2024.2.21 8,826 8/28/2024
2024.2.20 22,464 8/15/2024
2024.2.19 6,471 8/1/2024
2024.2.18 1,533 7/29/2024
2024.2.17-rc 871 7/22/2024
2024.2.16-rc 4,240 7/18/2024
2024.2.15-rc 1,055 7/12/2024
2024.2.14-rc 4,128 7/8/2024
2024.2.13-rc 990 7/2/2024
2024.2.12-preview 1,202 6/28/2024
2024.2.11-preview 1,009 6/26/2024
2024.2.10-preview 1,019 6/20/2024
2024.2.9-preview 1,153 6/11/2024
2024.2.8-preview 929 6/6/2024
2024.2.7-preview 1,041 5/30/2024
2024.2.6-preview 1,034 5/25/2024
2024.2.5-preview 1,067 5/6/2024
2024.2.4-preview 955 5/4/2024
2024.2.3-preview 1,019 4/30/2024
2024.2.2-preview 927 4/23/2024
2024.2.1-preview 1,043 4/11/2024
2024.1.30 1,033 10/24/2024
2024.1.29 934 10/11/2024
2024.1.28 1,152 9/9/2024
2024.1.27 1,109 8/28/2024
2024.1.26 1,351 8/15/2024
2024.1.25 2,513 7/22/2024
2024.1.24 8,674 7/12/2024
2024.1.23 7,077 6/26/2024
2024.1.22 2,637 6/15/2024
2024.1.21 12,996 6/6/2024
2024.1.20 4,904 5/30/2024
2024.1.19 1,760 5/24/2024
2024.1.18 35,767 5/6/2024
2024.1.17 2,886 5/3/2024
2024.1.16 19,134 4/30/2024
2024.1.15 2,534 4/29/2024
2024.1.14 3,065 4/23/2024
2024.1.13 1,192 4/23/2024
2024.1.12 1,730 4/17/2024
2024.1.11-rc 940 4/11/2024
2024.1.10-rc 994 4/4/2024
2024.1.9-rc 1,087 3/27/2024
2024.1.8-preview 1,005 3/25/2024
2024.1.7-preview 1,146 3/19/2024
2024.1.6-preview 1,210 3/6/2024
2024.1.5-preview 1,224 2/29/2024
2024.1.4-preview 1,417 2/27/2024
2024.1.3-preview 1,276 2/23/2024
2024.1.2-preview 1,655 2/7/2024
2024.1.1-preview 1,511 1/30/2024
2024.0.16 1,071 6/15/2024
2024.0.15 989 6/6/2024
2024.0.14 991 5/30/2024
2024.0.13 956 5/24/2024
2024.0.12 1,163 4/17/2024
2024.0.11 37,913 3/21/2024
2024.0.10 1,870 3/19/2024
2024.0.9 6,620 2/29/2024
2024.0.8 2,910 2/23/2024
2024.0.7 14,710 2/7/2024
2024.0.6 17,574 1/3/2024
2024.0.5-rc 1,502 12/21/2023
2024.0.4-rc 1,789 12/12/2023
2024.0.3-preview 1,782 12/6/2023
2024.0.2-preview 4,287 11/14/2023
2024.0.1-preview 1,905 11/6/2023
2023.4.9 5,432 2/7/2024
2023.4.8 9,821 12/21/2023
2023.4.7 2,336 12/12/2023
2023.4.6 21,147 11/7/2023
2023.4.5-rc 1,987 10/26/2023
2023.4.4-preview 1,817 10/18/2023
2023.4.3-preview 3,078 10/4/2023
2023.4.2-preview 1,791 9/26/2023
2023.4.1-preview 1,758 9/13/2023
2023.3.10 1,472 12/21/2023
2023.3.9 1,631 12/12/2023
2023.3.8 12,305 10/17/2023
2023.3.7-rc 1,757 9/29/2023
2023.3.6-rc 1,806 9/26/2023
2023.3.5-rc 1,825 9/13/2023
2023.3.4-preview 2,058 8/30/2023
2023.3.3-preview 1,821 8/29/2023
2023.3.2-preview 4,084 8/1/2023
2023.3.1-preview 2,167 7/28/2023
2023.2.5 22,097 9/12/2023
2023.2.4 11,669 8/7/2023
2023.2.3-rc 2,134 8/3/2023
2023.2.2-rc 2,380 7/21/2023
2023.2.1-preview 3,281 6/27/2023
2023.1.12 2,017 9/12/2023
2023.1.11 2,813 8/7/2023
2023.1.10 3,721 7/17/2023
2023.1.9 2,632 6/27/2023
2023.1.8-rc 1,829 6/19/2023
2023.1.7-rc 1,599 6/14/2023
2023.1.6-rc 2,198 6/12/2023
2023.1.5-preview 2,406 5/26/2023
2023.1.4-preview 1,485 5/26/2023
2023.1.3-preview 2,148 5/25/2023
2023.1.2-preview 2,130 5/24/2023
2023.1.1-preview 4,912 5/10/2023
2023.0.121 1,593 7/17/2023
2023.0.120 1,643 6/27/2023
2023.0.119 14,706 6/14/2023
2023.0.118 1,928 6/7/2023
2023.0.117 2,759 5/25/2023
2023.0.116 1,999 5/23/2023
2023.0.115 6,003 5/4/2023
2023.0.113-rc 2,861 4/21/2023
2023.0.112-rc 1,695 4/14/2023
2023.0.111-rc 3,035 4/5/2023
2023.0.110-rc 2,181 3/30/2023
2023.0.109-rc 2,587 3/23/2023
2023.0.108-rc 2,151 3/15/2023
2023.0.107-rc 3,318 3/1/2023
2023.0.106-rc 354 2/27/2023
2023.0.105-rc 3,305 2/22/2023
2023.0.104-rc 2,258 2/21/2023
2023.0.102-rc 5,767 2/9/2023
2023.0.101-rc 4,643 1/25/2023
0.5.83-preview 2,502 1/23/2023
0.5.82-preview 2,346 1/23/2023
0.5.81-preview 2,308 1/18/2023
0.5.80-preview 2,284 1/15/2023
0.5.79-preview 2,228 1/13/2023
0.5.78-preview 2,427 1/10/2023
0.5.77-preview 2,207 1/9/2023
0.5.76-preview 2,355 1/6/2023
0.5.75-preview 2,268 1/5/2023
0.5.74-preview 2,281 1/3/2023
0.5.73-preview 3,018 12/15/2022
0.5.72-preview 2,220 12/13/2022
0.5.71-preview 2,888 12/10/2022
0.5.70-preview 2,279 12/9/2022
0.5.69-preview 2,192 12/8/2022
0.5.68-preview 1,604 12/5/2022
0.5.67-preview 1,733 12/2/2022
0.5.66-preview 1,618 11/30/2022
0.5.65-preview 1,528 11/30/2022
0.5.64-preview 1,529 11/29/2022
0.5.63-preview 2,252 11/25/2022
0.5.62-preview 1,533 11/24/2022
0.5.61-preview 1,459 11/17/2022
0.5.60-preview 1,494 11/17/2022
0.5.59-preview 1,429 11/16/2022
0.5.58-preview 1,574 11/15/2022
0.5.57-preview 1,605 11/10/2022
0.5.56-preview 1,741 11/8/2022
0.5.55-preview 1,496 11/3/2022
0.5.54-preview 1,475 11/2/2022
0.5.53-preview 1,465 11/1/2022
0.5.52-preview 1,549 10/28/2022
0.5.51-preview 2,162 10/27/2022
0.5.50-preview 918 10/24/2022
0.5.49-preview 472 10/20/2022
0.5.48-preview 808 10/18/2022
0.5.47-preview 734 10/12/2022
0.5.46-preview 592 10/6/2022
0.5.45-preview 373 10/6/2022
0.5.44-preview 666 10/4/2022
0.5.43-preview 741 10/1/2022
0.5.42-preview 488 9/29/2022
0.5.41-preview 1,101 9/28/2022
0.5.40-preview 1,277 9/9/2022
0.5.39-preview 555 9/6/2022
0.5.38-preview 503 9/3/2022
0.5.37-preview 1,584 8/19/2022
0.5.36-preview 748 8/9/2022
0.5.35-preview 443 8/6/2022
0.5.34-preview 614 8/4/2022
0.5.33-preview 295 8/2/2022
0.5.32-preview 477 7/28/2022
0.5.31-preview 422 7/26/2022
0.5.30-preview 724 7/22/2022
0.5.29-preview 650 7/21/2022
0.5.28-preview 704 7/20/2022
0.5.27-preview 403 7/19/2022
0.5.26-preview 609 7/12/2022
0.5.25-preview 982 6/25/2022
0.5.24-preview 586 6/23/2022
0.5.23-preview 1,076 6/7/2022
0.5.22-preview 600 5/31/2022
0.5.21-preview 457 5/27/2022
0.5.20-preview 433 5/24/2022
0.5.19-preview 827 5/17/2022
0.5.18-preview 413 5/12/2022
0.5.16-preview 461 5/9/2022
0.5.15-preview 420 5/7/2022
0.5.13-preview 836 4/28/2022
0.5.12-preview 475 4/27/2022
0.5.11-preview 460 4/15/2022
0.5.10-preview 452 4/15/2022
0.5.9-preview 402 4/14/2022
0.5.8-preview 524 4/7/2022
0.5.7-preview 449 3/22/2022
0.5.6-preview 476 3/16/2022
0.5.5-preview 441 3/15/2022
0.5.4-preview 416 3/14/2022
0.5.3-preview 418 3/9/2022
0.5.2-preview 424 2/23/2022
0.5.1-preview 453 2/18/2022
0.5.0-preview 380 2/7/2022