Auteur: | Toshio Kuratomi |
---|---|
Responsable : | Ralph Bean |
Date: | 13 novembre 2015 |
Version: | 1.2.x |
Le module Kitchen fournit une API python pour toutes sortes de petits extraits de code utiles que tout le monde finit par écrire pour ses projets mais qui ne semblent jamais assez gros pour créer une version indépendante. Utilisez la cuisine et arrêtez de couper et coller ce code encore et encore.
Contenu
Licence
Exigences
Exigences souples
Autres bibliothèques recommandées
Construction et tests
Essai
Depuis la version 0.2a1, ce module python est distribué selon les termes de la GNU Lesser General Public License version 2 ou ultérieure.
Note
Certaines parties de ce module sont sous licence selon des conditions moins restrictives que la LGPL. Si vous séparez ces fichiers de l'œuvre dans son ensemble, vous êtes autorisé à les utiliser sous des licences moins restrictives. Voici une liste des fichiers connus :
sous-processus.py : | sous licence Python 2 par la PSF http://www.python.org/download/releases/2.4/license/ |
---|---|
test_subprocess.py : | Licence Python Software Foundation version 2 http://www.python.org/download/releases/2.7/license/ |
cuisine/pycompat25/defaultdict.py : | Licence Python Software Foundation version 2 http://www.python.org/download/releases/2.6.2/license |
kitchen.core nécessite
python: | 2.4 ou version ultérieure |
---|
Depuis la version 1.2.0, ce package a distribué des versions compatibles python2 et python3 de la source.
Si elles sont trouvées, ces bibliothèques seront utilisées pour améliorer l’implémentation de quelque chose d’une manière ou d’une autre. S'ils ne sont pas présents, l'API qu'ils activent existera toujours mais pourra fonctionner de manière différente.
chardet_ : | Utilisé dans kitchen.text.xml.guess_encoding__to_xml() pour aider à deviner l'encodage des chaînes d'octets en cours de conversion. S'ils ne sont pas présents, les encodages inconnus seront convertis comme s'ils étaient latin1. |
---|
Ces bibliothèques implémentent des fonctionnalités couramment utilisées que tout le monde semble inventer. Plutôt que de réinventer leur roue, j'énumère simplement les choses qu'ils font bien pour le moment. Peut-être que si les gens ne peuvent pas les trouver normalement, je les ajouterai comme exigences dans setup.py ou les lierai à l'espace de noms de la cuisine. Pour l'instant, je me contente de les mentionner ici :
bouquet_ : | Bunch est un dictionnaire auquel vous pouvez utiliser la recherche d'attributs ainsi que la notation entre crochets pour accéder. La fonction bundleify() qui la distingue de la plupart des implémentations maison est la fonction qui descendra des structures imbriquées de listes et de dicts, transformant les dicts en ceux de Bunch. |
---|
Vous pouvez exécuter les tests unitaires avec cette commande :
./runtests.sh