Metalama.Framework 0.5.56-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 0.5.56-preview
                    
NuGet\Install-Package Metalama.Framework -Version 0.5.56-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="0.5.56-preview" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Metalama.Framework" Version="0.5.56-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 0.5.56-preview
                    
#r "nuget: Metalama.Framework, 0.5.56-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@0.5.56-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=0.5.56-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Metalama.Framework&version=0.5.56-preview&prerelease
                    
Install as a Cake Tool

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 transform the syntax trees.

What is Metalama?

Metalama is a modern, Roslyn-based meta-programming framework C# with focus on aspect-oriented programmning, code generation and code validation.

It is an extension of the Microsoft "Roslyn" C# compiler that allows you to automatically transform your source code at build time or design time based on encapsulated code transformations called aspects. Metalama can be used for aspect-oriented programming, code generation, or architecture validation.

Metalama is intended to replace the MSIL-based stack that is now the foundation of PostSharp.

Documentation and examples

Link Description
Documentation Conceptual and API documentation.
Try Metalama Try Metalama from your browser. Based on https://try.dot.net/
Metalama.Samples A dozen of examples in a GitHub repo.
Metalama.Open.AutoCancellationToken A low-level Metalama aspect that adds cancellation tokens to your method declarations and your method calls.
Metalama.Open.Virtuosity A low-level Metalama aspect that makes your methods virtual. (A fork of Virtuosity.Fody.)
Metalama.Open.Costura A low-level Metalama aspect that embeds dependent assemblies as managed resources. (A fork of Costura.Fody.)
Metalama.Framework.Extensions Open-source extensions to Metalama.Framework.

Metalama components

For a diagram of the multiple packages that compose Metalama, see https://doc.metalama.net/deployment/packages.

Feedback and support

If you have any feedback regarding Metalama, please open an issue, start a discussion, 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

Shinya.Core

Shinya.Framework

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.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 288 9/19/2025
2025.2.1-preview 378 9/9/2025
2025.1.13 2,088 9/5/2025
2025.1.12 3,170 8/7/2025
2025.1.11 3,758 7/23/2025
2025.1.10 5,486 7/3/2025
2025.1.9 10,544 5/29/2025
2025.1.8 1,428 5/26/2025
2025.1.7 1,090 5/22/2025
2025.1.6 1,360 5/15/2025
2025.1.5 6,426 5/2/2025
2025.1.4-rc 1,143 4/15/2025
2025.1.3-rc 958 4/9/2025
2025.1.2-preview 774 4/1/2025
2025.1.1-preview 739 3/18/2025
2025.0.12 599 5/22/2025
2025.0.11 509 5/2/2025
2025.0.10 9,001 3/31/2025
2025.0.9 12,213 3/7/2025
2025.0.8 41,085 1/6/2025
2025.0.7-rc 1,805 12/6/2024
2025.0.6-rc 2,770 11/15/2024
2025.0.5-preview 2,158 11/8/2024
2025.0.4-preview 471 10/31/2024
2025.0.3-preview 781 10/25/2024
2025.0.2-preview 584 10/24/2024
2025.0.1-preview 539 10/14/2024
2024.2.32 1,419 3/7/2025
2024.2.31 5,737 12/6/2024
2024.2.30 9,849 11/15/2024
2024.2.29 3,466 10/31/2024
2024.2.28 1,167 10/25/2024
2024.2.27 825 10/24/2024
2024.2.26 18,280 10/14/2024
2024.2.25 3,586 10/2/2024
2024.2.24 33,498 9/10/2024
2024.2.23 16,575 8/30/2024
2024.2.22 994 8/29/2024
2024.2.21 8,575 8/28/2024
2024.2.20 21,778 8/15/2024
2024.2.19 6,203 8/1/2024
2024.2.18 1,223 7/29/2024
2024.2.17-rc 641 7/22/2024
2024.2.16-rc 3,946 7/18/2024
2024.2.15-rc 776 7/12/2024
2024.2.14-rc 3,700 7/8/2024
2024.2.13-rc 771 7/2/2024
2024.2.12-preview 908 6/28/2024
2024.2.11-preview 767 6/26/2024
2024.2.10-preview 786 6/20/2024
2024.2.9-preview 910 6/11/2024
2024.2.8-preview 713 6/6/2024
2024.2.7-preview 801 5/30/2024
2024.2.6-preview 815 5/25/2024
2024.2.5-preview 879 5/6/2024
2024.2.4-preview 745 5/4/2024
2024.2.3-preview 794 4/30/2024
2024.2.2-preview 724 4/23/2024
2024.2.1-preview 807 4/11/2024
2024.1.30 810 10/24/2024
2024.1.29 694 10/11/2024
2024.1.28 922 9/9/2024
2024.1.27 877 8/28/2024
2024.1.26 1,114 8/15/2024
2024.1.25 2,277 7/22/2024
2024.1.24 8,439 7/12/2024
2024.1.23 6,654 6/26/2024
2024.1.22 2,414 6/15/2024
2024.1.21 12,608 6/6/2024
2024.1.20 4,675 5/30/2024
2024.1.19 1,534 5/24/2024
2024.1.18 34,939 5/6/2024
2024.1.17 2,665 5/3/2024
2024.1.16 18,899 4/30/2024
2024.1.15 2,338 4/29/2024
2024.1.14 2,804 4/23/2024
2024.1.13 975 4/23/2024
2024.1.12 1,510 4/17/2024
2024.1.11-rc 745 4/11/2024
2024.1.10-rc 776 4/4/2024
2024.1.9-rc 855 3/27/2024
2024.1.8-preview 790 3/25/2024
2024.1.7-preview 933 3/19/2024
2024.1.6-preview 984 3/6/2024
2024.1.5-preview 1,011 2/29/2024
2024.1.4-preview 1,200 2/27/2024
2024.1.3-preview 1,047 2/23/2024
2024.1.2-preview 1,411 2/7/2024
2024.1.1-preview 1,298 1/30/2024
2024.0.16 835 6/15/2024
2024.0.15 754 6/6/2024
2024.0.14 760 5/30/2024
2024.0.13 741 5/24/2024
2024.0.12 916 4/17/2024
2024.0.11 37,552 3/21/2024
2024.0.10 1,635 3/19/2024
2024.0.9 6,387 2/29/2024
2024.0.8 2,664 2/23/2024
2024.0.7 14,425 2/7/2024
2024.0.6 17,354 1/3/2024
2024.0.5-rc 1,281 12/21/2023
2024.0.4-rc 1,568 12/12/2023
2024.0.3-preview 1,551 12/6/2023
2024.0.2-preview 3,962 11/14/2023
2024.0.1-preview 1,697 11/6/2023
2023.4.9 5,196 2/7/2024
2023.4.8 9,577 12/21/2023
2023.4.7 2,107 12/12/2023
2023.4.6 20,829 11/7/2023
2023.4.5-rc 1,749 10/26/2023
2023.4.4-preview 1,584 10/18/2023
2023.4.3-preview 2,894 10/4/2023
2023.4.2-preview 1,584 9/26/2023
2023.4.1-preview 1,604 9/13/2023
2023.3.10 1,297 12/21/2023
2023.3.9 1,453 12/12/2023
2023.3.8 11,968 10/17/2023
2023.3.7-rc 1,596 9/29/2023
2023.3.6-rc 1,619 9/26/2023
2023.3.5-rc 1,654 9/13/2023
2023.3.4-preview 1,885 8/30/2023
2023.3.3-preview 1,672 8/29/2023
2023.3.2-preview 3,932 8/1/2023
2023.3.1-preview 2,019 7/28/2023
2023.2.5 21,876 9/12/2023
2023.2.4 11,452 8/7/2023
2023.2.3-rc 2,008 8/3/2023
2023.2.2-rc 2,251 7/21/2023
2023.2.1-preview 3,139 6/27/2023
2023.1.12 1,872 9/12/2023
2023.1.11 2,659 8/7/2023
2023.1.10 3,553 7/17/2023
2023.1.9 2,496 6/27/2023
2023.1.8-rc 1,735 6/19/2023
2023.1.7-rc 1,503 6/14/2023
2023.1.6-rc 2,089 6/12/2023
2023.1.5-preview 2,310 5/26/2023
2023.1.4-preview 1,394 5/26/2023
2023.1.3-preview 2,037 5/25/2023
2023.1.2-preview 2,003 5/24/2023
2023.1.1-preview 4,773 5/10/2023
2023.0.121 1,509 7/17/2023
2023.0.120 1,548 6/27/2023
2023.0.119 14,586 6/14/2023
2023.0.118 1,822 6/7/2023
2023.0.117 2,657 5/25/2023
2023.0.116 1,892 5/23/2023
2023.0.115 5,861 5/4/2023
2023.0.113-rc 2,740 4/21/2023
2023.0.112-rc 1,585 4/14/2023
2023.0.111-rc 2,920 4/5/2023
2023.0.110-rc 1,999 3/30/2023
2023.0.109-rc 2,394 3/23/2023
2023.0.108-rc 2,004 3/15/2023
2023.0.107-rc 3,165 3/1/2023
2023.0.106-rc 326 2/27/2023
2023.0.105-rc 3,228 2/22/2023
2023.0.104-rc 2,126 2/21/2023
2023.0.102-rc 5,667 2/9/2023
2023.0.101-rc 4,334 1/25/2023
0.5.83-preview 2,390 1/23/2023
0.5.82-preview 2,235 1/23/2023
0.5.81-preview 2,180 1/18/2023
0.5.80-preview 2,192 1/15/2023
0.5.79-preview 2,115 1/13/2023
0.5.78-preview 2,304 1/10/2023
0.5.77-preview 2,074 1/9/2023
0.5.76-preview 2,207 1/6/2023
0.5.75-preview 2,156 1/5/2023
0.5.74-preview 2,148 1/3/2023
0.5.73-preview 2,916 12/15/2022
0.5.72-preview 2,084 12/13/2022
0.5.71-preview 2,744 12/10/2022
0.5.70-preview 2,153 12/9/2022
0.5.69-preview 2,080 12/8/2022
0.5.68-preview 1,510 12/5/2022
0.5.67-preview 1,653 12/2/2022
0.5.66-preview 1,525 11/30/2022
0.5.65-preview 1,422 11/30/2022
0.5.64-preview 1,442 11/29/2022
0.5.63-preview 2,156 11/25/2022
0.5.62-preview 1,449 11/24/2022
0.5.61-preview 1,372 11/17/2022
0.5.60-preview 1,403 11/17/2022
0.5.59-preview 1,335 11/16/2022
0.5.58-preview 1,447 11/15/2022
0.5.57-preview 1,487 11/10/2022
0.5.56-preview 1,647 11/8/2022
0.5.55-preview 1,424 11/3/2022
0.5.54-preview 1,416 11/2/2022
0.5.53-preview 1,391 11/1/2022
0.5.52-preview 1,474 10/28/2022
0.5.51-preview 2,105 10/27/2022
0.5.50-preview 889 10/24/2022
0.5.49-preview 446 10/20/2022
0.5.48-preview 786 10/18/2022
0.5.47-preview 712 10/12/2022
0.5.46-preview 564 10/6/2022
0.5.45-preview 347 10/6/2022
0.5.44-preview 601 10/4/2022
0.5.43-preview 642 10/1/2022
0.5.42-preview 448 9/29/2022
0.5.41-preview 893 9/28/2022
0.5.40-preview 1,184 9/9/2022
0.5.39-preview 531 9/6/2022
0.5.38-preview 477 9/3/2022
0.5.37-preview 1,522 8/19/2022
0.5.36-preview 734 8/9/2022
0.5.35-preview 418 8/6/2022
0.5.34-preview 586 8/4/2022
0.5.33-preview 281 8/2/2022
0.5.32-preview 453 7/28/2022
0.5.31-preview 410 7/26/2022
0.5.30-preview 700 7/22/2022
0.5.29-preview 636 7/21/2022
0.5.28-preview 676 7/20/2022
0.5.27-preview 376 7/19/2022
0.5.26-preview 581 7/12/2022
0.5.25-preview 954 6/25/2022
0.5.24-preview 573 6/23/2022
0.5.23-preview 1,052 6/7/2022
0.5.22-preview 577 5/31/2022
0.5.21-preview 430 5/27/2022
0.5.20-preview 404 5/24/2022
0.5.19-preview 811 5/17/2022
0.5.18-preview 389 5/12/2022
0.5.16-preview 435 5/9/2022
0.5.15-preview 407 5/7/2022
0.5.13-preview 820 4/28/2022
0.5.12-preview 445 4/27/2022
0.5.11-preview 426 4/15/2022
0.5.10-preview 428 4/15/2022
0.5.9-preview 376 4/14/2022
0.5.8-preview 500 4/7/2022
0.5.7-preview 427 3/22/2022
0.5.6-preview 451 3/16/2022
0.5.5-preview 419 3/15/2022
0.5.4-preview 390 3/14/2022
0.5.3-preview 404 3/9/2022
0.5.2-preview 399 2/23/2022
0.5.1-preview 430 2/18/2022
0.5.0-preview 357 2/7/2022