python - eine interpretierte, interaktive, objektorientierte Programmiersprache
SYNOPSIS
python [ -B ] [ -b ] [ -d ] [ -E ] [ -h ] [ -i ] [ -I ]
[ -m module-name ] [ -q ] [ -R ] [ -O ] [ -OO ] [ -P ] [ -s ] [ -S ] [ -u ]
[ -v ] [ -V ] [ -W argument ] [ -x ] [ -X option ] [ -? ]
[ --check-hash-based-pycs default | always | never ]
[ --help ] [ --help-env ] [ --help-xoptions ] [ --help-all ]
[ -c command | script | - ] [ arguments ]
BESCHREIBUNG
Python ist eine interpretierte, interaktive, objektorientierte Programmiersprache, die bemerkenswerte Leistung mit sehr klarer Syntax kombiniert. Für eine Einführung in die Programmierung in Python siehe das Python-Tutorial. Die Python-Bibliotheksreferenz dokumentiert integrierte und Standardtypen, Konstanten, Funktionen und Module. Schließlich beschreibt das Python-Referenzhandbuch die Syntax und Semantik der Kernsprache (möglicherweise in zu vielen Details). (Diese Dokumente können über die INTERNETRESSOURCEN gefunden werden; sie können auch auf Ihrem System installiert sein).
Die grundlegende Leistung von Python kann durch Ihre eigenen in C oder C++ geschriebenen Module erweitert werden. Auf den meisten Systemen können solche Module dynamisch geladen werden. Python ist auch als Erweiterungssprache für vorhandene Anwendungen anpassbar. Siehe die interne Dokumentation für Hinweise.
Die Dokumentation für installierte Python-Module und -Pakete kann angezeigt werden, indem Sie das Programm pydoc ausführen.
KOMMANDOZEILENOPTIONEN
-B .pyc-Dateien beim Importieren nicht schreiben. Siehe auch PYTHONDONTWRITEBYTECODE.
-b Gibt Warnungen über str(bytes_instance), str(bytearray_instance) und den Vergleich von Bytes/Bytearray mit Str aus. (-bb: Fehler ausgeben)
-c command
Gibt den auszuführenden Befehl an (siehe nächster Abschnitt). Dies beendet die Optionsliste (folgende Optionen werden als Argumente an den Befehl übergeben).
--check-hash-based-pycs mode
Konfiguriert, wie Python die Aktualität von Hash-basierten .pyc-Dateien bewertet.
-d Aktiviert die Parser-Debug-Ausgabe (nur für Experten, abhängig von den Kompilierungsoptionen).
-E Umgebungsvariablen wie PYTHONPATH und PYTHONHOME, die das Verhalten des Interpreters ändern, ignorieren.
-h , -? , --help
Gibt die Verwendung für das Interpreter-Executable aus und beendet das Programm.
--help-env
Gibt Hilfe zu Python-spezifischen Umgebungsvariablen aus und beendet das Programm.
--help-xoptions
Gibt Hilfe zu implementationsspezifischen -X-Optionen aus und beendet das Programm.
--help-all
Gibt vollständige Nutzungsinformationen aus und beendet das Programm.
-i Wenn ein Skript als erstes Argument übergeben wird oder die Option -c verwendet wird, nach der Ausführung des Skripts oder Befehls in den interaktiven Modus wechseln. Es liest nicht die Datei $PYTHONSTARTUP. Dies kann nützlich sein, um globale Variablen oder einen Stack-Trace zu untersuchen, wenn ein Skript eine Ausnahme auslöst.
-I Führt Python im isolierten Modus aus. Dies impliziert auch -E, -P und -s. Im isolierten Modus enthält `sys.path` weder das Verzeichnis des Skripts noch das Verzeichnis der vom Benutzer installierten Pakete. Alle Umgebungsvariablen, die mit `PYTHON` beginnen, werden ebenfalls ignoriert. Es können weitere Einschränkungen auferlegt werden, um zu verhindern, dass der Benutzer bösartigen Code einschleust.
-m modulname
Durchsucht `sys.path` nach dem angegebenen Modul und führt die entsprechende `.py`-Datei als Skript aus. Dies beendet die Optionsliste (nachfolgende Optionen werden als Argumente an das Modul übergeben).
-O Entfernt `assert`-Anweisungen und jeglichen Code, der vom Wert von `__debug__` abhängt; das Dateinamen für kompilierte (Bytecode-)Dateien wird durch Hinzufügen von `.opt-1` vor der `.pyc`-Erweiterung erweitert.
-OO Führt -O aus und verwirft auch Docstrings; ändert den Dateinamen für kompilierte (Bytecode-)Dateien, indem `.opt-2` vor der `.pyc`-Erweiterung hinzugefügt wird.
-P Verhindert das automatische Hinzufügen eines potenziell unsicheren Pfads zu `sys.path`, wie z. B. dem aktuellen Verzeichnis, dem Verzeichnis des Skripts oder einem leeren String. Siehe auch die Umgebungsvariable `PYTHONSAFEPATH`.
-q Gibt keine Versions- und Copyright-Meldungen aus. Diese Meldungen werden auch im nicht-interaktiven Modus unterdrückt.
-R Aktiviert die Hash-Randomisierung. Diese Option hat nur dann eine Wirkung, wenn die Umgebungsvariable `PYTHONHASHSEED` auf 0 gesetzt ist, da die Hash-Randomisierung standardmäßig aktiviert ist.
-s Fügt das Verzeichnis der vom Benutzer installierten Pakete nicht zu `sys.path` hinzu.
-S Deaktiviert den Import des Moduls `site` und die von `site` vorgenommenen, sitzungsabhängigen Änderungen an `sys.path`. Deaktiviert diese Änderungen auch dann, wenn `site` später explizit importiert wird.
-u Erzwingt, dass die Standardausgabe- und Fehlerausgabestreams nicht gepuffert werden. Diese Option hat keine Auswirkungen auf den Standardeingabestream.
-v Gibt bei jeder Initialisierung eines Moduls eine Nachricht aus, die den Speicherort (Dateiname oder eingebautes Modul) anzeigt, von dem es geladen wird. Wenn dies zweimal angegeben wird, wird eine Nachricht für jede Datei ausgegeben, die bei der Suche nach einem Modul überprüft wird. Bietet auch Informationen über die Bereinigung von Modulen beim Beenden.
-V , --version
Gibt die Python-Version des ausführbaren Programms aus und beendet das Programm. Wenn dies zweimal angegeben wird, werden zusätzliche Informationen zur Erstellung ausgegeben.
-W argument
Warnungskontrolle. Der Warnmechanismus von Python gibt standardmäßig Warnmeldungen an `sys.stderr` aus.
Die einfachsten Einstellungen wenden eine bestimmte Aktion bedingungslos auf alle Warnungen an, die von einem Prozess ausgegeben werden (sogar auf solche, die ansonsten standardmäßig ignoriert werden):
-Wdefault # Einmal pro Aufrufposition warnen
-Werror # In Ausnahmen umwandeln
-Walways # Jedes Mal warnen
-Wall # Das gleiche wie -Walways
-Wmodule # Einmal pro aufrufendem Modul warnen
-Wonce # Einmal pro Python-Prozess warnen
-Wignore # Nie warnen
Die Namen der Aktionen können beliebig abgekürzt werden, und der Interpreter wird sie in die entsprechende Aktionsbezeichnung auflösen. Zum Beispiel ist `-Wi` das gleiche wie `-Wignore`.
Die vollständige Form des Arguments ist: Aktion:Nachricht:Kategorie:Modul:Zeilennummer.
Leere Felder stimmen mit allen Werten überein; nachgestellte leere Felder können weggelassen werden. Zum Beispiel ignoriert -W ignore::DeprecationWarning alle Warnungen vom Typ DeprecationWarning.
Das Feld „Aktion“ hat die oben beschriebene Bedeutung und gilt nur für Warnungen, die mit den übrigen Feldern übereinstimmen.
Das Feld „Nachricht“ muss mit der gesamten ausgegebenen Warnmeldung übereinstimmen; diese Übereinstimmung ist nicht zwischen Groß- und Kleinschreibung zu unterscheiden.
Das Feld „Kategorie“ stimmt mit der Warnkategorie überein (z. B. „DeprecationWarning“). Dies muss ein Klassenname sein; der Abgleichstest prüft, ob die tatsächliche Warnkategorie der Nachricht eine Unterklasse der angegebenen Warnkategorie ist.
Das Feld „Modul“ stimmt mit dem (vollständig qualifizierten) Modulnamen überein; dieser Abgleich ist zwischen Groß- und Kleinschreibung zu unterscheiden.
Das Feld „Zeilennummer“ stimmt mit der Zeilennummer überein, wobei 0 mit allen Zeilennummern übereinstimmt und somit einem weggelassenen Feld für die Zeilennummer entspricht.
Es können mehrere -W-Optionen angegeben werden; wenn eine Warnung mit mehr als einer Option übereinstimmt, wird die Aktion der zuletzt übereinstimmenden Option ausgeführt. Ungültige -W-Optionen werden ignoriert (es wird jedoch eine Warnmeldung über ungültige Optionen ausgegeben, wenn die erste Warnung angezeigt wird).
Warnungen können auch über die Umgebungsvariable PYTHONWARNINGS und innerhalb eines Python-Programms mithilfe des Moduls warnings gesteuert werden. Beispielsweise kann die Funktion warnings.filterwarnings() verwendet werden, um einen regulären Ausdruck auf die Warnmeldung anzuwenden.
`-X`-Option
Setzt eine implementationsspezifische Option. Die folgenden Optionen sind verfügbar:
`-X cpu_count=N`: Überschreibt den Rückgabewert von `os.cpu_count()`.
`-X cpu_count=default`: Hebt das Überschreiben auf; auch `PYTHON_CPU_COUNT`.
`-X dev`: Aktiviert den „Entwicklermodus“ von CPython, der zusätzliche Laufzeitprüfungen einführt, die standardmäßig zu aufwändig sind. Wenn der Code korrekt ist, ist dies nicht ausführlicher als der Standard: Neue Warnungen werden nur ausgegeben, wenn ein Problem erkannt wird. Auswirkungen des Entwicklermodus:
* Fügt einen Standard-Warnfilter hinzu, wie `-W default`.
* Installiert Debug-Hooks für Speicherallokatoren: siehe die C-Funktion `PyMem_SetupDebugHooks()`.
* Aktiviert das Modul `faulthandler`, um bei einem Absturz den Python-Traceback auszugeben.
* Aktiviert den Asyncio-Debugmodus.
* Setzt das Attribut `dev_mode` von `sys.flags` auf `True`.
* Der Destruktor von `io.IOBase` protokolliert Ausnahmen, die bei `close()` auftreten.
`-X importtime`: Zeigt, wie lange jeder Import dauert. Es zeigt den Modulnamen, die kumulative Zeit (einschließlich verschachtelter Importe) und die Eigenzeit (ohne verschachtelte Importe) an. Beachten Sie, dass die Ausgabe in einer Multithread-Anwendung fehlerhaft sein kann. Typische Verwendung ist
^ ython3 -X importtime -c 'import asyncio'.
`-X faulthandler`: Aktiviert `faulthandler`.
`-X frozen_modules=[on|off]`: Gibt an, ob gefrorene Module verwendet werden sollen oder nicht.
Der Standardwert ist „on“ (oder „off“, wenn Sie eine lokale Build-Umgebung verwenden).
`-X gil=[0|1]`: Aktiviert (1) oder deaktiviert (0) die GIL.
Nur in Builds verfügbar, die mit --disable-gil konfiguriert sind.
`-X int_max_str_digits=number`: Beschränkt die Größe der Konvertierungen zwischen Ganzzahlen und Zeichenketten. Dies hilft, Denial-of-Service-Angriffe beim Parsen nicht vertrauenswürdiger Daten zu verhindern. Der Standardwert ist `sys.int_info.default_max_str_digits`. `0` deaktiviert die Beschränkung.
-X no_debug_ranges: deaktiviert die Einbeziehung der Tabellen, die zusätzliche
Positionsinformationen (Zeilenende, Spaltenoffset am Anfang und Spaltenoffset am Ende) jeder Anweisung in Codeobjekten zuordnen. Dies ist nützlich, wenn kleinere Codeobjekte und .pyc-Dateien gewünscht werden, sowie um die zusätzlichen visuellen Positionsanzeigen zu unterdrücken, wenn der Interpreter Stacktraces anzeigt.
-X perf: unterstützt den Linux-„perf“-Profiler; außerdem PYTHONPERFSUPPORT=1
-X perf_jit: unterstützt den Linux-„perf“-Profiler mit DWARF-Unterstützung;
außerdem PYTHON_PERF_JIT_SUPPORT=1
-X presite=MOD: importiert dieses Modul vor „site“; außerdem PYTHON_PRESITE.
Dies funktioniert nur in Debug-Builds.
-X pycache_prefix=PFAD: ermöglicht das Schreiben von .pyc-Dateien in einen parallelen
Baum, der am angegebenen Verzeichnis verwurzelt ist, anstatt in den Codebaum.
-X showrefcount: gibt die Gesamtzahl der Referenzen und die Anzahl der verwendeten
Speicherblöcke aus, wenn das Programm beendet ist oder nach jeder Anweisung im
interaktiven Interpreter. Dies funktioniert nur in Debug-Builds.
-X tracemalloc: startet die Verfolgung von Python-Speicherzuweisungen mithilfe des
Moduls „tracemalloc“. Standardmäßig wird nur der letzte Frame in einer
Traceback gespeichert. Verwenden Sie -X tracemalloc=NFRAME, um die Verfolgung mit einer
Traceback-Grenze von NFRAME-Frames zu starten.
-X utf8: aktiviert den UTF-8-Modus für Betriebssystem-Schnittstellen, wodurch der
standardmäßige, sprachabhängige Modus überschrieben wird. -X utf8=0 deaktiviert den UTF-8-Modus
explizit (selbst wenn er sonst automatisch aktiviert würde). Weitere Informationen finden Sie unter PYTHONUTF8.
-X warn_default_encoding: aktiviert die optionale EncodingWarning für „encoding=None“.
-x Überspringt die erste Zeile der Quelldatei. Dies ist nur für einen DOS-spezifischen Hack gedacht. Warnung: Die Zeilennummern in Fehlermeldungen sind um eins verschoben!
INTERPRETER-SCHNITTSTELLE
Die Interpreter-Schnittstelle ähnelt der der UNIX-Shell: Wenn sie mit einer Standardeingabe verbunden ist, die mit einem TTY-Gerät verbunden ist, fordert sie Befehle an und führt sie aus, bis ein EOF gelesen wird; wenn sie mit einem Dateinamenargument oder mit einer Datei als Standardeingabe aufgerufen wird, liest und führt sie ein Skript aus dieser Datei aus; wenn sie mit -c Befehl aufgerufen wird, führt sie die Python-Anweisung(en) aus, die als Befehl angegeben sind. Hier kann „command“ mehrere Anweisungen enthalten, die durch Zeilenumbrüche getrennt sind. Die Leerzeichen am Anfang von Python-Anweisungen sind wichtig! Im nicht-interaktiven Modus wird die gesamte Eingabe geparst, bevor sie ausgeführt wird.
Wenn verfügbar, werden der Skriptname und alle zusätzlichen Argumente danach als Python-Variable sys.argv an das Skript übergeben, die eine Liste von Strings ist (Sie müssen zuerst sys importieren, um darauf zugreifen zu können). Wenn kein Skriptname angegeben wird, ist sys.argv[0] eine leere Zeichenkette; wenn -c verwendet wird, enthält sys.argv[0] die Zeichenkette „-c“. Beachten Sie, dass Optionen, die vom Python-Interpreter interpretiert werden, nicht in sys.argv eingefügt werden.
Im interaktiven Modus ist die primäre Eingabeaufforderung >>>; die zweite Eingabeaufforderung (die erscheint, wenn ein Befehl nicht vollständig ist) ist .... Die Eingabeaufforderungen können durch Zuweisung an sys.ps1 oder sys.ps2 geändert werden. Der Interpreter beendet sich, wenn er eine EOF an einer Eingabeaufforderung liest. Wenn eine nicht behandelte Ausnahme auftritt, wird ein Stacktrace ausgegeben und die Steuerung kehrt zur primären Eingabeaufforderung zurück; im nicht-interaktiven Modus beendet sich der Interpreter nach der Ausgabe des Stacktrace. Das Interrupt-Signal löst die Ausnahme KeyboardInterrupt aus; andere UNIX-Signale werden nicht abgefangen (mit der Ausnahme, dass SIGPIPE manchmal ignoriert wird, zugunsten der Ausnahme IOError). Fehlermeldungen werden nach stderr geschrieben.
DATEIEN UND VERZEICHNISSE
Diese können je nach lokaler Installationskonvention variieren; ${prefix} und ${exec_prefix} sind installationsabhängig und sollten wie bei GNU-Software interpretiert werden; sie können gleich sein. Unter Debian GNU/{Hurd,Linux} ist der Standardwert für beide /usr.
${exec_prefix}/bin/python
Empfohlener Speicherort des Interpreters.
${prefix}/lib/python<version>
${exec_prefix}/lib/python<version>
Empfohlene Speicherorte der Verzeichnisse, die die Standardmodule enthalten.
${prefix}/include/python<version>
${exec_prefix}/include/python<version>
Empfohlene Speicherorte der Verzeichnisse, die die Header-Dateien enthalten, die für die Entwicklung von Python-Erweiterungen und die Einbettung des Interpreters benötigt werden.
UMGEBUNGSVARIABLEN
PYTHONASYNCIODEBUG
Wenn diese Umgebungsvariable auf einen nicht leeren String gesetzt ist, wird der Debug-Modus des asyncio-Moduls aktiviert.
PYTHON_BASIC_REPL
Wenn diese Variable auf einen beliebigen Wert gesetzt ist, versucht der Interpreter nicht, die Python-basierte REPL zu laden, die curses und readline benötigt, und verwendet stattdessen die traditionelle parserbasierte REPL.
PYTHONBREAKPOINT
Wenn diese Umgebungsvariable auf 0 gesetzt ist, wird der Standard-Debugger deaktiviert. Sie kann auf den Aufruf Ihrer bevorzugten Debugger-Funktion gesetzt werden.
PYTHONCOERCECLOCALE
Wenn sie auf den Wert 0 gesetzt ist, überspringt die Haupt-Python-Befehlszeilenanwendung das Erzwingen der Konvertierung der Legacy-ASCII-basierten C- und POSIX-Lokale in eine leistungsfähigere UTF-8-basierte Alternative.
PYTHON_COLORS
Wenn diese Variable auf 1 gesetzt ist, färbt der Interpreter verschiedene Arten von Ausgaben ein. Durch das Setzen auf 0 wird dieses Verhalten deaktiviert.
PYTHON_CPU_COUNT
Wenn diese Variable auf eine positive ganze Zahl gesetzt ist, wird der Rückgabewert von os.cpu_count und os.process_cpu_count überschrieben.
Siehe auch die Option -X cpu_count.
PYTHONDEBUG
Wenn dies auf einen nicht leeren String gesetzt ist, entspricht dies der Angabe der Option -d. Wenn es auf eine ganze Zahl gesetzt ist, entspricht dies der mehrfachen Angabe von -d.
PYTHONEXECUTABLE
Wenn diese Umgebungsvariable gesetzt ist, wird sys.argv[0] auf ihren Wert gesetzt, anstatt des Werts, der über die C-Laufzeitumgebung abgerufen wird. Funktioniert nur unter Mac OS X.
PYTHONFAULTHANDLER
Wenn diese Umgebungsvariable auf einen nicht leeren String gesetzt ist, wird faulthandler.enable() beim Start aufgerufen: Installieren Sie einen Handler für die Signale SIGSEGV, SIGFPE, SIGABRT, SIGBUS und SIGILL, um den Python-Traceback auszugeben.
Dies entspricht der Option -X faulthandler.
PYTHON_FROZEN_MODULES
Wenn diese Variable auf „on“ oder „off“ gesetzt ist, bestimmt sie, ob gefrorene Module von der Importmechanik ignoriert werden oder nicht. Ein Wert von „on“ bedeutet, dass sie importiert werden, und „off“ bedeutet, dass sie ignoriert werden. Standardmäßig ist er für Nicht-Debug-Builds auf „on“ und für Debug-Builds auf „off“ gesetzt.
Siehe auch die Option -X frozen_modules.
PYTHON_GIL
Wenn diese Variable auf 1 gesetzt ist, wird das Global Interpreter Lock (GIL) erzwungen. Wenn sie auf 0 gesetzt ist, wird das GIL deaktiviert. Nur in Builds verfügbar, die mit --disable-gil konfiguriert sind.
Dies entspricht der Option -X gil.
PYTHON_HISTORY
Diese Umgebungsvariable kann verwendet werden, um den Speicherort einer Verlaufdatei festzulegen (unter Unix ist dies standardmäßig ~/.python_history).
PYTHONNODEBUGRANGES
Wenn diese Variable gesetzt ist, deaktiviert sie die Einbeziehung der Tabellen, die zusätzliche Standortinformationen (Endzeile, Startspalten-Offset und Endspalten-Offset) jedem Befehl in Code-Objekten zuordnen. Dies ist nützlich, wenn kleinere Code-Objekte und .pyc-Dateien gewünscht sind sowie um die zusätzlichen visuellen Standortanzeigen zu unterdrücken, wenn der Interpreter Rückverfolgungen anzeigt.
PYTHONDONTWRITEBYTECODE
Wenn dies auf eine nicht leere Zeichenkette gesetzt ist, entspricht dies der Angabe der Option -B (keine .pyc-Dateien schreiben).
PYTHONDEVMODE
Wenn diese Umgebungsvariable auf eine nicht leere Zeichenkette gesetzt ist, wird der „Entwicklungsmodus“ von Python aktiviert, der zusätzliche Laufzeitprüfungen einführt, die standardmäßig zu aufwendig sind.
Dies entspricht der Option -X dev.
PYTHONHASHSEED
Wenn diese Variable auf „random“ gesetzt ist, wird ein zufälliger Wert verwendet, um die Hashwerte von Str- und Byte-Objekten zu initialisieren.
Wenn PYTHONHASHSEED auf einen ganzzahligen Wert gesetzt ist, wird dieser als fester Seed zum Generieren des Hashs der durch die Hash-Randomisierung abgedeckten Typen verwendet. Der Zweck ist die Ermöglichung wiederholbarer Hashes, z. B. für Selftests des Interpreters selbst, oder um einem Cluster von Python-Prozessen zu ermöglichen, Hashwerte gemeinsam zu nutzen.
Die Ganzzahl muss eine Dezimalzahl im Bereich [0, 4294967295] sein. Die Angabe des Wertes 0 deaktiviert die Hash-Randomisierung.
PYTHONHOME
Ändern Sie den Speicherort der Standard-Python-Bibliotheken. Standardmäßig werden die Bibliotheken in ${prefix}/lib/python<version> und ${exec_prefix}/lib/python<version> durchsucht, wobei ${prefix} und ${exec_prefix} installationsabhängige Verzeichnisse sind, die standardmäßig beide auf /usr/local gesetzt sind. Wenn $PYTHONHOME auf ein einzelnes Verzeichnis gesetzt ist, ersetzt sein Wert sowohl ${prefix} als auch ${exec_prefix}. Um unterschiedliche Werte für diese anzugeben, setzen Sie $PYTHONHOME auf ${prefix}:${exec_prefix}.
PYTHONINSPECT
Wenn dies auf eine nicht leere Zeichenkette gesetzt ist, entspricht dies der Angabe der Option -i.
PYTHONINTMAXSTRDIGITS
Begrenzen Sie die maximale Anzahl von Ziffern in einem int-Wert, wenn Sie von einer Zeichenkette konvertieren und wenn Sie einen int wieder in eine Zeichenkette konvertieren. Ein Wert von 0 deaktiviert die Begrenzung. Konvertierungen von oder zu den Basen 2, 4, 8, 16 und 32 werden niemals begrenzt.
Dies entspricht der Option -X int_max_str_digits=NUMBER.
PYTHONIOENCODING
Wenn dies vor dem Ausführen des Interpreters gesetzt wird, überschreibt es die für stdin/stdout/stderr verwendete Kodierung, und zwar in der Syntax kodierungsname:fehlerbehandlung. Der Teil „fehlerbehandlung“ ist optional und hat die gleiche Bedeutung wie in str.encode. Für stderr wird der Teil „fehlerbehandlung“ ignoriert; der Handler ist immer „backslashreplace“.
PYTHONMALLOC
Legt die Python-Speicherallokatoren fest und/oder installiert Debug-Hooks. Die verfügbaren Speicherallokatoren sind malloc und pymalloc. Die verfügbaren Debug-Hooks sind debug, malloc_debug und pymalloc_debug.
Wenn Python im Debug-Modus kompiliert wird, ist die Standardeinstellung pymalloc_debug, und die Debug-Hooks werden automatisch verwendet. Andernfalls ist die Standardeinstellung pymalloc.
PYTHONMALLOCSTATS
Wenn dies auf einen nicht leeren String gesetzt ist, gibt Python Statistiken des pymalloc-Speicherallokators jedes Mal aus, wenn ein neues pymalloc-Objekt-Arena erstellt wird, und beim Herunterfahren.
Diese Variable wird ignoriert, wenn die Umgebungsvariable $PYTHONMALLOC verwendet wird, um den malloc(3)-Allokator der C-Bibliothek zu erzwingen, oder wenn Python ohne pymalloc-Unterstützung konfiguriert ist.
PYTHONNOUSERSITE
Wenn dies auf einen nicht leeren String gesetzt ist, entspricht dies der Angabe der Option -s (Fügen Sie das Benutzer-Site-Verzeichnis nicht zu sys.path hinzu).
PYTHONOPTIMIZE
Wenn dies auf einen nicht leeren String gesetzt ist, entspricht dies der Angabe der Option -O. Wenn dies auf eine ganze Zahl gesetzt ist, entspricht dies der mehrfachen Angabe von -O.
PYTHONPATH
Ergänzt den Standardsuchpfad für Moduldateien. Das Format ist das gleiche wie beim $PATH der Shell: eine oder mehrere Verzeichnis-Pfadnamen, getrennt durch Doppelpunkte. Nicht vorhandene Verzeichnisse werden stillschweigend ignoriert. Der Standardsuchpfad ist installationsabhängig, beginnt aber in der Regel mit ${prefix}/lib/python
PYTHON_PERF_JIT_SUPPORT
Wenn diese Variable auf einen Wert ungleich Null gesetzt ist, wird die Unterstützung für den Linux-Perf-Profiler aktiviert, sodass Python-Aufrufe mithilfe von DWARF-Informationen erkannt werden können. Das Setzen auf 0 deaktiviert dies.
Siehe auch die Option -X perf_jit.
PYTHONPERFSUPPORT
Wenn diese Variable auf einen Wert ungleich Null gesetzt ist, wird die Unterstützung für den Linux-Perf-Profiler aktiviert, sodass Python-Aufrufe erkannt werden können. Das Setzen auf 0 deaktiviert dies.
Siehe auch die Option -X perf.
PYTHONPLATLIBDIR
Überschreibt sys.platlibdir.
PYTHONPROFILEIMPORTTIME
Wenn diese Umgebungsvariable auf einen nicht leeren String gesetzt ist, gibt Python aus, wie lange jeder Import dauert. Dies entspricht genau dem Setzen von -X importtime auf der Kommandozeile.
PYTHONPYCACHEPREFIX
Wenn dies gesetzt ist, schreibt Python .pyc-Dateien in eine Spiegelverzeichnisstruktur an diesem Pfad, anstatt in __pycache__-Verzeichnissen innerhalb des Quellbaum.
Dies entspricht der Angabe der Option -X pycache_prefix=PATH.
PYTHONSAFEPATH
Wenn diese Variable auf einen nicht leeren String gesetzt ist, wird verhindert, dass automatisch ein potenziell unsicherer Pfad zu sys.path hinzugefügt wird, z. B. das aktuelle Verzeichnis, das Verzeichnis des Skripts oder ein leerer String. Siehe auch die Option -P.
PYTHONSTARTUP
Wenn dies der Name einer lesbaren Datei ist, werden die Python-Befehle in dieser Datei ausgeführt, bevor die erste Eingabeaufforderung im interaktiven Modus angezeigt wird. Die Datei wird im selben Namensraum ausgeführt, in dem die interaktiven Befehle ausgeführt werden, sodass in der interaktiven Sitzung ohne Qualifizierung auf darin definierte oder importierte Objekte zugegriffen werden kann. Sie können in dieser Datei auch die Eingabeaufforderungen sys.ps1 und sys.ps2 ändern.
PYTHONTRACEMALLOC
Wenn diese Umgebungsvariable auf einen nicht leeren String gesetzt ist, wird die Python-Speicherzuweisung mithilfe des tracemalloc-Moduls verfolgt.
Der Wert der Variablen ist die maximale Anzahl von Frames, die in einem Stacktrace gespeichert werden. Wenn beispielsweise PYTHONTRACEMALLOC=1 gesetzt ist, wird nur der letzte Frame gespeichert.
PYTHONUNBUFFERED
Wenn dies auf einen nicht leeren String gesetzt ist, entspricht dies der Angabe der Option -u.
PYTHONUSERBASE
Definiert das Benutzerbasisverzeichnis, das verwendet wird, um den Pfad des Verzeichnisses für benutzerdefinierte Pakete und die Installationspfade für python -m pip install --user zu berechnen.
PYTHONUTF8
Wenn dies auf 1 gesetzt ist, wird der Python-„UTF-8-Modus“ aktiviert. Wenn dies auf 0 gesetzt ist, wird er deaktiviert.
PYTHONVERBOSE
Wenn dies auf einen nicht leeren String gesetzt ist, entspricht dies der Angabe der Option -v. Wenn dies auf eine Ganzzahl gesetzt ist, entspricht dies der mehrfachen Angabe von -v.
PYTHONWARNDEFAULTENCODING
Wenn diese Umgebungsvariable auf einen nicht leeren String gesetzt ist, wird eine EncodingWarning ausgegeben, wenn die lokalspezifische Standardkodierung verwendet wird.
PYTHONWARNINGS
Wenn dies auf eine durch Kommas getrennte Zeichenfolge gesetzt ist, entspricht dies der Angabe der Option -W für jeden einzelnen Wert.
Variablen für den Debug-Modus
Das Setzen dieser Variablen hat nur dann eine Wirkung, wenn eine Debug-Version von Python verwendet wird, d. h. wenn Python mit der Build-Option --with-pydebug konfiguriert wurde.
PYTHONDUMPREFS
Wenn diese Umgebungsvariable gesetzt ist, gibt Python die Objekte und Referenzanzahlen aus, die nach dem Herunterfahren des Interpreters noch vorhanden sind.
PYTHONDUMPREFSFILE
Wenn dies gesetzt ist, gibt Python die Objekte und Referenzanzahlen aus, die nach dem Herunterfahren des Interpreters noch vorhanden sind, in eine Datei unter dem in dieser Variablen angegebenen Pfad aus.
PYTHON_PRESITE
Wenn diese Variable auf ein Modul gesetzt ist, wird dieses Modul früh im Lebenszyklus des Interpreters importiert, bevor das site-Modul ausgeführt wird und bevor das Modul __main__ erstellt wird. Dies funktioniert nur bei Debug-Builds.
Dies entspricht der Option -X presite=module.
AUTOR
Die Python Software Foundation: (https://www.python.org/psf/)
INTERNETRESSOURCEN
Hauptwebsite: (https://www.python.org/)
Dokumentation: (https://docs.python.org/)
Entwicklerressourcen: (https://devguide.python.org/)
Downloads: (https://www.python.org/downloads/)
Modul-Repository: (https://pypi.org/)
Newsgroups: comp.lang.python, comp.lang.python.announce
LIZENZIERUNG
Python wird unter einer Open-Source-Lizenz verteilt. Sehen Sie sich die Datei „LICENSE“ in der Python-Quellverteilung an, um Informationen über die Bedingungen für den Zugriff auf und die anderweitige Verwendung von Python sowie eine HAFTUNGSAUSSCHLUSS für alle Garantien zu erhalten.