Added spell checking functionality to pre-commit hooks and Makefile.

.pre-commit-config.yaml

@@ -20,7 +20,7 @@ repos:
   - repo: https://github.com/asottile/pyupgrade
     rev: v3.20.0
     hooks:
-    -   id: pyupgrade
+      - id: pyupgrade
         args:
           - --py39-plus
 
@@ -61,7 +61,7 @@ repos:
       - id: pyproject-fmt
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: '1.6.0'
+    rev: "1.6.0"
     hooks:
       - id: tox-ini-fmt
 

Makefile

@@ -1,3 +1,7 @@
+-include cspell/Makefile
+
+.PHONY: spellcheck
+
 help:
 	@echo "Usage: make <target>"
 	@echo "    check         run pre-commit and tests"
@@ -7,15 +11,24 @@ help:
 	@echo "    package       build package distribution"
 	@echo "    pre-commit    run pre-commit against all files"
 	@echo "    setup         setup development environment"
+	@echo "    spellcheck    run spell check across the repository (code, docs, l10n)"
 	@echo "    test          run tests (in parallel)"
 	@echo "    tox           run tox (in parallel)"
 
 check:
 	make l10n
 	make pre-commit
 	make doc
+	make spellcheck
 	make test
 
+sort-custom-dict:
+	python tools/sort_cspell_dict.py
+
+spellcheck: sort-custom-dict
+	@command -v docker >/dev/null 2>&1 || { echo "ERROR: docker not found. Install Docker or skip spellcheck."; exit 127; }
+	$(MAKE) cspell-check
+
 clean:
 	@for ext in mo pot pyc; do \
 		find . -type f -name "*.$$ext" -delete; \

cspell/Dockerfile

@@ -0,0 +1,24 @@
+FROM node:20-alpine
+
+# Set working directory for node modules installation
+WORKDIR /app
+
+# Copy package.json and package-lock.json to install dependencies
+COPY package.json package-lock.json ./
+
+# Install cspell and dictionaries locally using npm ci with security flags
+RUN npm ci --ignore-scripts --no-audit --no-fund && npm cache clean --force
+
+# Set working directory for the application
+WORKDIR /holidays
+
+# Copy cspell configuration and custom dictionary
+COPY cspell.json cspell/cspell.json
+COPY custom-dict.txt cspell/custom-dict.txt
+
+# Use non-root user for security
+USER node
+
+# Set entrypoint to local cspell binary
+ENTRYPOINT ["/app/node_modules/.bin/cspell"]
+CMD ["--help"]

cspell/Makefile

@@ -0,0 +1,20 @@
+.PHONY: cspell-install cspell-check cspell-run sort-custom-dict
+
+cspell-install:
+	@which docker > /dev/null 2>&1 || (echo "ERROR: docker not found in PATH. Install Docker."; exit 1)
+	@DOCKER_BUILDKIT=1 docker build \
+	$(if $(FORCE),--no-cache,) \
+	-f cspell/Dockerfile \
+	cspell \
+	-t cspell
+
+cspell-check: CMD=--no-progress -r /holidays
+cspell-check: cspell-install cspell-run
+
+	@docker run \
+	--mount type=bind,src="$(CURDIR)",dst=/holidays,readonly \
+	--rm \
+	cspell lint -c cspell/cspell.json $(CMD)
+
+sort-custom-dict:
+	@python tools/sort_cspell_dict.py

cspell/cspell.json

@@ -0,0 +1,108 @@
+{
+  "allowCompoundWords": false,
+  "caseSensitive": false,
+  "language": "en",
+  "minWordLength": 3,
+  "dictionaryDefinitions": [
+    {
+      "addWords": true,
+      "name": "custom-dict",
+      "path": "custom-dict.txt"
+    }
+  ],
+  "dictionaries": [
+    "ar",
+    "bg-bg",
+    "bn",
+    "ca",
+    "companies",
+    "cs-cz",
+    "da-dk",
+    "de-at",
+    "de-ch",
+    "de-de",
+    "el",
+    "en_us",
+    "en-au",
+    "en-ca",
+    "en-common-misspellings",
+    "en-gb",
+    "eo",
+    "es-es",
+    "et-ee",
+    "eu",
+    "fa-ir",
+    "fi-fi",
+    "fr-fr",
+    "gd",
+    "gl-es",
+    "grc",
+    "he",
+    "hr-hr",
+    "hu-hu",
+    "hy",
+    "id-id",
+    "it-it",
+    "la",
+    "lt-lt",
+    "lv",
+    "makefile",
+    "markdown",
+    "mk",
+    "mn-mn",
+    "nb-no",
+    "nl-nl",
+    "pl-pl",
+    "pt-br",
+    "pt-pt",
+    "python",
+    "ro-ro",
+    "ru-ru",
+    "scientific-terms-gb",
+    "sk-sk",
+    "sl-si",
+    "sr-cyrl",
+    "sr-latn",
+    "sv",
+    "software-terms",
+    "tr-tr",
+    "uk-ua",
+    "vi-vn",
+    "custom-dict"
+  ],
+  "enabled": true,
+  "files": [
+    "docs/**/*",
+    "README.md",
+    "scripts/l10n/**/*",
+    "mkdocs.yml"
+  ],
+  "ignorePaths": [
+    "node_modules/**",
+    ".git/**",
+    ".venv/**",
+    "__pycache__/**",
+    "*.pyc",
+    "dist/**",
+    "build/**",
+    ".mypy_cache/**",
+    ".pytest_cache/**",
+    "docs/_build/**",
+    "snapshots/**",
+    "*.egg-info/**",
+    ".tox/**",
+    "requirements/*.txt",
+    "cspell/dictionaries/**"
+  ],
+  "ignoreRegExpList": [
+    "#\\w+",
+    "<@\\w+>",
+    "\\b[A-Z]{2,}\\b",
+    "\\b[A-Z][a-z]+\\s+[A-Z][a-z]+\\b",
+    "\\b\\d+\\b",
+    "\\b[A-Za-z]+_[A-Za-z]+\\b",
+    "\\bhttps?:\\/\\/[^\\s]+\\b"
+  ],
+
+  "useGitignore": true
+}

cspell/custom-dict.txt

@@ -0,0 +1 @@
+# Project-specific terms\n

cspell/make.cmd

@@ -0,0 +1,44 @@
+@echo off
+setlocal enabledelayedexpansion
+
+set TARGET=%1
+
+if "%TARGET%"=="cspell-check" goto cspell-check
+if "%TARGET%"=="cspell-install" goto cspell-install
+if "%TARGET%"=="cspell-run" goto cspell-run
+if "%TARGET%"=="sort-custom-dict" goto sort-custom-dict
+
+echo Usage: make.cmd ^<target^>
+echo     cspell-check      run cspell check
+echo     cspell-install    install cspell docker image
+echo     cspell-run        run cspell (placeholder)
+echo     sort-custom-dict  sort and uniquify custom-dict.txt
+goto end
+
+:cspell-install
+where docker >nul 2>nul
+if %errorlevel% neq 0 (
+    echo ERROR: docker not found in PATH. Install Docker Desktop or add docker.exe to PATH.
+    goto end
+)
+set "build_args="
+if defined FORCE set "build_args=--no-cache"
+set "DOCKER_BUILDKIT=true" && docker build %build_args% -f cspell/Dockerfile -t cspell cspell
+goto end
+
+:cspell-run
+rem Placeholder for cspell-run
+goto end
+
+:sort-custom-dict
+python tools/sort_cspell_dict.py
+goto end
+
+:cspell-check
+set CMD=--no-progress -r /holidays
+call :cspell-install
+call :cspell-run
+docker run --mount type=bind,src="%CD%",dst=/holidays,readonly --rm cspell lint -c cspell/cspell.json %CMD%
+goto end
+
+:end