Metalama.Framework 2025.0.1-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.1-preview
                    
NuGet\Install-Package Metalama.Framework -Version 2025.0.1-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.1-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.1-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.1-preview
                    
#r "nuget: Metalama.Framework, 2025.0.1-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.1-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.1-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Metalama.Framework&version=2025.0.1-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.11 560 7/23/2025
2025.1.10 1,792 7/3/2025
2025.1.9 6,516 5/29/2025
2025.1.8 1,038 5/26/2025
2025.1.7 1,018 5/22/2025
2025.1.6 1,275 5/15/2025
2025.1.5 5,444 5/2/2025
2025.1.4-rc 1,116 4/15/2025
2025.1.3-rc 922 4/9/2025
2025.1.2-preview 734 4/1/2025
2025.1.1-preview 717 3/18/2025
2025.0.12 463 5/22/2025
2025.0.11 450 5/2/2025
2025.0.10 7,081 3/31/2025
2025.0.9 9,999 3/7/2025
2025.0.8 37,668 1/6/2025
2025.0.7-rc 1,787 12/6/2024
2025.0.6-rc 2,741 11/15/2024
2025.0.5-preview 2,125 11/8/2024
2025.0.4-preview 461 10/31/2024
2025.0.3-preview 746 10/25/2024
2025.0.2-preview 559 10/24/2024
2025.0.1-preview 504 10/14/2024
2024.2.32 1,357 3/7/2025
2024.2.31 5,610 12/6/2024
2024.2.30 9,651 11/15/2024
2024.2.29 3,393 10/31/2024
2024.2.28 1,109 10/25/2024
2024.2.27 773 10/24/2024
2024.2.26 16,992 10/14/2024
2024.2.25 3,527 10/2/2024
2024.2.24 30,917 9/10/2024
2024.2.23 14,177 8/30/2024
2024.2.22 936 8/29/2024
2024.2.21 8,318 8/28/2024
2024.2.20 20,222 8/15/2024
2024.2.19 6,119 8/1/2024
2024.2.18 1,143 7/29/2024
2024.2.17-rc 626 7/22/2024
2024.2.16-rc 3,922 7/18/2024
2024.2.15-rc 746 7/12/2024
2024.2.14-rc 3,635 7/8/2024
2024.2.13-rc 754 7/2/2024
2024.2.12-preview 882 6/28/2024
2024.2.11-preview 735 6/26/2024
2024.2.10-preview 761 6/20/2024
2024.2.9-preview 880 6/11/2024
2024.2.8-preview 682 6/6/2024
2024.2.7-preview 774 5/30/2024
2024.2.6-preview 794 5/25/2024
2024.2.5-preview 851 5/6/2024
2024.2.4-preview 727 5/4/2024
2024.2.3-preview 770 4/30/2024
2024.2.2-preview 693 4/23/2024
2024.2.1-preview 776 4/11/2024
2024.1.30 750 10/24/2024
2024.1.29 636 10/11/2024
2024.1.28 870 9/9/2024
2024.1.27 820 8/28/2024
2024.1.26 1,053 8/15/2024
2024.1.25 2,215 7/22/2024
2024.1.24 8,391 7/12/2024
2024.1.23 6,583 6/26/2024
2024.1.22 2,364 6/15/2024
2024.1.21 11,675 6/6/2024
2024.1.20 4,598 5/30/2024
2024.1.19 1,479 5/24/2024
2024.1.18 30,912 5/6/2024
2024.1.17 2,617 5/3/2024
2024.1.16 18,852 4/30/2024
2024.1.15 2,289 4/29/2024
2024.1.14 2,745 4/23/2024
2024.1.13 925 4/23/2024
2024.1.12 1,456 4/17/2024
2024.1.11-rc 710 4/11/2024
2024.1.10-rc 766 4/4/2024
2024.1.9-rc 824 3/27/2024
2024.1.8-preview 765 3/25/2024
2024.1.7-preview 898 3/19/2024
2024.1.6-preview 964 3/6/2024
2024.1.5-preview 979 2/29/2024
2024.1.4-preview 1,169 2/27/2024
2024.1.3-preview 1,014 2/23/2024
2024.1.2-preview 1,380 2/7/2024
2024.1.1-preview 1,268 1/30/2024
2024.0.16 786 6/15/2024
2024.0.15 702 6/6/2024
2024.0.14 710 5/30/2024
2024.0.13 677 5/24/2024
2024.0.12 866 4/17/2024
2024.0.11 36,779 3/21/2024
2024.0.10 1,571 3/19/2024
2024.0.9 6,319 2/29/2024
2024.0.8 2,604 2/23/2024
2024.0.7 14,348 2/7/2024
2024.0.6 17,275 1/3/2024
2024.0.5-rc 1,256 12/21/2023
2024.0.4-rc 1,539 12/12/2023
2024.0.3-preview 1,527 12/6/2023
2024.0.2-preview 3,441 11/14/2023
2024.0.1-preview 1,668 11/6/2023
2023.4.9 5,134 2/7/2024
2023.4.8 9,521 12/21/2023
2023.4.7 2,040 12/12/2023
2023.4.6 20,777 11/7/2023
2023.4.5-rc 1,711 10/26/2023
2023.4.4-preview 1,553 10/18/2023
2023.4.3-preview 2,881 10/4/2023
2023.4.2-preview 1,562 9/26/2023
2023.4.1-preview 1,570 9/13/2023
2023.3.10 1,240 12/21/2023
2023.3.9 1,393 12/12/2023
2023.3.8 11,833 10/17/2023
2023.3.7-rc 1,564 9/29/2023
2023.3.6-rc 1,580 9/26/2023
2023.3.5-rc 1,637 9/13/2023
2023.3.4-preview 1,842 8/30/2023
2023.3.3-preview 1,628 8/29/2023
2023.3.2-preview 3,898 8/1/2023
2023.3.1-preview 1,978 7/28/2023
2023.2.5 21,752 9/12/2023
2023.2.4 11,390 8/7/2023
2023.2.3-rc 1,965 8/3/2023
2023.2.2-rc 2,214 7/21/2023
2023.2.1-preview 3,096 6/27/2023
2023.1.12 1,831 9/12/2023
2023.1.11 2,618 8/7/2023
2023.1.10 3,493 7/17/2023
2023.1.9 2,432 6/27/2023
2023.1.8-rc 1,710 6/19/2023
2023.1.7-rc 1,475 6/14/2023
2023.1.6-rc 2,058 6/12/2023
2023.1.5-preview 2,271 5/26/2023
2023.1.4-preview 1,374 5/26/2023
2023.1.3-preview 1,990 5/25/2023
2023.1.2-preview 1,968 5/24/2023
2023.1.1-preview 4,726 5/10/2023
2023.0.121 1,472 7/17/2023
2023.0.120 1,507 6/27/2023
2023.0.119 14,537 6/14/2023
2023.0.118 1,776 6/7/2023
2023.0.117 2,611 5/25/2023
2023.0.116 1,849 5/23/2023
2023.0.115 5,810 5/4/2023
2023.0.113-rc 2,720 4/21/2023
2023.0.112-rc 1,555 4/14/2023
2023.0.111-rc 2,891 4/5/2023
2023.0.110-rc 1,976 3/30/2023
2023.0.109-rc 2,371 3/23/2023
2023.0.108-rc 1,977 3/15/2023
2023.0.107-rc 3,139 3/1/2023
2023.0.106-rc 300 2/27/2023
2023.0.105-rc 3,201 2/22/2023
2023.0.104-rc 2,078 2/21/2023
2023.0.102-rc 5,638 2/9/2023
2023.0.101-rc 4,299 1/25/2023
0.5.83-preview 2,354 1/23/2023
0.5.82-preview 2,195 1/23/2023
0.5.81-preview 2,126 1/18/2023
0.5.80-preview 2,151 1/15/2023
0.5.79-preview 2,081 1/13/2023
0.5.78-preview 2,273 1/10/2023
0.5.77-preview 2,029 1/9/2023
0.5.76-preview 2,169 1/6/2023
0.5.75-preview 2,103 1/5/2023
0.5.74-preview 2,108 1/3/2023
0.5.73-preview 2,873 12/15/2022
0.5.72-preview 2,045 12/13/2022
0.5.71-preview 2,690 12/10/2022
0.5.70-preview 2,116 12/9/2022
0.5.69-preview 2,049 12/8/2022
0.5.68-preview 1,487 12/5/2022
0.5.67-preview 1,632 12/2/2022
0.5.66-preview 1,498 11/30/2022
0.5.65-preview 1,396 11/30/2022
0.5.64-preview 1,415 11/29/2022
0.5.63-preview 2,124 11/25/2022
0.5.62-preview 1,423 11/24/2022
0.5.61-preview 1,348 11/17/2022
0.5.60-preview 1,376 11/17/2022
0.5.59-preview 1,306 11/16/2022
0.5.58-preview 1,423 11/15/2022
0.5.57-preview 1,462 11/10/2022
0.5.56-preview 1,612 11/8/2022
0.5.55-preview 1,394 11/3/2022
0.5.54-preview 1,384 11/2/2022
0.5.53-preview 1,362 11/1/2022
0.5.52-preview 1,447 10/28/2022
0.5.51-preview 2,083 10/27/2022
0.5.50-preview 859 10/24/2022
0.5.49-preview 414 10/20/2022
0.5.48-preview 763 10/18/2022
0.5.47-preview 687 10/12/2022
0.5.46-preview 539 10/6/2022
0.5.45-preview 318 10/6/2022
0.5.44-preview 572 10/4/2022
0.5.43-preview 612 10/1/2022
0.5.42-preview 418 9/29/2022
0.5.41-preview 864 9/28/2022
0.5.40-preview 1,154 9/9/2022
0.5.39-preview 504 9/6/2022
0.5.38-preview 449 9/3/2022
0.5.37-preview 1,496 8/19/2022
0.5.36-preview 703 8/9/2022
0.5.35-preview 394 8/6/2022
0.5.34-preview 561 8/4/2022
0.5.33-preview 254 8/2/2022
0.5.32-preview 429 7/28/2022
0.5.31-preview 384 7/26/2022
0.5.30-preview 676 7/22/2022
0.5.29-preview 610 7/21/2022
0.5.28-preview 647 7/20/2022
0.5.27-preview 347 7/19/2022
0.5.26-preview 551 7/12/2022
0.5.25-preview 923 6/25/2022
0.5.24-preview 539 6/23/2022
0.5.23-preview 1,027 6/7/2022
0.5.22-preview 552 5/31/2022
0.5.21-preview 398 5/27/2022
0.5.20-preview 378 5/24/2022
0.5.19-preview 786 5/17/2022
0.5.18-preview 359 5/12/2022
0.5.16-preview 406 5/9/2022
0.5.15-preview 380 5/7/2022
0.5.13-preview 790 4/28/2022
0.5.12-preview 412 4/27/2022
0.5.11-preview 398 4/15/2022
0.5.10-preview 404 4/15/2022
0.5.9-preview 345 4/14/2022
0.5.8-preview 468 4/7/2022
0.5.7-preview 405 3/22/2022
0.5.6-preview 418 3/16/2022
0.5.5-preview 396 3/15/2022
0.5.4-preview 362 3/14/2022
0.5.3-preview 371 3/9/2022
0.5.2-preview 369 2/23/2022
0.5.1-preview 399 2/18/2022
0.5.0-preview 334 2/7/2022