Skip to content

Latest commit

 

History

History
100 lines (67 loc) · 3.51 KB

README.md

File metadata and controls

100 lines (67 loc) · 3.51 KB

Cylc-Rose Plugin

PyPI tests Codecov

A Cylc plugin providing support for the Rose rose-suite.conf file.

For use with Cylc 8 and Rose 2.

Installation

Install from PyPi:

pip install cylc-rose

Or Conda:

conda install cylc-rose

No further configuration is required, Cylc will load this plugin automatically.

Overview

In the past Rose provided a wrapper to Cylc providing additional capabilities including workflow installation.

As of Cylc 8 and Rose 2 some of this functionality has been re-built directly in Cylc, the rest has been migrated into this Plugin.

The last versions of Cylc and Rose which use the wrapper are:

  • Cylc 7
  • Rose 2019

For all later versions please install this plugin into your Cylc/Rose environment for Rose integration.

What This Plugin Does

This plugin provides support for the rose-suite.conf file, namely:

  • Jinja2/EmPy template variables.
  • Scheduler environment variables.
  • File installation.
  • Optional configurations.

What This Plugin Does Not Do

  • Support the root-dir* configurations, these have been deprecated by the new Cylc symlink dirs functionality.
  • Graphical configuration editors.

How It Works

For developer documentation, see DEVELOPING.

Contributing

Contributors Commit activity Last commit

Note: If also developing Cylc and or Rose you may wish to install cylc-rose in the same environment before installing cylc-rose.

pip install -e cylc-rose[all]

Copyright and Terms of Use

License

Copyright (C) 2008-2024 NIWA & British Crown (Met Office) & Contributors.

Cylc-rose is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Cylc-rose is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Cylc-rose. If not, see GNU licenses.