Explorez l'utilisation des packages Python-Tutoriel Python-php.cn

探索 Python 包的使用

Les packages Python vous permettent de diviser de grands systèmes et d'organiser leurs modules de manière cohérente afin que vous et d'autres puissiez les utiliser et les réutiliser efficacement. La devise de Python « batterie intégrée » signifie qu'il est préinstallé avec de nombreux packages utiles dans la bibliothèque standard.

Mais vous pouvez également profiter de nombreux logiciels tiers incroyables. Dans ce didacticiel, vous apprendrez tout ce que vous devez savoir sur ce qu'est exactement un package, comment importer des modules à partir d'un package, explorer les packages intégrés dans la bibliothèque standard Python et installer des packages tiers.

Qu'est-ce qu'un sac ?

Avant de discuter des packages, parlons d’abord des modules. Les modules sont des fichiers sources avec l'extension *.py dans lesquels vous (et d'autres) placez les fonctions et les classes qui composent votre programme.

Un package en Python n'est qu'un dossier contenant plusieurs fichiers Python, et il devrait y avoir un __init__.py 文件。 __init__.py 文件表明该目录是一个包。 __init__.py fichier qui peut être vide ou contenir du code exécutable.

Les packages sont l'incarnation du concept d'espace de noms hiérarchique de Python. Citant le Zen de Python :

"Les espaces de noms sont une excellente idée - faisons-en davantage !"

Pour visualiser l'intégralité de Python Zen, entrez import this dans une session interactive Python :

>>> import this
The Zen of Python, by Tim Peters

Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of those!
>>>

Copier après la connexion

Les espaces de noms aident à organiser le code et à éviter les conflits de noms. Ceci est crucial lorsque plusieurs personnes travaillent ensemble ou utilisent des packages développés par d’autres.

Bien qu'un package représente une hiérarchie de sous-packages et de modules (qui sont des fichiers), la hiérarchie ne doit pas nécessairement être basée sur un système de fichiers, où les packages et les sous-packages sont des répertoires et sous-répertoires. C'est beaucoup plus flexible que ça.

Créer un package Python

Commençons par un exemple simple. Ci-dessous, nous avons un package appelé simple_package qui contient deux modules Python.

simple_package
.
├── __init__.py
├── tasks.py
└── views.py

0 directories, 3 files

Copier après la connexion

__init__.py : indique qu'il s'agit d'un package
tasks.py et views.py sont des modules

Progiciels tiers

Jetons un coup d'œil au package appelé ansible. Ce n'est pas un package dans la bibliothèque standard. Vous verrez plus tard comment rechercher et installer des packages tiers. Examinons maintenant la structure des fichiers de répertoires.

Ces packages sont généralement installés dans le répertoire site-packages de l'interpréteur Python, quelque part sous lib (selon la version, le système d'exploitation et la distribution).

Par exemple, sur un Mac, Python 3.10 se trouvera dans /lib/python3.10/site-packages. Voici comment le package ansible est organisé :

tree ansible -L 1
ansible
├── cli
├── collections
├── compat
├── config
├── constants.py
├── context.py
├── errors
├── executor
├── galaxy
├── __init__.py
├── inventory
├── keyword_desc.yml
├── __main__.py
├── modules
├── module_utils
├── parsing
├── playbook
├── plugins
├── __pycache__
├── release.py
├── template
├── utils
├── vars
└── _vendor

18 directories, 6 files

Copier après la connexion

Il y a 6 modules et 18 répertoires. Chaque répertoire est un sous-paquet du package ansible principal. En regardant le répertoire ansible/utils, on voit qu'il contient d'autres modules et même un sous-package :

tree ansible/utils -L 1
ansible/utils
├── cmd_functions.py
├── collection_loader
├── color.py
├── context_objects.py
├── display.py
├── encrypt.py
├── fqcn.py
├── galaxy.py
├── hashing.py
├── helpers.py
├── __init__.py
├── jsonrpc.py
├── _junit_xml.py
├── listify.py
├── lock.py
├── multiprocessing.py
├── native_jinja.py
├── path.py
├── plugin_docs.py
├── py3compat.py
├── sentinel.py
├── shlex.py
├── singleton.py
├── ssh_functions.py
├── unicode.py
├── unsafe_proxy.py
├── vars.py
└── version.py

1 directory, 27 files

Copier après la connexion

Chemin de recherche

Lorsque vous importez un module, Python effectuera un algorithme de recherche basé sur le chemin de recherche, qui est la liste des répertoires dans lesquels lancer la recherche. Un chemin de recherche est une liste de répertoires disponibles via sys.path et vous pouvez le manipuler dynamiquement (ajouter, supprimer ou déplacer des éléments dans le chemin de recherche). Le répertoire site-packages existe toujours.

Pour importer le module path.py depuis ansible/utils vous devez utiliser la commande suivante :

import ansible.utils.path

Copier après la connexion

Pour importer le module path 和 encrypt, utilisez la commande suivante :

import ansible.utils.path
import ansible.utils.encrypt

Copier après la connexion

Si vous souhaitez également utiliser le module os.path standard, vous utiliserez la commande suivante :

import os.path

Copier après la connexion

Vous pouvez désormais utiliser l'un ou les deux modules de chemin sans entrer en conflit en raison de l'espace de noms auquel ils appartiennent.

Explorez la bibliothèque standard

La bibliothèque standard contient de nombreux packages. Chaque fois que vous devez accomplir une tâche mais que vous ne savez pas comment procéder, cela vaut la peine de l'explorer. Pour toute tâche courante, telle que les mathématiques, l'intégration du shell, l'intégration du système d'exploitation, la manipulation de chaînes, la mise en réseau et les formats de fichiers courants, il existe très probablement un package bien conçu, performant et bien testé dans la bibliothèque standard

Vous pouvez vraiment faire confiance aux packages de bibliothèque standard, car accéder à la bibliothèque standard est un gros problème. Le package a été conçu par les principaux développeurs Python ou a été soigneusement vérifié et largement utilisé sur le terrain en tant que bibliothèque tierce avant d'être intégré à la bibliothèque standard.

Voici tous les packages de la bibliothèque standard organisés par thème.

PyPI

La bibliothèque standard est excellente, mais vous avez souvent besoin de fonctionnalités spéciales qui ne sont pas standard. Cela ne signifie pas que vous devez l'écrire à partir de zéro. Python possède une communauté dynamique et active qui développe et partage gratuitement de nombreux codes. Entrez PyPI : l'index des packages Python. PyPI héberge tous les progiciels accessibles au public et fournit un guichet unique pour les parcourir.