Skip to content

docs: fix the Hatch scripts and nox mamba examples so they run - #833

Open
simonvanlierde wants to merge 1 commit into
pyOpenSci:mainfrom
simonvanlierde:fix-hatch-nox-examples
Open

simonvanlierde wants to merge 1 commit into
pyOpenSci:mainfrom
simonvanlierde:fix-hatch-nox-examples

Conversation

@simonvanlierde

Copy link
Copy Markdown
Contributor

Hi!

Two config examples fail when copied.

  • tutorials/develop-python-package-hatch.md: detached = true sat inside [tool.hatch.envs.build.scripts], and hatch 1.18.1 rejects it ("must be a string or an array of strings"). The environment already sets it, so I removed the line, fixed the comment to build:check, and wrote the flag as TOML true in the prose.
  • tests/run-tests-nox.md: session.conda_install(".[tests]") hands . to mamba as a package name, so the solve fails. It now installs pytest from conda-forge with conda_install, then the package with session.install("."). I left out the --no-deps the nox docs add there, so pip still installs any dependency the reader didn't get from conda.

Tests: nox -s docs-test passes, and so do the translated builds. I ran both snippets in a container (hatch 1.18.1, nox 2026.10.20 on miniforge): both fail as published and work fixed.

Best,

Simon

- hatch tutorial: drop detached = true from the scripts table, where
  hatch rejects it, fix the build:check command name, and write the
  flag as TOML true in the prose
- nox: install pytest with conda_install and the package with pip,
  since conda_install(".[tests]") cannot solve
@netlify

netlify Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for python-package-guide ready!

Name Link
🔨 Latest commit 06f2814
🔍 Latest deploy log https://app.netlify.com/projects/python-package-guide/deploys/6adbabf33d69f152e6cd85cf
😎 Deploy Preview https://deploy-preview-833--python-package-guide.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

This branch has not been deployed

No deployments
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.

1 participant