Enh: align tests section better with our lessons#604
Draft
lwasser wants to merge 6 commits intopyOpenSci:mainfrom
Draft
Enh: align tests section better with our lessons#604lwasser wants to merge 6 commits intopyOpenSci:mainfrom
lwasser wants to merge 6 commits intopyOpenSci:mainfrom
Conversation
lwasser
commented
Jan 13, 2026
| font-display: swap; | ||
| font-family: "NunitoSans"; | ||
| font-style: italic; | ||
| font-weight: 400; |
Member
Author
There was a problem hiding this comment.
This has been bugging me - turns out it was just a css glitch!
| @@ -0,0 +1,172 @@ | |||
| ```{eval-rst} | |||
Member
Author
There was a problem hiding this comment.
Here i pulled the nox content out of the main run tests page so we don't cover 2 tools on one page which i think it confusing. But I don't want to abandon Nox as it's a really great tool. And if we ever decided hatch development wasn't solid enough in the task runner area we would migrate back to nox.
| @nox.session(python=["3.9", "3.10", "3.11", "3.12"]) | ||
| def test(session): | ||
| ```bash | ||
| hatch run test.py3.11:pytest |
Member
Author
There was a problem hiding this comment.
Suggested change
| hatch run test.py3.11:pytest | |
| hatch run test.py3.11:run |
Member
Author
There was a problem hiding this comment.
This might be wrong actually...
Comment on lines
+321
to
+324
| **Both tools are solid choices.** The Python scientific community uses both | ||
| extensively. For a complete guide to Nox, see [Run tests with | ||
| Nox](run-tests-nox.md) and the [Scientific Python testing | ||
| guide](https://scientific-python.org/tools/testing). |
Member
Author
There was a problem hiding this comment.
Suggested change
| **Both tools are solid choices.** The Python scientific community uses both | |
| extensively. For a complete guide to Nox, see [Run tests with | |
| Nox](run-tests-nox.md) and the [Scientific Python testing | |
| guide](https://scientific-python.org/tools/testing). | |
| **Both tools are good choices.** For a more comprehensive guide to using Nox, see [Run tests with | |
| Nox](run-tests-nox.md) and the [Scientific Python testing | |
| guide](https://scientific-python.org/tools/testing). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I am working on videos on test suites and task runners for our course. And the test section of our guide is dated.
We use Nox in the guide, which I love, but our lessons and template use Hatch. So this tries to clean things up, cross-link, and add the nox content to a new page, replacing the old page with Hatch (our template default).
It also makes sure we are following brand guidelines and crosslinks throughout
A few notes:
I still need to go through and edit this again via review before it is ready.
Claude made some breaking changes to things like how we call hatch environments and define them in the pyproject.toml file. So I want to review again to catch anything else that may have broken. Because Claude was involved, I broke out commits into sets of files as I worked on them.