Metalama.Framework 2025.0.5-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.5-preview
                    
NuGet\Install-Package Metalama.Framework -Version 2025.0.5-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.5-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.5-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.5-preview
                    
#r "nuget: Metalama.Framework, 2025.0.5-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.5-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.5-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Metalama.Framework&version=2025.0.5-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.1.12 824 8/7/2025
2025.1.11 1,588 7/23/2025
2025.1.10 2,556 7/3/2025
2025.1.9 7,702 5/29/2025
2025.1.8 1,111 5/26/2025
2025.1.7 1,026 5/22/2025
2025.1.6 1,291 5/15/2025
2025.1.5 5,555 5/2/2025
2025.1.4-rc 1,120 4/15/2025
2025.1.3-rc 927 4/9/2025
2025.1.2-preview 744 4/1/2025
2025.1.1-preview 721 3/18/2025
2025.0.12 475 5/22/2025
2025.0.11 454 5/2/2025
2025.0.10 7,498 3/31/2025
2025.0.9 10,660 3/7/2025
2025.0.8 38,465 1/6/2025
2025.0.7-rc 1,791 12/6/2024
2025.0.6-rc 2,746 11/15/2024
2025.0.5-preview 2,130 11/8/2024
2025.0.4-preview 465 10/31/2024
2025.0.3-preview 753 10/25/2024
2025.0.2-preview 564 10/24/2024
2025.0.1-preview 512 10/14/2024
2024.2.32 1,363 3/7/2025
2024.2.31 5,621 12/6/2024
2024.2.30 9,704 11/15/2024
2024.2.29 3,401 10/31/2024
2024.2.28 1,115 10/25/2024
2024.2.27 778 10/24/2024
2024.2.26 17,081 10/14/2024
2024.2.25 3,533 10/2/2024
2024.2.24 31,450 9/10/2024
2024.2.23 15,005 8/30/2024
2024.2.22 941 8/29/2024
2024.2.21 8,365 8/28/2024
2024.2.20 20,357 8/15/2024
2024.2.19 6,126 8/1/2024
2024.2.18 1,154 7/29/2024
2024.2.17-rc 630 7/22/2024
2024.2.16-rc 3,929 7/18/2024
2024.2.15-rc 751 7/12/2024
2024.2.14-rc 3,641 7/8/2024
2024.2.13-rc 758 7/2/2024
2024.2.12-preview 886 6/28/2024
2024.2.11-preview 739 6/26/2024
2024.2.10-preview 766 6/20/2024
2024.2.9-preview 884 6/11/2024
2024.2.8-preview 686 6/6/2024
2024.2.7-preview 778 5/30/2024
2024.2.6-preview 799 5/25/2024
2024.2.5-preview 858 5/6/2024
2024.2.4-preview 733 5/4/2024
2024.2.3-preview 774 4/30/2024
2024.2.2-preview 698 4/23/2024
2024.2.1-preview 783 4/11/2024
2024.1.30 758 10/24/2024
2024.1.29 640 10/11/2024
2024.1.28 875 9/9/2024
2024.1.27 824 8/28/2024
2024.1.26 1,058 8/15/2024
2024.1.25 2,220 7/22/2024
2024.1.24 8,398 7/12/2024
2024.1.23 6,589 6/26/2024
2024.1.22 2,369 6/15/2024
2024.1.21 11,810 6/6/2024
2024.1.20 4,602 5/30/2024
2024.1.19 1,484 5/24/2024
2024.1.18 32,483 5/6/2024
2024.1.17 2,623 5/3/2024
2024.1.16 18,857 4/30/2024
2024.1.15 2,293 4/29/2024
2024.1.14 2,750 4/23/2024
2024.1.13 931 4/23/2024
2024.1.12 1,461 4/17/2024
2024.1.11-rc 715 4/11/2024
2024.1.10-rc 772 4/4/2024
2024.1.9-rc 827 3/27/2024
2024.1.8-preview 769 3/25/2024
2024.1.7-preview 904 3/19/2024
2024.1.6-preview 967 3/6/2024
2024.1.5-preview 984 2/29/2024
2024.1.4-preview 1,173 2/27/2024
2024.1.3-preview 1,020 2/23/2024
2024.1.2-preview 1,383 2/7/2024
2024.1.1-preview 1,271 1/30/2024
2024.0.16 790 6/15/2024
2024.0.15 710 6/6/2024
2024.0.14 715 5/30/2024
2024.0.13 683 5/24/2024
2024.0.12 870 4/17/2024
2024.0.11 36,842 3/21/2024
2024.0.10 1,577 3/19/2024
2024.0.9 6,323 2/29/2024
2024.0.8 2,608 2/23/2024
2024.0.7 14,358 2/7/2024
2024.0.6 17,280 1/3/2024
2024.0.5-rc 1,259 12/21/2023
2024.0.4-rc 1,543 12/12/2023
2024.0.3-preview 1,530 12/6/2023
2024.0.2-preview 3,485 11/14/2023
2024.0.1-preview 1,671 11/6/2023
2023.4.9 5,138 2/7/2024
2023.4.8 9,527 12/21/2023
2023.4.7 2,043 12/12/2023
2023.4.6 20,783 11/7/2023
2023.4.5-rc 1,715 10/26/2023
2023.4.4-preview 1,558 10/18/2023
2023.4.3-preview 2,885 10/4/2023
2023.4.2-preview 1,567 9/26/2023
2023.4.1-preview 1,575 9/13/2023
2023.3.10 1,244 12/21/2023
2023.3.9 1,399 12/12/2023
2023.3.8 11,852 10/17/2023
2023.3.7-rc 1,569 9/29/2023
2023.3.6-rc 1,585 9/26/2023
2023.3.5-rc 1,642 9/13/2023
2023.3.4-preview 1,849 8/30/2023
2023.3.3-preview 1,636 8/29/2023
2023.3.2-preview 3,907 8/1/2023
2023.3.1-preview 1,987 7/28/2023
2023.2.5 21,788 9/12/2023
2023.2.4 11,397 8/7/2023
2023.2.3-rc 1,974 8/3/2023
2023.2.2-rc 2,222 7/21/2023
2023.2.1-preview 3,104 6/27/2023
2023.1.12 1,835 9/12/2023
2023.1.11 2,626 8/7/2023
2023.1.10 3,500 7/17/2023
2023.1.9 2,443 6/27/2023
2023.1.8-rc 1,718 6/19/2023
2023.1.7-rc 1,484 6/14/2023
2023.1.6-rc 2,067 6/12/2023
2023.1.5-preview 2,280 5/26/2023
2023.1.4-preview 1,382 5/26/2023
2023.1.3-preview 1,999 5/25/2023
2023.1.2-preview 1,978 5/24/2023
2023.1.1-preview 4,735 5/10/2023
2023.0.121 1,480 7/17/2023
2023.0.120 1,515 6/27/2023
2023.0.119 14,553 6/14/2023
2023.0.118 1,785 6/7/2023
2023.0.117 2,620 5/25/2023
2023.0.116 1,858 5/23/2023
2023.0.115 5,818 5/4/2023
2023.0.113-rc 2,728 4/21/2023
2023.0.112-rc 1,564 4/14/2023
2023.0.111-rc 2,901 4/5/2023
2023.0.110-rc 1,986 3/30/2023
2023.0.109-rc 2,380 3/23/2023
2023.0.108-rc 1,987 3/15/2023
2023.0.107-rc 3,152 3/1/2023
2023.0.106-rc 309 2/27/2023
2023.0.105-rc 3,210 2/22/2023
2023.0.104-rc 2,089 2/21/2023
2023.0.102-rc 5,649 2/9/2023
2023.0.101-rc 4,308 1/25/2023
0.5.83-preview 2,362 1/23/2023
0.5.82-preview 2,204 1/23/2023
0.5.81-preview 2,134 1/18/2023
0.5.80-preview 2,160 1/15/2023
0.5.79-preview 2,091 1/13/2023
0.5.78-preview 2,282 1/10/2023
0.5.77-preview 2,039 1/9/2023
0.5.76-preview 2,179 1/6/2023
0.5.75-preview 2,113 1/5/2023
0.5.74-preview 2,117 1/3/2023
0.5.73-preview 2,881 12/15/2022
0.5.72-preview 2,054 12/13/2022
0.5.71-preview 2,699 12/10/2022
0.5.70-preview 2,124 12/9/2022
0.5.69-preview 2,057 12/8/2022
0.5.68-preview 1,496 12/5/2022
0.5.67-preview 1,640 12/2/2022
0.5.66-preview 1,506 11/30/2022
0.5.65-preview 1,404 11/30/2022
0.5.64-preview 1,424 11/29/2022
0.5.63-preview 2,133 11/25/2022
0.5.62-preview 1,431 11/24/2022
0.5.61-preview 1,357 11/17/2022
0.5.60-preview 1,385 11/17/2022
0.5.59-preview 1,316 11/16/2022
0.5.58-preview 1,433 11/15/2022
0.5.57-preview 1,471 11/10/2022
0.5.56-preview 1,627 11/8/2022
0.5.55-preview 1,402 11/3/2022
0.5.54-preview 1,392 11/2/2022
0.5.53-preview 1,370 11/1/2022
0.5.52-preview 1,456 10/28/2022
0.5.51-preview 2,092 10/27/2022
0.5.50-preview 868 10/24/2022
0.5.49-preview 427 10/20/2022
0.5.48-preview 772 10/18/2022
0.5.47-preview 697 10/12/2022
0.5.46-preview 548 10/6/2022
0.5.45-preview 328 10/6/2022
0.5.44-preview 581 10/4/2022
0.5.43-preview 622 10/1/2022
0.5.42-preview 427 9/29/2022
0.5.41-preview 874 9/28/2022
0.5.40-preview 1,163 9/9/2022
0.5.39-preview 513 9/6/2022
0.5.38-preview 457 9/3/2022
0.5.37-preview 1,506 8/19/2022
0.5.36-preview 715 8/9/2022
0.5.35-preview 405 8/6/2022
0.5.34-preview 571 8/4/2022
0.5.33-preview 264 8/2/2022
0.5.32-preview 440 7/28/2022
0.5.31-preview 396 7/26/2022
0.5.30-preview 686 7/22/2022
0.5.29-preview 620 7/21/2022
0.5.28-preview 659 7/20/2022
0.5.27-preview 359 7/19/2022
0.5.26-preview 565 7/12/2022
0.5.25-preview 934 6/25/2022
0.5.24-preview 550 6/23/2022
0.5.23-preview 1,038 6/7/2022
0.5.22-preview 562 5/31/2022
0.5.21-preview 409 5/27/2022
0.5.20-preview 389 5/24/2022
0.5.19-preview 796 5/17/2022
0.5.18-preview 371 5/12/2022
0.5.16-preview 417 5/9/2022
0.5.15-preview 392 5/7/2022
0.5.13-preview 801 4/28/2022
0.5.12-preview 425 4/27/2022
0.5.11-preview 409 4/15/2022
0.5.10-preview 415 4/15/2022
0.5.9-preview 355 4/14/2022
0.5.8-preview 478 4/7/2022
0.5.7-preview 416 3/22/2022
0.5.6-preview 428 3/16/2022
0.5.5-preview 407 3/15/2022
0.5.4-preview 375 3/14/2022
0.5.3-preview 382 3/9/2022
0.5.2-preview 380 2/23/2022
0.5.1-preview 410 2/18/2022
0.5.0-preview 345 2/7/2022