CDA Regex Guide

Several cwms-cli subcommands pass regex filters directly to CWMS Data API endpoints. Common examples include:

These options use CDA endpoint regex semantics. cwms-cli does not convert shell wildcards such as * into regex for you.

Examples

Exact match:

^Black Butte$

Prefix match:

^Black Butte.*

Contains match:

.*Butte.*

Regex OR:

(PROJECT|STREAM)

Use ^ and $ when you want an exact match.
Use .* for wildcard-style matching.
Quote regex values in the shell so characters such as ^, $, |, and () are passed through unchanged.
When a command fetches one exact returned ID, it escapes that ID before building a follow-up regex so literal characters stay literal.