Release v1.1.0

.github/CODEOWNERS

@@ -1,10 +1,10 @@
 # See https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
 
-# Side-wide code owners:
+# Code owners:
 
 * @NaureenBharwaniNOAA @christinaholtNOAA @elcarpenterNOAA @fgabelmannjr @maddenp-noaa @weirae
 
-# Documentation-system config owners:
+# Documentation owners:
 
 .readthedocs.yaml @christinaholtNOAA @jprestop @maddenp-noaa
 docs/* @christinaholtNOAA @jprestop @maddenp-noaa

.github/ISSUE_TEMPLATE/bug_report.md

@@ -20,7 +20,7 @@ Your desired feature may already have an issue created!
 If so, please consider using that Issue to expand on the feature capabilities or requirements.
 
 Your bug may have already been reported!
-Please look through the existing issues on the [Issue tracker](https://github.com/ufs-community/workflow-tools/issues) to see if this issue has been created.
+Please look through the existing issues on the [Issue tracker](https://github.com/ufs-community/uwtools/issues) to see if this issue has been created.
 If so, please consider using that Issue to add any additional information.
 
 **Expected behavior**

.github/ISSUE_TEMPLATE/feature_request.md

@@ -18,7 +18,7 @@ Please copy any output files into a Github gist (for e.g.) and link to the gist,
 If this is a bug, please consider using the [Bug Report](./bug_report.md) template.
 Your issue may already have been created!
 
-Please look through the existing issues on the [Issue tracker](https://github.com/ufs-community/workflow-tools/issues) to see if this issue has been created.
+Please look through the existing issues on the [Issue tracker](https://github.com/ufs-community/uwtools/issues) to see if this issue has been created.
 If so, please consider using that Issue to add any additional information.
 
 **Description**

.github/pull_request_template.md

@@ -1,61 +1,39 @@
 <!--
-- - -  I N S T R U C T I O N S  --  P L E A S E  R E A D  - - -
-Please remove boiler plate instructions when filling out this template.
-Please remove unwanted/unrelated/irrelevant information such as comments provided as a reference in this template.
-Use proper formatting to separate code snippets from text description e.g. use ```code block``` or `in-line code`.
-Please copy any output files into a Github gist (for e.g.) and link to the gist, rather than relying on paths on platforms that might change or disappear.
-
-Before opening a PR, please note these guidelines:
-
-- Each PR should only address ONE topic and have an associated GitHub issue
-- No hardcoded or paths to personal directories should be present
-- No temporary or backup files should be committed
-- Any code that was disabled by being commented out should be removed
-- Please provide a on-line, but descriptive title to the PR e.g. Adds XYZ functionality or Fixes ABC bugs, etc.  DO NOT use branch names as titles.
--->
 
-**Description**
+INSTRUCTIONS
 
-<!-- Please include relevant motivation and context. -->
-<!-- Please include a summary of the change and which issue is fixed. -->
-<!-- List any dependencies that are required for this change. -->
+- Please do not commit temporary, backup, or binary files.
+- Please remove commented-out code.
+- Please ensure code, config files, etc., contain no hardcoded paths.
+- Please format code snippets in PR description/comments with ```code block``` or `inline code`.
+- Please consider adding your own review comments to guide other reviewers.
 
-<!-- Please provide reference to the issue this pull request is addressing. -->
-<!-- For e.g. Fixes #IssueNumber -->
+-->
 
-**Type of change**
+**Synopsis**
 
-Please delete options that are not relevant.
+<!-- A summary of the change, including relevant motivation, context, useful links, etc. -->
 
-- [ ] Bug fix (non-breaking change which fixes an issue)
-- [ ] New feature (non-breaking change which adds functionality)
-- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
-- [ ] This change requires a documentation update
+**Type**
 
-**How Has This Been Tested?**
+<!-- Select one or more -->
 
-<!-- Please describe the tests that you ran to verify your changes. -->
-<!-- Provide instructions so we can reproduce. -->
-<!-- Please also list any relevant details for your test configuration -->
+- [ ] Bug fix (corrects a known issue)
+- [ ] Code maintenance (refactoring, etc. without behavior change)
+- [ ] Documentation
+- [ ] Enhancement (adds a new functionality)
+- [ ] Tooling (CI, code-quality, packaging, revision-control, etc.)
 
-<!-- Use the following as a guide to list your tests and delete options that are not relevant. Expand as necessary. -->
-<!--
-- [ ] pytests in GitHub actions.
-- [ ] Tests on XYZ OS/HPC/CSP
--->
+**Impact**
 
-**Checklist**
+<!-- Select one -->
+
+- [ ] This is a non-breaking change (existing functionality continues to work as expected)
+- [ ] This is a breaking change (changes existing functionality)
 
-- [ ] My code follows the style guidelines of this project
-- [ ] I have performed a self-review of my own code
-- [ ] I have commented my code, particularly in hard-to-understand areas
-- [ ] My changes need updates to the documentation.  I have made corresponding changes to the documentation
-- [ ] My changes generate no new warnings
-- [ ] New and existing tests pass with my changes
-- [ ] Any dependent changes have been merged and published
+**Checklist**
 
-<!-- 
- If there is a co-author attribution:
+<!-- Affirm -->
 
-Update the final commit message (when squashing and merging) to include  `Co-authored-by: name <[email protected]>` (e.g. `Co-authored-by: Jane Doe <[email protected]>`).  Each co-author must have their own line, and the email address used must be the email address connected with their GitHub account.
--->
+- [ ] I have added myself and any co-authors to the PR's _Assignees_ list.
+- [ ] I have reviewed the documentation and have made any updates necessitated by this change.

.github/scripts/common.sh

@@ -0,0 +1,9 @@
+# Shared resources for workflow scripts.
+
+CI_CONDA_DIR=/tmp/conda
+CI_CONDA_SH=$CI_CONDA_DIR/etc/profile.d/conda.sh
+
+ci_conda_activate() {
+  source $CI_CONDA_SH
+  conda activate
+}

.github/scripts/format-check.sh

@@ -0,0 +1,17 @@
+# Actions invokes script with: bash -e <script>
+
+set -a
+
+unformatted() {
+  set -x
+  make format
+  if [[ -n "$(git status --porcelain)" ]]; then
+    (set +x && echo UNFORMATTED CODE DETECTED)
+    return 1
+  fi
+  return 0
+}
+
+source $(dirname ${BASH_SOURCE[0]})/common.sh
+ci_conda_activate
+CONDEV_SHELL_CMD=unformatted condev-shell

.github/scripts/install-conda.sh

@@ -0,0 +1,11 @@
+# Actions invokes script with: bash -e <script>
+
+set -ux
+source $(dirname ${BASH_SOURCE[0]})/common.sh
+url=https://github.com/conda-forge/miniforge/releases/download/23.1.0-4/Miniforge3-23.1.0-4-Linux-x86_64.sh
+installer=/tmp/$(basename $url)
+wget --no-verbose -O $installer $url
+bash $installer -bfp $CI_CONDA_DIR
+set +ux
+ci_conda_activate
+conda install --quiet --yes --channel maddenp --repodata-fn repodata.json anaconda-client condev

.github/scripts/link-check.sh

@@ -0,0 +1,9 @@
+# Actions invokes script with: bash -e <script>
+
+set -a
+
+source $(dirname ${BASH_SOURCE[0]})/common.sh
+ci_conda_activate
+cd docs
+source install-deps
+make linkcheck

.github/scripts/make-package.sh

@@ -0,0 +1,6 @@
+# Actions invokes script with: bash -e <script>
+
+source $(dirname ${BASH_SOURCE[0]})/common.sh
+ci_conda_activate
+set -x
+make package

.github/scripts/publish → .github/scripts/publish.sh

@@ -1,8 +1,7 @@
-#!/bin/bash -eux
+# Actions invokes script with: bash -e <script>
 
-set +ux
-source conda/etc/profile.d/conda.sh
-conda activate
+source $(dirname ${BASH_SOURCE[0]})/common.sh
+ci_conda_activate
 set -ux
 f=recipe/meta.json
 glob="$(jq -r .name $f)-$(jq -r .version $f)-*_$(jq -r .buildnum $f).tar.bz2"

.github/scripts/tag-check → .github/scripts/tag-check.sh

@@ -1,5 +1,6 @@
-#!/bin/bash -eux
+# Actions invokes script with: bash -e <script>
 
+set -ux
 f=recipe/meta.json
 tag=v$(jq -r .version $f)-$(jq -r .buildnum $f)
 if git ls-remote --tags origin | grep -q "/$tag$"; then

.github/scripts/tag-create → .github/scripts/tag-create.sh

@@ -1,5 +1,6 @@
-#!/bin/bash -eux
+# Actions invokes script with: bash -e <script>
 
+set -ux
 f=recipe/meta.json
 tag=v$(jq -r .version $f)-$(jq -r .buildnum $f)
 git tag $tag

.github/scripts/test.sh

@@ -0,0 +1,22 @@
+# Actions invokes script with: bash -e <script>
+
+set -a
+
+SUPPORTED_PYTHON_VERSIONS=( 3.9 3.10 3.11 )
+
+run_tests() {
+  echo TESTING PYTHON $PYTHON_VERSION
+  conda install --quiet --yes --repodata-fn repodata.json python=$PYTHON_VERSION
+  set -x
+  pip install --editable src # set new Python version in entry-point scripts
+  python --version
+  make test
+  return $?
+}
+
+source $(dirname ${BASH_SOURCE[0]})/common.sh
+ci_conda_activate
+for version in ${SUPPORTED_PYTHON_VERSIONS[*]}; do
+  PYTHON_VERSION=$version
+  CONDEV_SHELL_CMD=run_tests condev-shell
+done

.github/workflows/release.yaml

@@ -1,4 +1,4 @@
-name: release
+name: Release
 env:
   ANACONDA_TOKEN: ${{ secrets.ANACONDA_TOKEN }}
 on:
@@ -12,12 +12,16 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - name: Install conda
-        run:  .github/scripts/install-conda
+        run:  .github/scripts/install-conda.sh
+      - name: Docs Link Check
+        run: .github/scripts/link-check.sh
+      - name: Format Check
+        run:  .github/scripts/format-check.sh
       - name: Make Package
-        run:  .github/scripts/make-package
+        run:  .github/scripts/make-package.sh
       - name: Check For Existing Tag
-        run:  .github/scripts/tag-check
+        run:  .github/scripts/tag-check.sh
       - name: Tag
-        run: .github/scripts/tag-create
+        run: .github/scripts/tag-create.sh
       - name: Publish
-        run: .github/scripts/publish
+        run: .github/scripts/publish.sh