stringprep — Préparation des chaines de caractères internet

Code source : Lib/stringprep.py

Nommer les différentes choses d'internet (comme les hôtes) amène souvent au besoin de comparer ces identifiants, ce qui nécessite un critère d'« égalité ». La manière dont cette comparaison est effectuée dépend du domaine d'application, c'est-à-dire si elle doit être sensible à la casse ou non. Il peut être aussi nécessaire de restreindre les identifiants possibles, pour permettre uniquement les identifiants composés de caractères « imprimables ».

La RFC 3454 définit une procédure pour "préparer" des chaines de caractères Unicode dans les protocoles internet. Avant de passer des chaines de caractères sur le câble, elles sont traitées avec la procédure de préparation, après laquelle ils obtiennent une certaines forme normalisée. Les RFC définissent un lot de tables, qui peuvent être combinées en profils. Chaque profil doit définir quelles tables il utilise et quelles autres parties optionnelles de la procédure stringprep font partie du profil. Un exemple de profil stringprep est nameprep, qui est utilisé pour les noms de domaine internationalisés.

Le module stringprep expose uniquement les tables de la RFC 3454. Comme ces tables seraient très grandes à représenter en tant que dictionnaires ou listes, le module utilise, en interne, la base de données des caractères Unicode. Le code source du module, lui-même, a été généré en utilisant l'utilitaire mkstringprep.py.

En conséquence, ces tables sont exposées en tant que fonctions et non en structures de données. Il y a deux types de tables dans la RFC : les ensemble et les mises en correspondance. Pour un ensemble, stringprep fournit la "fonction caractéristique", c'est-à-dire une fonction qui renvoie True si le paramètre fait partie de l'ensemble. Pour les mises en correspondance, il fournit la fonction de mise en correspondance : ayant obtenu la clé, il renvoie la valeur associée. Ci-dessous se trouve une liste de toutes les fonctions disponibles dans le module.

stringprep.in_table_a1(code)

Détermine si le code est en table A.1 (points de code non-assigné dans Unicode 3.2).

stringprep.in_table_b1(code)

Détermine si le code est en table B.1 (habituellement mis en correspondance avec rien).

stringprep.map_table_b2(code)

Renvoie la valeur correspondante à code selon la table B.2 (mise en correspondance pour la gestion de la casse utilisée avec NFKC).

stringprep.map_table_b3(code)

Renvoie la valeur correspondante à code dans la table B.3 (mise en correspondance pour la gestion de la casse utilisée sans normalisation).

stringprep.in_table_c11(code)

Détermine si le code est dans la table C.1.1 (caractères d'espacement ASCII).

stringprep.in_table_c12(code)

Détermine si le code est dans la table C.1.2 (caractères d'espacement non ASCII).

stringprep.in_table_c11_c12(code)

Détermine si le code est dans la table C.1 (caractères d'espacement, union de C.1.1 et C.1.2).

stringprep.in_table_c21(code)

Détermine si le code est dans la table C.2.1 (caractères de contrôle ASCII).

stringprep.in_table_c22(code)

Détermine si le code est en table C.2.2 (caractères de contrôle non ASCII).

stringprep.in_table_c21_c22(code)

Détermine si le code est dans la table C.2 (caractères de contrôle, union de C.2.1 et C.2.2).

stringprep.in_table_c3(code)

Détermine si le code est en table C.3 (usage privé).

stringprep.in_table_c4(code)

Détermine si le code est dans la table C.4 (points de code non-caractère).

stringprep.in_table_c5(code)

Détermine si le code est en table C.5 (codes substituts).

stringprep.in_table_c6(code)

Détermine si le code est dans la table C.6 (Inapproprié pour texte brut).

stringprep.in_table_c7(code)

Détermine si le code est dans la table C.7 (inapproprié pour les représentations canonics1).

stringprep.in_table_c8(code)

Détermine si le code est dans la table C.8 (change de propriétés d'affichage ou sont obsolètes).

stringprep.in_table_c9(code)

Détermine si le code est dans la table C.9 (caractères de marquage).

stringprep.in_table_d1(code)

Détermine si le code est en table D.1 (caractères avec propriété bidirectionnelle "R" ou "AL").

stringprep.in_table_d2(code)

Détermine si le code est dans la table D.2 (caractères avec propriété bidirectionnelle "L").