👌 Template: improve Hatch environments

Make several improvements to the template Hatch environments:

- Use `uv` as the installer for each environment by setting it in the `default` one.
- Instead of having a custom `tests` environment, use the built-in `hatch-test` one.
  Moreover, set up a test matrix for all supported Python versions. This allows template
  users to run the test suite with `hatch test`, and easily select a Python version
  with `-py` or run all supported versions with `--all`. We explicitly configure the
  environment to simply run `pytest` without any additional default arguments, and
  without parallelization or randomization to make `hatch test` correspond to a regular
  `pytest` run.
- Rename the `precommit` environment to `pre-commit`. The package and command are
  hyphenated, and so it's better to also do this for the environment for consistency.

The Hatch `check` script of the template package is updated to reflect the last change,
and we also add a `test` script that copies the template and runs its tests.

Author: mbercx

docs/developer.md

@@ -27,6 +27,7 @@ Other scripts for the default environment:
 * `check`: Copy/Update the template in the `.tmp` directory and check the rendered files by linting them with `hatch fmt -l`.
 * `clean`: Remove the `.tmp` directory and any Ruff caches.
 * `install`: Copy/Update the template in the `.tmp` directory and install it with `uv pip install`.
+* `test`: Copy/Update the template in the `.tmp` directory run the test suite with `pytest`.
 
 ## Documentation
 

pyproject.toml

@@ -13,7 +13,11 @@ scripts.install = [
 ]
 scripts.check = [
   "copier copy --vcs-ref=HEAD . .tmp/py-package -f",
-  "cd .tmp/py-package && hatch run precommit:run -av",
+  "cd .tmp/py-package && hatch run pre-commit:run -av",
+]
+scripts.test = [
+  "copier copy --vcs-ref=HEAD . .tmp/py-package -f",
+  "cd .tmp/py-package && hatch test -v -- -s",
 ]
 scripts.clean = [
   "ruff clean",

template/pyproject.toml.jinja

@@ -24,6 +24,9 @@ classifiers = [
 [tool.hatch.version]
 path = "src/{{ package_name.lower().replace('-', '_') }}/__about__.py"
 
+[tool.hatch.envs.default]
+installer = 'uv'
+
 {% if docs == 'myst'-%}
 [tool.hatch.envs.docs]
 dependencies = [
@@ -44,14 +47,19 @@ scripts.serve = "mkdocs serve --dev-addr localhost:8000"
 scripts.deploy = "mkdocs gh-deploy --force"
 {%- endif %}
 
-[tool.hatch.envs.precommit]
+[tool.hatch.envs.pre-commit]
 dependencies = ["pre-commit"]
 scripts.install = "pre-commit install"
-scripts.run = "pre-commit run {args:--all-files}"
+scripts.run = "pre-commit run {args}"
 
-[tool.hatch.envs.tests]
+[tool.hatch.envs.hatch-test]
 dependencies = ["pytest"]
-scripts.run = "pytest {args}"
+randomize = false
+parallel = false
+run = "pytest {args}"
+
+[[tool.hatch.envs.hatch-test.matrix]]
+python = ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
 [tool.ruff]
 lint.ignore = [