Package: jazal
JazalFrançaisAvant qu'une application utilise le chemin d'un fichier, il peut importer de
vérifier s'il a la bonne extension, s'il existe et s'il s'agit d'un dossier ou
d'un fichier. À cette fin, la bibliothèque Jazal fournit la classe PathChecker
et sa sous-classe ReactivePathChecker. Cette dernière permet en plus d'avertir
l'utilisateur que le chemin est invalide et de le remplacer par une valeur
correcte. Ces deux classes dépendent de pathlib.Path.Jazal offre aussi la classe MissingPathArgWarner, qui produit un message
explicite si l'utilisateur omet de fournir un argument chemin obligatoire. Si
le chemin est donné, cette classe peut instancier PathChecker ou
ReactivePathChecker de telle manière que chaque information requise ne soit
donnée qu'une seule fois. Si un chemin optionnel est omis, MissingPathArgWarner
peut aider à générer une valeur par défaut en fournissant l'extension attendue.De plus, cette bibliothèque contient des fonctions qui aident à produire des
valeurs par défaut pour les chemins manquants ou invalides.Voir les scriptsdemo_with_files.pyetdemo_with_dirs.pypour savoir
comment employer Jazal.Le nom de cette bibliothèque vient de la chanson polonaiseHej, sokoły!. La répétition du
motżal[ʒal] dans les paroles a insprié le nom Jazal.Tests unitaires de JazalLes tests unitaires de cette bibliothèque dépendent du cadriciel pytest. Pour
lancer une suite de tests contenue dans le dossiertests, écrivez en ligne de
commande une instruction correspondant au modèle suivant.pytest <file name>.pyExécutez le script run_all_tests.py pour lancer tous les tests.python run_all_tests.pyPuisque plusieurs tests utilisent des chemins relatifs menant à un dossier et
à un fichier réels, lancez-les depuis le dossiertestspour éviter des
exceptions.EnglishBefore an application uses a path to a file, it may be important to verify
whether it has the right extension, whether it exists and whether it points to
a directory or a file. For this purpose, library Jazal provides class
PathChecker and its subclass ReactivePathChecker. The latter is also able to
warn the user about invalid paths and make correct ones. These two classes
depend on pathlib.Path.Jazal also offers class MissingPathArgWarner, which makes an explicit message
if the user omits to provide a mandatory path argument. If the path is given,
this class can instantiate PathChecker or ReactivePathChecker in such a way
that each required information is given only once. If an optional path is
omitted, MissingPathArgWarner can help generating a default value by providing
the expected extension.In addition, this library contains functions that help making default values
for missing or invalid paths.See scriptsdemo_with_files.pyanddemo_with_dirs.pyto know how to use
Jazal.This library's name is based on the Polish songHej, sokoły!. The repetition
of the wordżal[ʒal] in the lyrics inspired the name Jazal.Jazal Unit TestsThis library's unit tests depend on framework pytest. In order to run a test
suite contained in directorytests, type an instruction matching the
following template in command line.pytest <file name>.pyExecute script run_all_tests.py to perform all the tests.python run_all_tests.pySince several tests use relative paths to an actual directory and an actual
file, run them from directoryteststo prevent exceptions.