FRE-CLI

FMS Runtime Environment (FRE) CLI developed using Python's Click package

• Sphinx Page
• Project Outline

Background

As part of fre/canopy, MSD wanted to develop a modern, user-friendly CLI that will allow users to call upon FRE commands using a fre tool subtool syntax. Developed with Click, a Python package easily installable through PyPI and Conda, the main goal of this is to allow users access to most, if not all of MSD-managed tools and workflows from one packaged, centralized CLI.

Usage (Users)

(Method 1) User - with Lmod

• If you want to hit the ground running:
  • Cannot install local changes on top via pip
  • GFDL Workstation: module load fre/canopy
  • Gaea: module load fre/canopy

(Method 2) User - Conda Environment Activation

• If you want to hit the ground running, but have some flexibility in including other things without full development options available to you:

  • Can install local changes on top via pip
  • GFDL Workstation:
    • module load miniforge
    • conda activate /nbhome/fms/conda/envs/fre-cli
  • Gaea:
    • module load miniforge
    • conda activate /ncrc/home2/Flexible.Modeling.System/conda/envs/fre-cli

(Method 3) Developer - Conda Environment Building

• If you have Conda loaded and want to create your OWN environment for development, testing, etc.:

  • Can install local changes on top via pip
  • Create a new Conda environment: conda create -n [environmentName]
  • Append necessary channels
    • conda config --append channels noaa-gfdl
    • conda config --append channels conda-forge
  • Run conda install on needed dependencies (conda install click will give you access to pip as well)
    • conda install noaa-gfdl::fre-cli should install the CLI package created from the meta.yaml
  • All other dependencies used by the tools are installed along with this install (configured inside the meta.yaml), with the exception of local modules
  • setup.py file allows fre.py to be ran with fre as the entry point on the command line instead of python fre.py
  • For further notes on development and contributing to fre-cli see CONTRIBUTING.md

After one of the above, one can enter commands and follow --help messages for guidance. A brief rundown of commands to be provided are within each tool's folder as a README.md

Further Notes on Use

Following the instructions above, the user will be able to run fre from any directory, listing all command groups. These include e.g. run, make, and pp. The list of available subcommands for each group will be shown upon inclusion of the --help flag. The user will be alerted to any missing arguments required subcomands. Optional arguments will only shown with --help added to the subcommand. Note that argument flags are not positional, and can be specified in any order.

Checklist: Currently Implemented Tools

To be developed:

• fre check
• fre app
• fre catalog
• fre list
• fre make
• fre cmor
• fre run
• fre test
• fre yamltools