Metalama.Framework
2025.0.2-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.
See the version list below for details.
dotnet add package Metalama.Framework --version 2025.0.2-preview
NuGet\Install-Package Metalama.Framework -Version 2025.0.2-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.2-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.2-preview" />
<PackageReference Include="Metalama.Framework" />
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.2-preview
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Metalama.Framework, 2025.0.2-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.2-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.2-preview&prerelease
#tool nuget:?package=Metalama.Framework&version=2025.0.2-preview&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
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.
Quick Links
- 🌐 Metalama Website
- 📖 Documentation
- 📝 Annotated Examples
- 🎥 Tutorial Videos
- 🐞 Bug Reports
- 💬 Discussions
- 📜 Detailed Changelog
- 📢 Release Notes
- ✨ Visual Studio Extension
Related packages
| 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.
There are no supported framework assets in this package.
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- Metalama.Compiler (>= 2025.0.2-preview)
- Metalama.Framework.Redist (>= 2025.0.2-preview)
- Microsoft.CSharp (>= 4.7.0)
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.1.12 | 1,228 | 8/7/2025 |
| 2025.1.11 | 1,919 | 7/23/2025 |
| 2025.1.10 | 2,959 | 7/3/2025 |
| 2025.1.9 | 7,922 | 5/29/2025 |
| 2025.1.8 | 1,156 | 5/26/2025 |
| 2025.1.7 | 1,029 | 5/22/2025 |
| 2025.1.6 | 1,294 | 5/15/2025 |
| 2025.1.5 | 5,613 | 5/2/2025 |
| 2025.1.4-rc | 1,121 | 4/15/2025 |
| 2025.1.3-rc | 928 | 4/9/2025 |
| 2025.1.2-preview | 745 | 4/1/2025 |
| 2025.1.1-preview | 722 | 3/18/2025 |
| 2025.0.12 | 484 | 5/22/2025 |
| 2025.0.11 | 457 | 5/2/2025 |
| 2025.0.10 | 7,731 | 3/31/2025 |
| 2025.0.9 | 10,762 | 3/7/2025 |
| 2025.0.8 | 38,696 | 1/6/2025 |
| 2025.0.7-rc | 1,793 | 12/6/2024 |
| 2025.0.6-rc | 2,747 | 11/15/2024 |
| 2025.0.5-preview | 2,131 | 11/8/2024 |
| 2025.0.4-preview | 466 | 10/31/2024 |
| 2025.0.3-preview | 754 | 10/25/2024 |
| 2025.0.2-preview | 566 | 10/24/2024 |
| 2025.0.1-preview | 513 | 10/14/2024 |
| 2024.2.32 | 1,366 | 3/7/2025 |
| 2024.2.31 | 5,630 | 12/6/2024 |
| 2024.2.30 | 9,741 | 11/15/2024 |
| 2024.2.29 | 3,404 | 10/31/2024 |
| 2024.2.28 | 1,118 | 10/25/2024 |
| 2024.2.27 | 781 | 10/24/2024 |
| 2024.2.26 | 17,214 | 10/14/2024 |
| 2024.2.25 | 3,536 | 10/2/2024 |
| 2024.2.24 | 31,783 | 9/10/2024 |
| 2024.2.23 | 15,198 | 8/30/2024 |
| 2024.2.22 | 944 | 8/29/2024 |
| 2024.2.21 | 8,384 | 8/28/2024 |
| 2024.2.20 | 20,381 | 8/15/2024 |
| 2024.2.19 | 6,133 | 8/1/2024 |
| 2024.2.18 | 1,157 | 7/29/2024 |
| 2024.2.17-rc | 631 | 7/22/2024 |
| 2024.2.16-rc | 3,930 | 7/18/2024 |
| 2024.2.15-rc | 752 | 7/12/2024 |
| 2024.2.14-rc | 3,642 | 7/8/2024 |
| 2024.2.13-rc | 759 | 7/2/2024 |
| 2024.2.12-preview | 887 | 6/28/2024 |
| 2024.2.11-preview | 741 | 6/26/2024 |
| 2024.2.10-preview | 767 | 6/20/2024 |
| 2024.2.9-preview | 885 | 6/11/2024 |
| 2024.2.8-preview | 687 | 6/6/2024 |
| 2024.2.7-preview | 779 | 5/30/2024 |
| 2024.2.6-preview | 800 | 5/25/2024 |
| 2024.2.5-preview | 859 | 5/6/2024 |
| 2024.2.4-preview | 734 | 5/4/2024 |
| 2024.2.3-preview | 775 | 4/30/2024 |
| 2024.2.2-preview | 699 | 4/23/2024 |
| 2024.2.1-preview | 784 | 4/11/2024 |
| 2024.1.30 | 761 | 10/24/2024 |
| 2024.1.29 | 643 | 10/11/2024 |
| 2024.1.28 | 878 | 9/9/2024 |
| 2024.1.27 | 827 | 8/28/2024 |
| 2024.1.26 | 1,061 | 8/15/2024 |
| 2024.1.25 | 2,223 | 7/22/2024 |
| 2024.1.24 | 8,401 | 7/12/2024 |
| 2024.1.23 | 6,592 | 6/26/2024 |
| 2024.1.22 | 2,372 | 6/15/2024 |
| 2024.1.21 | 11,894 | 6/6/2024 |
| 2024.1.20 | 4,605 | 5/30/2024 |
| 2024.1.19 | 1,488 | 5/24/2024 |
| 2024.1.18 | 32,560 | 5/6/2024 |
| 2024.1.17 | 2,626 | 5/3/2024 |
| 2024.1.16 | 18,860 | 4/30/2024 |
| 2024.1.15 | 2,296 | 4/29/2024 |
| 2024.1.14 | 2,753 | 4/23/2024 |
| 2024.1.13 | 934 | 4/23/2024 |
| 2024.1.12 | 1,465 | 4/17/2024 |
| 2024.1.11-rc | 716 | 4/11/2024 |
| 2024.1.10-rc | 773 | 4/4/2024 |
| 2024.1.9-rc | 828 | 3/27/2024 |
| 2024.1.8-preview | 770 | 3/25/2024 |
| 2024.1.7-preview | 905 | 3/19/2024 |
| 2024.1.6-preview | 968 | 3/6/2024 |
| 2024.1.5-preview | 986 | 2/29/2024 |
| 2024.1.4-preview | 1,174 | 2/27/2024 |
| 2024.1.3-preview | 1,021 | 2/23/2024 |
| 2024.1.2-preview | 1,384 | 2/7/2024 |
| 2024.1.1-preview | 1,272 | 1/30/2024 |
| 2024.0.16 | 793 | 6/15/2024 |
| 2024.0.15 | 713 | 6/6/2024 |
| 2024.0.14 | 718 | 5/30/2024 |
| 2024.0.13 | 686 | 5/24/2024 |
| 2024.0.12 | 873 | 4/17/2024 |
| 2024.0.11 | 36,891 | 3/21/2024 |
| 2024.0.10 | 1,580 | 3/19/2024 |
| 2024.0.9 | 6,327 | 2/29/2024 |
| 2024.0.8 | 2,611 | 2/23/2024 |
| 2024.0.7 | 14,361 | 2/7/2024 |
| 2024.0.6 | 17,284 | 1/3/2024 |
| 2024.0.5-rc | 1,260 | 12/21/2023 |
| 2024.0.4-rc | 1,544 | 12/12/2023 |
| 2024.0.3-preview | 1,531 | 12/6/2023 |
| 2024.0.2-preview | 3,521 | 11/14/2023 |
| 2024.0.1-preview | 1,672 | 11/6/2023 |
| 2023.4.9 | 5,141 | 2/7/2024 |
| 2023.4.8 | 9,532 | 12/21/2023 |
| 2023.4.7 | 2,046 | 12/12/2023 |
| 2023.4.6 | 20,784 | 11/7/2023 |
| 2023.4.5-rc | 1,716 | 10/26/2023 |
| 2023.4.4-preview | 1,559 | 10/18/2023 |
| 2023.4.3-preview | 2,886 | 10/4/2023 |
| 2023.4.2-preview | 1,568 | 9/26/2023 |
| 2023.4.1-preview | 1,576 | 9/13/2023 |
| 2023.3.10 | 1,247 | 12/21/2023 |
| 2023.3.9 | 1,402 | 12/12/2023 |
| 2023.3.8 | 11,857 | 10/17/2023 |
| 2023.3.7-rc | 1,570 | 9/29/2023 |
| 2023.3.6-rc | 1,586 | 9/26/2023 |
| 2023.3.5-rc | 1,643 | 9/13/2023 |
| 2023.3.4-preview | 1,852 | 8/30/2023 |
| 2023.3.3-preview | 1,639 | 8/29/2023 |
| 2023.3.2-preview | 3,910 | 8/1/2023 |
| 2023.3.1-preview | 1,990 | 7/28/2023 |
| 2023.2.5 | 21,795 | 9/12/2023 |
| 2023.2.4 | 11,400 | 8/7/2023 |
| 2023.2.3-rc | 1,977 | 8/3/2023 |
| 2023.2.2-rc | 2,225 | 7/21/2023 |
| 2023.2.1-preview | 3,107 | 6/27/2023 |
| 2023.1.12 | 1,836 | 9/12/2023 |
| 2023.1.11 | 2,629 | 8/7/2023 |
| 2023.1.10 | 3,503 | 7/17/2023 |
| 2023.1.9 | 2,446 | 6/27/2023 |
| 2023.1.8-rc | 1,721 | 6/19/2023 |
| 2023.1.7-rc | 1,487 | 6/14/2023 |
| 2023.1.6-rc | 2,070 | 6/12/2023 |
| 2023.1.5-preview | 2,283 | 5/26/2023 |
| 2023.1.4-preview | 1,385 | 5/26/2023 |
| 2023.1.3-preview | 2,002 | 5/25/2023 |
| 2023.1.2-preview | 1,981 | 5/24/2023 |
| 2023.1.1-preview | 4,738 | 5/10/2023 |
| 2023.0.121 | 1,483 | 7/17/2023 |
| 2023.0.120 | 1,518 | 6/27/2023 |
| 2023.0.119 | 14,556 | 6/14/2023 |
| 2023.0.118 | 1,788 | 6/7/2023 |
| 2023.0.117 | 2,623 | 5/25/2023 |
| 2023.0.116 | 1,861 | 5/23/2023 |
| 2023.0.115 | 5,821 | 5/4/2023 |
| 2023.0.113-rc | 2,731 | 4/21/2023 |
| 2023.0.112-rc | 1,567 | 4/14/2023 |
| 2023.0.111-rc | 2,904 | 4/5/2023 |
| 2023.0.110-rc | 1,989 | 3/30/2023 |
| 2023.0.109-rc | 2,383 | 3/23/2023 |
| 2023.0.108-rc | 1,990 | 3/15/2023 |
| 2023.0.107-rc | 3,155 | 3/1/2023 |
| 2023.0.106-rc | 312 | 2/27/2023 |
| 2023.0.105-rc | 3,213 | 2/22/2023 |
| 2023.0.104-rc | 2,092 | 2/21/2023 |
| 2023.0.102-rc | 5,653 | 2/9/2023 |
| 2023.0.101-rc | 4,311 | 1/25/2023 |
| 0.5.83-preview | 2,365 | 1/23/2023 |
| 0.5.82-preview | 2,207 | 1/23/2023 |
| 0.5.81-preview | 2,137 | 1/18/2023 |
| 0.5.80-preview | 2,163 | 1/15/2023 |
| 0.5.79-preview | 2,094 | 1/13/2023 |
| 0.5.78-preview | 2,285 | 1/10/2023 |
| 0.5.77-preview | 2,042 | 1/9/2023 |
| 0.5.76-preview | 2,182 | 1/6/2023 |
| 0.5.75-preview | 2,116 | 1/5/2023 |
| 0.5.74-preview | 2,120 | 1/3/2023 |
| 0.5.73-preview | 2,884 | 12/15/2022 |
| 0.5.72-preview | 2,057 | 12/13/2022 |
| 0.5.71-preview | 2,702 | 12/10/2022 |
| 0.5.70-preview | 2,127 | 12/9/2022 |
| 0.5.69-preview | 2,061 | 12/8/2022 |
| 0.5.68-preview | 1,499 | 12/5/2022 |
| 0.5.67-preview | 1,643 | 12/2/2022 |
| 0.5.66-preview | 1,509 | 11/30/2022 |
| 0.5.65-preview | 1,407 | 11/30/2022 |
| 0.5.64-preview | 1,427 | 11/29/2022 |
| 0.5.63-preview | 2,136 | 11/25/2022 |
| 0.5.62-preview | 1,434 | 11/24/2022 |
| 0.5.61-preview | 1,360 | 11/17/2022 |
| 0.5.60-preview | 1,388 | 11/17/2022 |
| 0.5.59-preview | 1,319 | 11/16/2022 |
| 0.5.58-preview | 1,436 | 11/15/2022 |
| 0.5.57-preview | 1,474 | 11/10/2022 |
| 0.5.56-preview | 1,630 | 11/8/2022 |
| 0.5.55-preview | 1,405 | 11/3/2022 |
| 0.5.54-preview | 1,395 | 11/2/2022 |
| 0.5.53-preview | 1,373 | 11/1/2022 |
| 0.5.52-preview | 1,459 | 10/28/2022 |
| 0.5.51-preview | 2,095 | 10/27/2022 |
| 0.5.50-preview | 871 | 10/24/2022 |
| 0.5.49-preview | 430 | 10/20/2022 |
| 0.5.48-preview | 775 | 10/18/2022 |
| 0.5.47-preview | 700 | 10/12/2022 |
| 0.5.46-preview | 551 | 10/6/2022 |
| 0.5.45-preview | 331 | 10/6/2022 |
| 0.5.44-preview | 584 | 10/4/2022 |
| 0.5.43-preview | 625 | 10/1/2022 |
| 0.5.42-preview | 430 | 9/29/2022 |
| 0.5.41-preview | 877 | 9/28/2022 |
| 0.5.40-preview | 1,166 | 9/9/2022 |
| 0.5.39-preview | 516 | 9/6/2022 |
| 0.5.38-preview | 460 | 9/3/2022 |
| 0.5.37-preview | 1,507 | 8/19/2022 |
| 0.5.36-preview | 716 | 8/9/2022 |
| 0.5.35-preview | 406 | 8/6/2022 |
| 0.5.34-preview | 572 | 8/4/2022 |
| 0.5.33-preview | 265 | 8/2/2022 |
| 0.5.32-preview | 441 | 7/28/2022 |
| 0.5.31-preview | 397 | 7/26/2022 |
| 0.5.30-preview | 687 | 7/22/2022 |
| 0.5.29-preview | 621 | 7/21/2022 |
| 0.5.28-preview | 660 | 7/20/2022 |
| 0.5.27-preview | 360 | 7/19/2022 |
| 0.5.26-preview | 566 | 7/12/2022 |
| 0.5.25-preview | 935 | 6/25/2022 |
| 0.5.24-preview | 551 | 6/23/2022 |
| 0.5.23-preview | 1,039 | 6/7/2022 |
| 0.5.22-preview | 563 | 5/31/2022 |
| 0.5.21-preview | 410 | 5/27/2022 |
| 0.5.20-preview | 390 | 5/24/2022 |
| 0.5.19-preview | 797 | 5/17/2022 |
| 0.5.18-preview | 372 | 5/12/2022 |
| 0.5.16-preview | 418 | 5/9/2022 |
| 0.5.15-preview | 393 | 5/7/2022 |
| 0.5.13-preview | 802 | 4/28/2022 |
| 0.5.12-preview | 426 | 4/27/2022 |
| 0.5.11-preview | 411 | 4/15/2022 |
| 0.5.10-preview | 416 | 4/15/2022 |
| 0.5.9-preview | 356 | 4/14/2022 |
| 0.5.8-preview | 479 | 4/7/2022 |
| 0.5.7-preview | 417 | 3/22/2022 |
| 0.5.6-preview | 429 | 3/16/2022 |
| 0.5.5-preview | 408 | 3/15/2022 |
| 0.5.4-preview | 376 | 3/14/2022 |
| 0.5.3-preview | 383 | 3/9/2022 |
| 0.5.2-preview | 381 | 2/23/2022 |
| 0.5.1-preview | 411 | 2/18/2022 |
| 0.5.0-preview | 346 | 2/7/2022 |