Add syrupy pytest plugin and poe snapup command

copier.yaml

@@ -137,6 +137,16 @@ enable_docs:
   help: Enable documentation site (Zensical{% if project_visibility == 'public' %} with deployment to GitHub Pages{% endif %})?
   default: yes
 
+enable_features:
+  type: str
+  qmark: 🧩
+  help: Enable miscellaneous features?
+  multiselect: true
+  choices:
+    pytest-syrupy for snapshots: syrupy
+    pytest-xdist for multiprocessing: xdist
+  default: '["syrupy", "xdist"]'
+
 user_name:
   type: str
   qmark: 🧑

includes/docs.jinja

@@ -57,6 +57,17 @@ The `lint` and `test` tasks can also be run as a single combined command with:
 ```sh
 poe lt
 ```
+{%- if "syrupy" in enable_features %}
+
+### Test snapshots
+
+Some tests compare test results with saved snapshots. Test snapshots can be
+updated by running:
+
+```sh
+poe snapup
+```
+{%- endif %}
 {%- if enable_docs %}
 
 {{h}}## Documentation server

pyproject.toml

@@ -47,8 +47,8 @@ dev = [
     "pytest-cov>=7",
     "pytest-sugar>=1",
     "pytest-xdist>=3",
-    "syrupy>=5",
     "ruff>=0.15",
+    "syrupy>=5",
     "ty>=0.0.37",
 ]
 docs = [
@@ -132,7 +132,7 @@ sequence = [
 help = "Install project dependencies and git hooks"
 
 [tool.poe.tasks.snapup]
-cmd = "pytest --snapshot-update"
+cmd = "pytest --snapshot-update --numprocesses 0"
 help = "Update test snapshots"
 
 [tool.poe.tasks.test]
@@ -169,7 +169,7 @@ executor = {isolated = true, python = "3.14"}
 help = "Run tests using Python 3.14"
 
 [tool.poe.tasks.ti]
-cmd = "pytest -n 0 --no-cov -v"
+cmd = "pytest --numprocesses 0 --no-cov -v"
 help = "Run tests with debug friendly options"
 
 [tool.pytest]
@@ -178,7 +178,7 @@ addopts = [
     "--cov=copier_python",
     "--strict-config",
     "--strict-markers",
-    "-n",
+    "--numprocesses",
     "auto",
 ]
 testpaths = ["tests"]

template/pyproject.toml.jinja

@@ -52,8 +52,13 @@ dev = [
     "pytest>=9",
     "pytest-cov>=7",
     "pytest-sugar>=1",
+{%- if "xdist" in enable_features %}
     "pytest-xdist>=3",
+{%- endif %}
     "ruff>=0.15",
+{%- if "syrupy" in enable_features %}
+    "syrupy>=5",
+{%- endif %}
     "ty>=0.0.37",
 ]
 {%- if enable_docs %}
@@ -144,6 +149,12 @@ sequence = [
     {cmd = "prek install"},
 ]
 help = "Install project dependencies and git hooks"
+{%- if "syrupy" in enable_features %}
+
+[tool.poe.tasks.snapup]
+cmd = "pytest --snapshot-update{% if "xdist" in enable_features %} --numprocesses 0{% endif %}"
+help = "Update test snapshots"
+{%- endif %}
 
 [tool.poe.tasks.test]
 cmd = "pytest"
@@ -163,7 +174,7 @@ executor = {isolated = true, python = "{{ v }}"}
 help = "Run tests using Python {{ v }}"
 {% endcall %}
 [tool.poe.tasks.ti]
-cmd = "pytest -n 0 --no-cov -v"
+cmd = "pytest --numprocesses 0 --no-cov -v"
 help = "Run tests with debug friendly options"
 
 [tool.pytest]
@@ -172,8 +183,10 @@ addopts = [
     "--cov={{ project_slug }}",
     "--strict-config",
     "--strict-markers",
-    "-n",
+{%- if "xdist" in enable_features %}
+    "--numprocesses",
     "auto",
+{%- endif %}
 ]
 testpaths = ["tests"]
 

tests/__snapshots__/test_contributing.ambr

@@ -83,6 +83,15 @@
   poe lt
   ```
 
+  ### Test snapshots
+
+  Some tests compare test results with saved snapshots. Test snapshots can be
+  updated by running:
+
+  ```sh
+  poe snapup
+  ```
+
   ### Applying copier-python template updates
 
   Copier can update your project with template changes that have occurred since