From 7a1839f94af4031072d9b0aaa14f3fdf0acf5305 Mon Sep 17 00:00:00 2001
From: bk86a <41694587+bk86a@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:09:40 +0100
Subject: [PATCH] docs: add testing section to README and openpyxl to dev deps

Add Testing section to README describing validation against 134M real-world
postal codes from 8 public European datasets. Add openpyxl to
requirements-dev.txt for XLSX parsing in analysis scripts.
---
 README.md            | 3 +++
 requirements-dev.txt | 1 +
 2 files changed, 4 insertions(+)

diff --git a/README.md b/README.md
index be22b4a..2d651af 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,9 @@ Iceland (IS), Liechtenstein (LI), Norway (NO), Switzerland (CH)
 **EU candidate countries** (3):
 North Macedonia (MK), Serbia (RS), Türkiye (TR)
 
+## Testing
+
+The service has been tested against **134 million real-world postal codes** from 34 countries, sourced from 8 publicly available European datasets: GeoNames, GLEIF, TED, SIRENE, OffeneRegister, FTS, OpenAddresses, and Erasmus+ ECHE. All are open data published under permissive licenses (CC BY 4.0, CC0, or Licence Ouverte v2.0).
 
 ## Quick start
 
diff --git a/requirements-dev.txt b/requirements-dev.txt
index f4b6aab..68d0586 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -3,3 +3,4 @@ ruff>=0.7,<1
 bandit>=1.7,<2
 pip-audit>=2,<3
 pytest>=8,<9
+openpyxl>=3,<4