How to use preconditions
When running recipes, there may come a time when you want to restrict which files the recipe runs against. For example, if your company has a large mono-repo, and you only work on part of it, you may want to run a recipe on just that part. Similarly, if you are working on a security or best practice update, you may want to focus only on product code and not on tests.
This is what preconditions were designed for. They are a way of restricting where a recipe is run.
In this guide, we'll walk through how preconditions work and how you can use them in the Moderne Platform.
How preconditions work
Preconditions, at their core, are just recipes that run before the current list of recipes you're wanting to run. When a recipe is used as a precondition, any file that it would make a change to is considered to meet the precondition. When more than one recipe is used as a precondition, all of them must make a change to the file for it to be considered to meet the precondition.
Only when all preconditions are met will the recipes in the recipe list be run.
Changes made by preconditions are not included in the final result of the recipe. Changes made by preconditions are used only to determine if the recipe should be run.
Example
To help clarify this, let's consider the case where you want to run a recipe against non-test files in a specific module in a mono-repo.
To meet this need, you would want two precondition recipes: find files by source path and find files that are likely not tests.
The first precondition recipe could be provided with a path such as mono-repo/your-team. When that precondition recipe is run, it would step through every file in the mono-repo and "mark" every file that exists in the directory you specified. Then, the second precondition recipe would run and it, too, would step through every file and "mark" those that are likely not tests.
With the preconditions being done, the core recipe you're wanting to run will then step through the files and only make changes to the ones that were marked by both of the preconditions. Please note that these marks do not appear in the final results.
How to use preconditions in the Moderne Platform
From the recipe marketplace, find the recipe you'd like to use as a precondition. Once you've found it, click on the Add to Builder button and then select Add as a precondition checkbox:
You can then either choose to add the precondition to a recipe you've already created or you can create a new recipe entirely. To add it to a recipe you've already created, click on the recipe name and then press Add to selected. To create a new recipe with this as a precondition, press Add to new recipe. Regardless of which one you picked, you'll be redirected to the
You will then be redirected to the recipe builder page. Preconditions are always highlighted to show that they're a precondition and not a recipe being run:
If you want to add more preconditions, you can follow the same steps as above. When you're ready to run the recipe, follow the instructions in our recipe builder guide.