Metalama.Framework
v2025.0.4-previewPre-release
.NETStandard2.0
Metalama. A tool for aspect-oriented programming (AOP) using templates written in pure C#.
Published
Oct 31, 2024
1y ago
Total Downloads
1.5M
1,543,694
Known Vulnerabilities (1)
Moderate
View AdvisoryInstall
dotnet add package Metalama.Framework --version 2025.0.4-preview
| Product | Versions |
|---|---|
| .NET Standard |
README
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 [email protected].
You can also join our Slack community and ask your technical questions in real time.
Changes from Previous Version
No structural changes between v2025.0.3-preview and v2025.0.4-preview.
Adoption Assessment
A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.
This version is marked prerelease. Validate its API and upgrade path before production use.Published vulnerability advisories exist for this version. Read the advisory and choose a remediated version before release.No SPDX license expression is published. Review the license text and your organisation's policy before redistribution.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.