Developer Guide

Cylc recommendations

See the Cylc: Workflow Design Guide.

Run the tests locally

• Navigate to the workflow directory:

  cd <path_to>/CMEW/CMEW
  

• Run the workflow tests:

  export CYLC_VERSION=8
  cylc vip -O metoffice -O test
  

Build the documentation locally

• Activate the environment for the current session, where <version> is the version of ESMValTool to use (the following commands only need to be executed once per session):

  module load scitools/community/esmvaltool/<version>
  

• Build the documentation:

  cd <path_to>/CMEW/doc
  make html
  

• View the documentation:

  gio open build/html/index.html
  

Validate the workflow locally

• Navigate to the workflow directory:

  cd <path_to>/CMEW/CMEW
  

• Validate the Cylc workflow:

  cylc validate .
  

  Note: cylc validate only works after pre-processing Jinja2 branches.

• Run the Cylc configuration linter to help spot issues in unprocessed files:

  cylc lint
  

• Validate the format of Rose configuration files, and commit any changes:

  rose config-dump
  

• Validate the Rose configuration metadata:

  rose metadata-check -C meta/