Es gibt eigentlich drei verschiedene Möglichkeiten, ein Modul in Python zu definieren:
re (regular expression) Modul.itertools.
Der Zugriff auf den Inhalt eines Moduls erfolgt in allen drei Fällen auf die gleiche Weise: mit der import-Anweisung.
Hier geht es hauptsächlich um Module, die in Python geschrieben sind. Das Tolle an in Python geschriebenen Modulen ist, dass sie äußerst einfach zu erstellen sind. Alles, was Sie tun müssen, ist, eine Datei zu erstellen, die legitimen Python-Code enthält, und der Datei einen Namen mit der Erweiterung .py zu geben. Das war's! Es ist keine spezielle Syntax oder Voodoo nötig.
Nehmen wir zum Beispiel an, Sie haben eine Datei namens mod.py erstellt, die Folgendes enthält:
s = "If Comrade Napoleon says it, it must be right." a = [100, 200, 300] def foo(arg): print(f'arg = {arg}') class Foo: pass
Mehrere Objekte sind in mod.py definiert:
s (eine Zeichenkette)a (eine Liste)foo() (eine Funktion)Foo (eine Klasse)
Vorausgesetzt, mod.py befindet sich an einem geeigneten Ort, über den Sie gleich mehr erfahren werden, kann auf diese Objekte zugegriffen werden, indem das Modul wie folgt importiert wird:
import mod print(mod.s) #If Comrade Napoleon says it, it must be right. print(mod.a) #[100, 200, 300] mod.foo(['quux', 'corge', 'grault']) #arg = ['quux', 'corge', 'grault'] x = mod.Foo() print(x) #<mod.Foo object at 0x03C181F0>
Fahren wir mit dem obigen Beispiel fort und schauen wir uns an, was passiert, wenn Python die Anweisung ausführt:
import mod
Wenn der Interpreter die obige Import-Anweisung ausführt, sucht er nach mod.py in einer Liste von Verzeichnissen, die aus den folgenden Quellen zusammengestellt wurde:
Der resultierende Suchpfad ist in der Python-Variablen sys.path zugänglich, die von einem Modul namens sys bezogen wird:
import sys print(sys.path) #['', 'C:\\Users\\peter\\Documents\\Python\\doc', 'C:\\Python36\\Lib\\idlelib','C:\\Python310\\python310.zip', 'C:\\Python310\\DLLs', 'C:\\Python310\\lib','C:\\Python310', 'C:\\Python310\\lib\\site-packages']
Der genaue Inhalt von sys.path ist installationsabhängig. Die obigen Angaben werden auf Ihrem Computer höchstwahrscheinlich etwas anders aussehen.
Um also sicherzustellen, dass Ihr Modul gefunden wird, müssen Sie eine der folgenden Maßnahmen ergreifen:
mod.py in das Verzeichnis, in dem sich das aufrufende Skript befindet.PYTHONPATH so, dass sie das Verzeichnis enthält, in dem sich mod.py befindet, bevor Sie den Interpreter starten.mod.py in einem der Verzeichnisse ab, die bereits in der PYTHONPATH-Variable enthalten sindmod.py in eines der installationsabhängigen Verzeichnisse, auf die Sie je nach Betriebssystem Schreibzugriff haben oder nicht
Es gibt noch eine weitere Möglichkeit: Sie können die Moduldatei in ein beliebiges Verzeichnis Ihrer Wahl ablegen und dann sys.path zur Laufzeit so ändern, dass es dieses Verzeichnis enthält. In diesem Fall könnten Sie z.B. mod.py in das Verzeichnis C:\Users\peter ablegen und dann die folgenden Anweisungen eingeben:
sys.path.append(r'C:\Users\peter') print(sys.path) #['', 'C:\\Users\\peter\\Documents\\Python\\doc', 'C:\\Python36\\Lib\\idlelib', 'C:\\Python36\\python36.zip', 'C:\\Python36\\DLLs', 'C:\\Python36\\lib', 'C:\\Python36', 'C:\\Python36\\lib\\site-packages', 'C:\\Users\\peter'] import mod
Modulinhalte werden dem Aufrufer mit der import-Anweisung zur Verfügung gestellt. Die import-Anweisung kann viele verschiedene Formen annehmen, wie unten gezeigt.
Die einfachste Form ist die bereits oben gezeigte:
import <modul_name>
Beachten Sie, dass dies den Inhalt des Moduls für den Aufrufer nicht direkt zugänglich macht. Jedes Modul hat einen eigenen Namensraum. Die Anweisung import <Modulname> platziert nur <Modulname> im Namensraum des Aufrufers. Die Objekte, die im Modul definiert sind, bleiben im privaten Namensraum des Moduls. Für den Aufrufer sind die Objekte des Moduls nur dann zugänglich, wenn mit <modul_name>.<object> darauf zugegriffen wird:
Trotz des Imports bleiben s und foo bleiben im privaten Namensraum des Moduls und sind im lokalen Kontext nicht von Bedeutung:
import mod print(s) # NameError: name 's' is not defined foo('quux') #NameError: name 'foo' is not defined
Um im lokalen Kontext zugänglich zu sein, muss den Namen der im Modul definierten Objekte das Kürzel mod vorangestellt werden:
import mod print(mod.s) #If Comrade Napoleon says it, it must be right. mod.foo('quux') #arg = quux
Sie können auch ein ganzes Modul unter einem alternativen Namen importieren:
import <module_name> as <alt_name>
import mod as my_module print(my_module.a) #[100, 200, 300] my_module.foo('qux') #arg = qux
Eine alternative Form der Import-Anweisung erlaubt es, einzelne Objekte aus dem Modul direkt in den Namensraum des Aufrufers zu importieren:
from <module_name> import <name(s)>
Nach Ausführung der obigen Anweisung kann in der Umgebung des Aufrufers auf <name(s)> ohne den Präfix <module_name> verwiesen werden:
from mod import s, foo print(s) #If Comrade Napoleon says it, it must be right. foo('quux') #arg = quux
Da bei dieser Form des Imports die Objektnamen direkt in den Namensraum des Aufrufers eingetragen werden, werden bereits vorhandene Objekte mit demselben Namen überschrieben:
a = ['foo', 'bar', 'baz'] print(a) #['foo', 'bar', 'baz'] from mod import a print(a) #[100, 200, 300]
Es ist auch möglich, einzelne Objekte zu importieren, diese aber mit alternativen Namen im lokalen Namensraum einzutragen:
from <module_name> import <name> as <alt_name>[, <name> as <alt_name> …]
Dadurch ist es möglich, Namen direkt in den lokalen Namensraum einzugeben, ohne dass es zu Konflikten mit bereits vorhandenen Namen kommt:
s = 'foo' a = ['foo', 'bar', 'baz'] from mod import s as string, a as alist print(s) #'foo' print(string) #'If Comrade Napoleon says it, it must be right.' print(a) #['foo', 'bar', 'baz'] print(alist) #[100, 200, 300]
Inhalt von RealPython