Oh, AI also provided a script (I did not ask for)!
#!/bin/bash
FUZZY_DIR="$HOME/.gramps/gramps52/plugins/Fuzzy"
# 1. Corriger FuzzyMatchingGramplet.py
sed -i '/^from __future__ import annotations$/d' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
sed -i 's/from __future__ import annotations//' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
sed -i 's/from typing import /from typing import Dict, List, Optional, Set, /' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
sed -i 's/dict\[str, list\[str\]\]/Dict[str, List[str]]/g' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
sed -i 's/list\[str\]/List[str]/g' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
sed -i 's/set\[str\]/Set[str]/g' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
sed -i 's/str | None/Optional[str]/g' "$FUZZY_DIR/FuzzyMatchingGramplet.py"
# 2. Corriger phonetic_codes.py
sed -i '/^from __future__ import annotations$/d' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/from typing import .*/from types import ModuleType\\nfrom typing import Dict, List, Set, Callable, Iterable, Optional, Tuple, Any/' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/list\[ModuleType\]/List[ModuleType]/g' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/dict\[str, Callable\[/Dict[str, Callable[/g' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/\] , set\[str\]/], Set[str]/g' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/dict\[str, str\]/Dict[str, str]/g' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/tuple\[/Tuple[/g' "$FUZZY_DIR/phonetic_codes.py"
sed -i 's/str | None/Optional[str]/g' "$FUZZY_DIR/phonetic_codes.py"
# 3. Corriger TOUS les fichiers dans encoders/
for file in "$FUZZY_DIR"/encoders/*.py; do
if [ -f "$file" ]; then
sed -i '/^from __future__ import annotations$/d' "$file"
sed -i 's/from __future__ import annotations//' "$file"
sed -i 's/list\[/List[/g' "$file"
sed -i 's/dict\[/Dict[/g' "$file"
sed -i 's/set\[/Set[/g' "$file"
sed -i 's/tuple\[/Tuple[/g' "$file"
sed -i 's/str | None/Optional[str]/g' "$file"
# Ajouter l'import typing si nécessaire
if ! grep -q \"from typing import\" "$file"; then
sed -i '/^import /a from typing import Dict, List, Optional, Set, Tuple' "$file"
fi
fi
done
echo "✅ Tous les fichiers corrigés !"
Also asked for a custom “set of rules” (above one):
#
# Gramps - a GTK+/GNOME based genealogy program
#
# Copyright (C) 2025 Custom Soundex Implementation
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
#
"""
Custom Soundex encoder with specific consonant mappings.
Consonant mappings:
B,P,V,F -> B
C,K,Q,G,J -> C
S,Z,X -> S
D,T -> D
L -> L
M,N -> M
R -> R
Special combinations:
PH -> F
KN -> N
GH -> removed
WR -> R
"""
# Compatible with Python 3.6
from typing import Set
LOG = None # Will be set by the importing module
#: Registry key
ALGORITHM_ID = "soundex_custom"
#: Display label
ALGORITHM_LABEL = "Soundex Custom"
# Consonant mapping rules
_CONSONANT_MAP = {
'B': 'B', 'P': 'B', 'V': 'B', 'F': 'B',
'C': 'C', 'K': 'C', 'Q': 'C', 'G': 'C', 'J': 'C',
'S': 'S', 'Z': 'S', 'X': 'S',
'D': 'D', 'T': 'D',
'L': 'L',
'M': 'M', 'N': 'M',
'R': 'R'
}
# Special combinations (applied first)
_SPECIAL_COMBINATIONS = [
('PH', 'F'),
('KN', 'N'),
('GH', ''), # removed
('WR', 'R')
]
def _clean_and_upper(name: str) -> str:
"""Keep only letters, convert to uppercase."""
return ''.join(c for c in name if c.isalpha()).upper()
def _apply_special_combinations(name: str) -> str:
"""Apply special multi-character combinations first."""
for old, new in _SPECIAL_COMBINATIONS:
name = name.replace(old, new)
return name
def _map_consonants(name: str) -> str:
"""Map individual consonants according to the rules."""
return ''.join(_CONSONANT_MAP.get(c, c) for c in name)
def _remove_duplicates(name: str) -> str:
"""Remove consecutive duplicate letters."""
if not name:
return name
result = [name[0]]
for c in name[1:]:
if c != result[-1]:
result.append(c)
return ''.join(result)
def _pad_to_four(code: str) -> str:
"""Pad code with zeros to 4 characters."""
return (code + '000')[:4]
def _soundex_custom(name: str) -> str:
"""
Compute custom Soundex code.
Steps:
1. Keep first letter
2. Apply special combinations
3. Map consonants
4. Remove duplicates
5. Remove vowels (except first)
6. Pad to 4 characters
"""
if not name:
return '0000'
cleaned = _clean_and_upper(name)
if not cleaned:
return '0000'
# Keep first letter
first_letter = cleaned[0]
rest = cleaned[1:]
# Apply special combinations to the rest
rest = _apply_special_combinations(rest)
# Map consonants
rest = _map_consonants(rest)
# Remove vowels from rest
rest = ''.join(c for c in rest if c not in 'AEIOUY')
# Remove duplicates
rest = _remove_duplicates(rest)
# Combine and pad
code = first_letter + rest
return _pad_to_four(code)
def encode(name: str) -> Set[str]:
"""
Return the Soundex code as a set (for compatibility with phonetic_codes.py).
:param name: The surname to encode.
:returns: A one-element set containing the 4-character Soundex code.
"""
try:
code = _soundex_custom(name)
return {code}
except Exception:
if LOG:
LOG.debug("Soundex custom encoding failed for %r", name)
return {'0000'}
# Test cases
if __name__ == "__main__":
# Test the examples
tests = [
("STEPHEN", "SDBM"), # S-T[D]-[e]-PH[F->B]-[e]-N[M]
("ASHCRAFT", "ASCR"), # A-S[S]-H-C[C]-R[R]-A-F[B]-T[D]
("KNIGHT", "NCD"), # KN[N]-I-GH-T[D]
]
for name, expected in tests:
result = _soundex_custom(name)
print(f"{name} -> {result} (expected: {expected}) {'✓' if result == expected else '✗'}")
or a pseudo phonetic_french one:
#
# Gramps - a GTK+/GNOME based genealogy program
#
# Copyright (C) 2025 Custom French Phonetic Encoder
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
#
"""
Custom French phonetic encoder for the Fuzzy Matching Gramplet.
Implements a 16-step French phonetic transformation algorithm.
"""
# Compatible with Python 3.6
import re
import unicodedata
from typing import Set
LOG = None # Will be set by the importing module
#: Registry key
ALGORITHM_ID = "phonetic_french"
#: Display label
ALGORITHM_LABEL = "French Phonetic"
def encode(name: str) -> Set[str]:
"""
Apply the 16-step French phonetic transformation.
:param name: The surname to encode.
:returns: A one-element set containing the phonetic code.
"""
try:
# Step 0: Convert to string and normalize
strval = str(name)
r = unicodedata.normalize('NFKD', strval.upper().strip()).encode('ASCII', 'ignore').decode('ASCII')
# Step 1: Replace Y by I
r = r.replace('Y', 'I')
# Step 2: Replace accented E by Y
r = r.replace(u'É', 'Y')
r = r.replace(u'È', 'Y')
r = r.replace(u'Ê', 'Y')
# Step 3: Remove H not preceded by C, S, or P
r = re.sub(r'([^CSP])H', r'\1', r)
# Step 4: Replace PH by F
r = r.replace('PH', 'F')
# Step 5: Replace G followed by A, AI, AM, AN by K
r = re.sub(r'G(AI?[N|M])', r'K\1', r)
# Step 6: Replace vowel+I+N/M followed by vowel
r = re.sub(r'([A|E]I[N|M])([A|E|I|O|U])', r'YN\2', r)
# Step 7: Replace specific groups (water sounds)
r = r.replace('EAU', 'O')
r = r.replace('OUA', '2')
r = r.replace('EIN', '4')
r = r.replace('AIN', '4')
r = r.replace('EIM', '4')
r = r.replace('AIM', '4')
# Step 8: Replace AI, EI, ER, ESS, ET, EZ
r = r.replace('AI', 'Y')
r = r.replace('EI', 'Y')
r = r.replace('ER', 'YR')
r = r.replace('ESS', 'YS')
r = r.replace('ET', 'YT')
r = r.replace('EZ', 'YZ')
# Step 9: Replace AN, ON, AM, EN, EM, IN (not followed by vowel or sound 1-4)
r = re.sub(r'AN([^A|E|I|O|U|1|2|3|4])', r'1\1', r)
r = re.sub(r'ON([^A|E|I|O|U|1|2|3|4])', r'1\1', r)
r = re.sub(r'AM([^A|E|I|O|U|1|2|3|4])', r'1\1', r)
r = re.sub(r'EN([^A|E|I|O|U|1|2|3|4])', r'1\1', r)
r = re.sub(r'EM([^A|E|I|O|U|1|2|3|4])', r'1\1', r)
r = re.sub(r'IN([^A|E|I|O|U|1|2|3|4])', r'4\1', r)
# Step 10: Replace S by Z (between vowels or sounds 1-4)
r = re.sub(r'([A|E|I|O|U|Y|1|2|3|4])S([A|E|I|O|U|Y|1|2|3|4])', r'\1Z\2', r)
# Step 11: Replace specific groups
r = r.replace('OE', 'E')
r = r.replace('EU', 'E')
r = r.replace('AU', 'O')
r = r.replace('OI', '2')
r = r.replace('OY', '2')
r = r.replace('OU', '3')
# Step 12: Replace CH, SCH, SH, SS, SC
r = r.replace('CH', '5')
r = r.replace('SCH', '5')
r = r.replace('SH', '5')
r = r.replace('SS', 'S')
r = r.replace('SC', 'S')
# Step 13: Replace C by S (before E or I)
r = re.sub(r'C([E|I])', r'S\1', r)
# Step 14: Replace letters
r = r.replace('C', 'K')
r = r.replace('Q', 'K')
r = r.replace('QU', 'K')
r = r.replace('GU', 'K')
r = r.replace('GA', 'KA')
r = r.replace('GO', 'KO')
r = r.replace('GY', 'KY')
# Step 15: Replace remaining letters
r = r.replace('A', 'O')
r = r.replace('D', 'T')
r = r.replace('P', 'T')
r = r.replace('J', 'G')
r = r.replace('B', 'F')
r = r.replace('V', 'F')
r = r.replace('M', 'N')
# Step 16: Remove duplicate letters
oldc = '#'
newr = ''
for c in r:
if oldc != c:
newr = newr + c
oldc = c
r = newr
# Step 17: Remove ending T or X
r = re.sub(r'(.*)[T|X]$', r'\1', r)
return {r}
except Exception:
if LOG:
LOG.debug("French phonetic encoding failed for %r", name)
return {'0'}
Removal of 
) the issue. Since we don’t have access to patch the core, Claude is creating a workaround.