Module Python (mémo d'apprentissage Python ④)

À propos des modules Python

point

• Module = fichier contenant des définitions et des instructions Python
• Le nom du fichier est * .py
• Dans le module, le nom du module est défini comme la valeur de la variable globale __name__

sample_module.py

def func1(n):
    return n

def func2(n):
    return n

Dans l'interpréteur Python

>>> import sample_module
>>> sample_module.func1('kawauso') 
'kawauso'

À propos de l'importation de modules

point

• Les modules peuvent contenir des instructions exécutables ainsi que des définitions de fonctions
• Ces instructions sont exécutées au moment de l'importation, alors utilisez-les comme initialisation
• Chaque module a une table de symboles privée, vous n'avez donc pas à vous soucier des conflits de nom avec l'appelant.
• Pour accéder aux variables globales dans un module, écrivez sous la forme modulename.itemname
• Vous pouvez appeler d'autres modules depuis le module
• Par convention, l'instruction d'importation doit être placée au début du fichier
• Il est également possible d'appeler individuellement les noms définis dans le module.

>>> from sample_module import func1, func2
>>> func1('kawauso')
'kawauso'
>>> func2('kawauso')
'kawauso'

• Utilisez * pour capturer tous les noms définis par le module sauf ceux commençant par _
• Généralement, il est difficile de comprendre à première vue ce qui est importé, donc ce n'est pas préféré.

>>> from sample_module import *
>>> func1('kawauso')
'kawauso'

Exécutez le module en tant que script

point

• Vous pouvez également exécuter le module sur l'argument python sample_module.py
• A ce moment, __name__ devient __main__
• Vous pouvez l'utiliser pour écrire une branche lorsqu'elle est exécutée en tant que script.

sample_module.py

def func1(n):
    return n

def func2(n):
    return n

#Ce code ne s'exécute pas lorsqu'il est importé en tant que module
if __name__ == "__main__":
    import sys
    func1(sys.argv[1])

$ python sample_module.py kawauso
kawauso

Chemin de recherche du module

point

• Lorsqu'un module est importé, l'interpréteur Python recherche d'abord un module intégré.
• Recherchez ensuite le nom du fichier à l'aide de la liste des répertoires obtenue avec la variable sys.path
• sys.path peut être modifié par programme après l'initialisation
• Le répertoire contenant le script en cours d'exécution est placé au début du chemin de recherche
• Par conséquent, s'il existe un module avec le même nom que la bibliothèque standard, il sera chargé de préférence.

À propos des fichiers Python compilés

point

• Python met en cache les modules compilés dans le répertoire __pycache__ pour un chargement plus rapide des modules
• Les modules compilés sont mis en cache sous le nom module.version.pyc
• Cette convention de dénomination permet à différentes versions et différentes versions de Python de coexister.
• Python compare la date et l'heure de la dernière modification du fichier source avec la version compilée pour déterminer si une recompilation est nécessaire.

Module standard

point

• python est livré avec une bibliothèque de modules standard
• Certains modules sont intégrés à l'interpréteur et sont intégrés pour répondre aux besoins de performances et au traitement primitif du système d'exploitation.
• Ceux-ci dépendent des paramètres au moment de l'installation et de la plate-forme
• Par exemple, le module winreg n'est disponible que sur les systèmes Windows
• sys est typique de ces modules (ceci est intégré à tous les interpréteurs Python)
• Les variables telles que sys.ps1, sys.ps2 ne sont définies que lorsque l'interpréteur est en mode interactif.
• sys.path est une liste de chaînes qui spécifient le chemin de recherche du module de l'interpréteur
• sys.path est soit PYTHONPATH soit le chemin par défaut intégré
• Cela peut être modifié avec des opérations de liste standard

fonction dir ()

• La fonction intégrée dir () est utilisée pour vérifier le nom défini par le module (la valeur de retour est une liste de chaînes).

>>> import module
>>> dir(module) 
['__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', 'func1', 'func2']

• Aucun argument dir () retourne une liste de noms définis au niveau courant

>>> hoge = 'hoge' 
>>> dir()
['__annotations__', '__builtins__', 
'__doc__', '__loader__', '__name__', '__package__', '__spec__', 'hoge', 
'module']
>>>

• dir () ne répertorie pas les noms de fonction et de variable intégrés
• Si vous voulez vérifier, vérifiez le module standard builtins

>>> import builtins
>>> dir(builtins) 
['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException', 'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning', 'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError', 'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning', 'EOFError', 'Ellipsis', 'EnvironmentError', 
'Exception', 'False', 'FileExistsError', 'FileNotFoundError', 'FloatingPointError', 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError', 
'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError', 'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError', 'MemoryError', 'ModuleNotFoundError', 'NameError', 'None', 'NotADirectoryError', 'NotImplemented', 'NotImplementedError', 'OSError', 'OverflowError', 'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError', 
'RecursionError', 'ReferenceError', 
'ResourceWarning', 'RuntimeError', 'RuntimeWarning', 'StopAsyncIteration', 'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError', 'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError', 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError', 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning', 'ValueError', 'Warning', 'WindowsError', 'ZeroDivisionError', '_', '__build_class__', '__debug__', '__doc__', '__import__', '__loader__', '__name__', '__package__', '__spec__', 'abs', 'all', 'any', 'ascii', 'bin', 'bool', 'breakpoint', 'bytearray', 'bytes', 'callable', 'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits', 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit', 'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr', 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass', 
'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview', 
'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property', 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice', 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars', 'zip']

paquet

point

• Le package explique comment construire un module Python en utilisant "nom de module délimité par des points"
• Par exemple, le nom du module ʻA.B` fait référence au sous-module "B] du package" A ".
• Nécessite un fichier __init __. Py pour traiter un répertoire comme contenant des packages
• __init __. py peut être juste un fichier vide, mais vous pouvez également exécuter le code d'initialisation du package et définir la variable __all__.

Exemple de configuration de package

A/ ->Package de haut niveau
    __init__.py ->Initialisation du package
    A1/  ->Sous-ensemble 1
        __init__.py
        hoge1.py
        hoge2.py
        hoge3.py
    A2/ ->Sous-ensemble 2
        __init__.py
        hoge1.py
        hoge2.py
        hoge3.py

Charger le package

import A.A1.hoge1
#Les références à cela doivent être faites avec le nom complet
A.A1.hoge1.func1()

Il existe également une autre méthode de chargement

Charger le paquet 2

from A.A1 import hoge1
hoge1.func1()

En outre, il existe également un moyen d'importer directement la fonction ou la variable souhaitée.

from A.A1.hoge1 import func1
func1()

Importer * à partir du package

point

• Lorsque from A.A1 import *, si le code de __init __. Py du package définit la variable __all__, importez le package qui y est défini.
• Si __all__ n'est pas défini, importez uniquement ʻA.A1` et importez tous les noms définis dans le corps du package
• Les noms définis dans __init __. Py sont également importés

__init__.py

__all__ = ["module1", "module2", "module3"]
module4 = func4() #module4 est également importé

• S'il y a un sous-module qui a été explicitement chargé dans l'instruction d'importation précédente, il sera également importé.

#les modules d'écho et surround sont importés
import sound.effects.echo
import sound.effects.surround
from sound.effects import *

Référence mutuelle dans le package

point

• Lorsqu'un package est composé de sous-packages, les références de packages frères peuvent être des importations absolues ainsi que des importations relatives.
• L'importation relative est basée sur le module actuel, assurez-vous donc d'utiliser l'importation absolue depuis le module principal
• Le nom du module principal sera toujours __main__

from . import echo #Même hiérarchie
from .. import formats #Un niveau supérieur
from ..filters import equalizer #Dans le sous-module des filtres d'un niveau supérieur

Packages qui couvrent plusieurs répertoires

point

• En réécrivant __path__, cela affecte la recherche des modules et sous-packages inclus dans le package.
• Peut être utilisé lorsque vous souhaitez étendre l'ensemble de modules d'un package