urban-json-random

Plugin urban-json : données aléatoires dans les templates, via les 25 fonctions getrandom_* du moteur .NET d'origine (port de Services.randoms.cs). Utile pour produire des jeux de test réalistes.

Installation

pip install urban-json-random      # tire urban-json, Faker et rstr

Rien d'autre à faire : urban-json découvre le plugin automatiquement via les entry points (urban_json.functions).

Utilisation

from urban_json import JsltTemplate

tpl = JsltTemplate.parse("""{
  "id": getrandom_integer(1, false, 1000, false),
  "client": getrandom_fullname(),
  "email": getrandom_email(),
  "iban": getrandom_iban("FR"),
  "ref": getrandom_string(0, 0, "^[A-Z]{3}-\\\\d{4}$")
}""")
tpl.transform({})
# -> {'id': 417, 'client': 'Jane Doe', 'email': '…', 'iban': 'FR76…', 'ref': 'QZT-0381'}

Fonctions

Écarts volontaires avec le .NET

• exclusiveMinimum / exclusiveMaximum excluent la borne (sens JSON Schema) ; le .NET élargissait au contraire l'intervalle.
• Sans bornes : étendue du type (integer 0 à 2³¹−1, double dans [0, 1)…) ; le .NET générait souvent toujours 0.
• Intervalle impossible : erreur JsltError explicite.
• getrandom_boolean et getrandom_in_list font un vrai tirage (le .NET prenait la parité des millisecondes) ; liste vide → null.
• getrandom_password utilise un générateur cryptographique (secrets).
• Dates et durées en texte : ISO 8601 et hh:mm:ss.fff.