🧪📦 Add packaging envs to tox

They include cleaning the dist dir, producing the dists and
verifying their metadata.

Author: webknjaz

pyproject.toml

@@ -6,6 +6,9 @@ requires = [
 build-backend = 'hatchling.build'
 
 [dependency-groups]
+building = [
+  'build',
+]
 linting = [
   'pre-commit',
 ]
@@ -16,6 +19,9 @@ testing = [
   'pytest-mock',  # provides a `mocker` fixture
   'pytest-xdist',  # paralellizes tests through subprocesses
 ]
+upstreaming = [
+  'twine',
+]
 
 [project]
 name = 'pre-commit-terraform'

tox.ini

@@ -102,6 +102,64 @@ set_env =
 wheel_build_env = .pkg
 
 
+[testenv:cleanup-dists]
+description =
+  Wipe the the dist{/} folder
+dependency_groups =
+commands_pre =
+commands =
+  {envpython} \
+    {[python-cli-options]byte-errors} \
+    {[python-cli-options]max-isolation} \
+    {[python-cli-options]warnings-to-errors} \
+    -c \
+      'import os, shutil, sys; \
+      dists_dir = "{toxinidir}{/}dist{/}"; \
+      shutil.rmtree(dists_dir, ignore_errors=True); \
+      sys.exit(os.path.exists(dists_dir))'
+commands_post =
+package = skip
+
+
+[testenv:build-dists]
+description =
+  Build dists with {basepython} and put them into the dist{/} folder
+dependency_groups =
+  building
+depends =
+  cleanup-dists
+commands =
+  {envpython} \
+    {[python-cli-options]byte-errors} \
+    {[python-cli-options]max-isolation} \
+    {[python-cli-options]warnings-to-errors} \
+    -m build \
+      {posargs:}
+commands_post =
+package = skip
+
+
+[testenv:metadata-validation]
+description =
+  Verify that dists under the `dist{/}` dir
+  have valid metadata
+dependency_groups =
+  upstreaming
+depends =
+  build-dists
+commands =
+  {envpython} \
+    {[python-cli-options]byte-errors} \
+    {[python-cli-options]max-isolation} \
+    {[python-cli-options]warnings-to-errors} \
+    -m twine \
+      check \
+      --strict \
+      dist{/}*
+commands_post =
+package = skip
+
+
 [testenv:pre-commit]
 description =
   Run the quality checks under {basepython}; run as