chore(docs): move Python tooling out of the Go module

.github/dependabot.yml

@@ -107,7 +107,7 @@ updates:
       rebase-strategy: disabled
     - package-ecosystem: pip
       directories:
-        - /
+        - /docs-site
       schedule:
         interval: monthly
         day: sunday

Makefile

@@ -36,7 +36,7 @@ serve-docs:
 	docker run --rm --name $(DOCS_CONTAINER) -it -p 8000:8000 \
 		-v $(PWD):/testcontainers-go \
 		-w /testcontainers-go \
-		$(DOCS_IMAGE) bash -c "pip install -Ur requirements.txt && mkdocs serve -f mkdocs.yml -a 0.0.0.0:8000"
+		$(DOCS_IMAGE) bash -c "pip install -Ur docs-site/requirements.txt && mkdocs serve -f mkdocs.yml -a 0.0.0.0:8000"
 
 ## --------------------------------------
 

docs-site/go.mod

@@ -0,0 +1,8 @@
+// This module only exists to keep the Python tooling used to build the docs site
+// (https://golang.testcontainers.org) out of the github.com/testcontainers/testcontainers-go
+// module: the Go toolchain excludes any directory containing a go.mod file from the parent
+// module's zip, so these files no longer land in users' module caches and vendor directories,
+// where they were picked up by dependency scanners. It contains no Go code and is never released.
+module github.com/testcontainers/testcontainers-go/docs-site
+
+go 1.26.0

netlify.toml

@@ -0,0 +1,8 @@
+# Netlify build configuration for the docs site (https://golang.testcontainers.org).
+# The Python dependencies live in docs-site, so that they are not part of the Go module.
+[build]
+  command = "pip install -r docs-site/requirements.txt && mkdocs build"
+  publish = "site"
+
+[build.environment]
+  PYTHON_VERSION = "3.13"

scripts/changed-modules.sh

@@ -71,7 +71,7 @@ set -euxo pipefail
 readonly ROOT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
 
 # define an array of modules that won't be included in the list
-readonly excluded_modules=(".devcontainer" ".vscode" "docs")
+readonly excluded_modules=(".devcontainer" ".vscode" "docs" "docs-site")
 
 # define an array of files that won't be included in the list
 readonly excluded_files=(
@@ -96,11 +96,9 @@ readonly excluded_files=(
     "CONTRIBUTING.md"
     "LICENSE"
     "mkdocs.yml"
-    "Pipfile*"
+    "netlify.toml"
     "README.md"
     "RELEASING.md"
-    "requirements.txt"
-    "runtime.txt"
     "docs/usage-metrics/core.csv"
     "docs/usage-metrics/modules.csv"
     "docs/usage-metrics/clones.csv"