If you exclude a recipe that has custom directives, you get this quite vague error:

ParamExpandError: parameter fast out of range: fast=recipe_ocean_multimap

I used {% from 'inc/' ~ SITE ~ '-recipes.cylc' import FAST_RECIPES, MEDIUM_RECIPES %} because the more comprehensive {% include 'inc/' ~ SITE ~ '-recipes.cylc' %} wasn't working.

The Jinja2 docs suggest {% include 'inc/' ~ SITE ~ '-recipes.cylc' with context %} should resolve the problem - but it didn't.

I didn't try the Cylc docs namespace solution - it seemed more complex than the import solution.

• Q: I used is defined rather than != "" to avoid setting FAST/MEDIUM_RECIPES in the rose-suite.conf - but perhaps better that they are done the same way as SITE (or SITE is changed to work with is_defined too?).

Confirmed fine as is.

• 6c2f04b committed this for discussion only - it's way too complex?

Probably living with the standard error would be preferable:

• ParamExpandError: parameter fast out of range: fast=recipe_ocean_amoc does give a clue...
• Search for fast=recipe_ocean_amoc you'd find the problem location... though not the problem itself

Alternative solutions

• Definitely sure there is no CYLC_PARAMETERS_all we can iterate over?
• Capture the directives in the site inc page. E.g.

        {
            'recipe' :  'recipe_autoassess_landsurface_soilmoisture',
            'max_time' : 'PT2M',
            'max_memory' : '3G',
        },

In 50fe052, per discussion with @alistairsellar - completed/tidied up moving the custom directives out of the site.cylc file and into the site-recipes.cylc.

Documentation to be updated, pending wider discussion and tweaks with @ehogan after Xmas.

Documenting discussion with @ehogan

• Agreed with having the recipes list and their directives into site-recipes (splitting these details across two files, and generating a vague error if you delete the recipe is worth avoiding)

Additional changes

• Move out of inc and into site / retain the name site-recipes.cylc
  • opt has to be seperate for the CLI args to function; everything else is a site config so site makes sense
• Remove the default settings options / include the details for every recipe
• The fast/medium parameterisation is now generic / move out of site.cylc and into flow.cylc
• Update metoffice-recipes docstring
• Update docs / adding recipe process