From c284321b1073e06481c63e2c061a1600fa68254d Mon Sep 17 00:00:00 2001
From: Sébastien Dailly <sebastien@dailly.me>
Date: Thu, 10 Apr 2025 20:27:59 +0200
Subject: Added filters expressions in the externals

---
 readme.rst | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

(limited to 'readme.rst')

diff --git a/readme.rst b/readme.rst
index 5cefd08..b14e98b 100644
--- a/readme.rst
+++ b/readme.rst
@@ -205,6 +205,13 @@ allow_missing
     Cette clef optionnelle indique s’il faut autoriser les valeurs manquantes
     lors dans une liaison. Déclarer `allow_missing` va également autoriser les
     doublons sur les valeurs de clef.
+filters
+    Il s’agit d’une liste d’expression devant être validées pour que la ligne
+    soit prise en compte.
+
+    .. include:: examples/externals_filters.toml
+        :code: toml
+        :class: collapse
 
 Une fois la dépendance vers un fichier externe déclaré, il est possible
 d’utiliser les colonnes de ce fichier en les référençant directement. Cela
@@ -337,6 +344,10 @@ résultat selon que l’on filtre :
    colonne B ≠ 0
 2. d’abord sur la colonne B ≠ 0, puis la plus grande valeur de la colonne A.
 
+.. include:: examples/importer_groupe.toml
+    :code: toml
+    :class: collapse
+
 Exemple complet
 ===============
 
@@ -402,10 +413,13 @@ partir de plusieurs tables.
         # La table des immatriculations.
         # Seules les lignes avec la colonne D = 4 nous intéressent
         [externals.immat]
-          intern_key = ":A ^ '_4'"
+          intern_key = ":A"
           file = "20220222_SO_IMMATRICULATION.xlsx"
-          extern_key = ":B ^ '_' ^ :D"
+          extern_key = ":B"
           allow_missing = true
+          filters = [
+            ":D = 4"
+          ]
 
         [sheet]
           columns = [
-- 
cgit v1.2.3