Skip to content

adding in an rst linter#796

Open
laurenchilutti wants to merge 3 commits intoNOAA-GFDL:mainfrom
laurenchilutti:rstlint
Open

adding in an rst linter#796
laurenchilutti wants to merge 3 commits intoNOAA-GFDL:mainfrom
laurenchilutti:rstlint

Conversation

@laurenchilutti
Copy link
Copy Markdown
Member

@laurenchilutti laurenchilutti commented Mar 25, 2026

Describe your changes

Issue ticket number and link (if applicable)

This PR fixes #810

Checklist before requesting a review

  • I ran my code
  • I tried to make my code readable
  • I tried to comment my code
  • I wrote a new test, if applicable
  • I wrote new instructions/documentation, if applicable
  • I ran pytest and inspected it's output
  • I ran pylint and attempted to implement some of it's feedback
  • No print statements; all user-facing info uses logging module

Note: If you are a code maintainer updating the tag or releasing a new fre-cli version, please use the release_procedure.md template. To quickly use this template, open a new pull request, choose your branch, and add ?template=release_procedure.md to the end of the url.

@codecov
Copy link
Copy Markdown

codecov bot commented Mar 25, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.12%. Comparing base (836559e) to head (81f314c).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #796   +/-   ##
=======================================
  Coverage   84.12%   84.12%           
=======================================
  Files          71       71           
  Lines        4944     4944           
=======================================
  Hits         4159     4159           
  Misses        785      785           
Flag Coverage Δ
unittests 84.12% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.


Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 836559e...81f314c. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Comment on lines +12 to +21
- name: Code Checkout
uses: actions/checkout@v4
- name: Make Sphinx Requirements
run: |
echo "sphinx" > requirements.txt
echo "sphinx_rtd_theme" >> requirements.txt
echo "sphinx_design" >> requirements.txt
echo "sphinx-sitemap" >> requirements.txt
echo "sphinxcontrib-mermaid" >> requirements.txt
echo "doc8" >> requirements.txt
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you can stick these under pyproject.toml's optional-dependencies section for docs

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay - let me see: also, not sure I need to have all of thee sphinx's installed. Might just need our typical docs dependencies + doc8.

- name: Install Python Requirements
run: |
pip install -r requirements.txt
pip install doc8
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as above, and then do pip install .[docs]

i guess, as an alternative, we could put this requirements file in docs/

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Regardless of the method chosen (requirement.txt or pip install .[docs]), you will want to add documentation somewhere with the steps to set up the documentation build, and how to run the lint process.

Take a look at the RDHPCS CONTRIBUTING.md file.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@laurenchilutti
Copy link
Copy Markdown
Member Author

@ilaflott Qhat did you change in the last commit? I can't tell

@ilaflott
Copy link
Copy Markdown
Member

@ilaflott Qhat did you change in the last commit? I can't tell

i updated your branch via rebase to integrate recent changes addressing testing failures in fre.cmor- your PRs checks had those same failures

@laurenchilutti
Copy link
Copy Markdown
Member Author

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

rst linter

3 participants