Fabrics
Fabrics are classes that are executed at compile time. Unlike aspects, fabrics do not need to be explicitly added to a declaration. Fabrics are executed just because they exist in the code.
Fabrics are implemented in the Metalama.Framework.Fabrics namespace. See the namespace documentation for a class diagram.
Benefits
You can use fabrics in the following situations:
- Add aspects in bulk. Instead of adding aspects to each individual declaration with a custom attribute, you can add them programmatically in bulk. See Adding Aspects in Bulk from a Fabric for details.
- Validate code. You can add validation rules to your project or namespace using fabrics. See Validating Code with Fabrics for details.
- Configure an aspect library. When an aspect library exposes a configuration API, you can set the options from a project fabric.
In this chapter
This chapter contains the following articles:
| Article | Description |
|---|---|
| Kinds of Fabrics | This article describes the different kinds of fabrics and their abilities |
| Adding Aspects in Bulk from a Fabric | This article describes how to use fabrics to programmatically add aspects to several declarations - without custom attributes |
| Validating Code with Fabrics | This article explains how to validate code using fabrics. |
| Advising the Current Type | This article shows how to modify the current type using a type fabric without having to use a separate aspect class. |
| Configuring Aspects using Project Fabrics | This article explains how to use a project fabric to configure an aspect library. |
| Targeting Multiple Projects with Fabrics | This article explains how to target multiple projects with fabrics, either by using a shared fabric in the root directory of your repo, or by using transitive project fabrics. |
| Execution Order of Fabrics | This article explains in which order fabrics and aspects execute in a project. |