.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PYTHON 1 .\" To view this file while editing, run it through groff: .\" groff -Tascii -man python.man | less .SH BEZEICHNUNG python \- eine interpretierte, interaktive, objekt\-orientierte Programmiersprache .SH ÜBERSICHT \fBpython\fP [ \fB\-B\fP ] [ \fB\-b\fP ] [ \fB\-d\fP ] [ \fB\-E\fP ] [ \fB\-h\fP ] [ \fB\-i\fP ] [ \fB\-I\fP ] .br [ \fB\-m\fP \fIModulename\fP ] [ \fB\-q\fP ] [ \fB\-R\fP ] [ \fB\-O\fP ] [ \fB\-OO\fP ] [ \fB\-P\fP ] [ \fB\-s\fP ] [ \fB\-S\fP ] [ \fB\-u\fP ] .br [ \fB\-v\fP ] [ \fB\-V\fP ] [ \fB\-W\fP \fIArgument\fP ] [ \fB\-x\fP ] [ \fB\-X\fP \fIOption\fP ] [ \fB\-?\fP ] .br [ \fB\-\-check\-hash\-based\-pycs\fP \fIdefault\fP | \fIalways\fP | \fInever\fP ] .br [ \fB\-\-help\fP ] [ \fB\-\-help\-env\fP ] [ \fB\-\-help\-xoptions\fP ] [ \fB\-\-help\-all\fP ] .br [ \fB\-c\fP \fIBefehl\fP | \fISkript\fP | \- ] [ \fIArgumente\fP ] .SH BESCHREIBUNG Python ist eine interpretierte, interaktive und objekt\-orientierte Programmiersprache, die eine bemerkenswerte Leistungsfähigkeit mit sehr klarer Syntax verbindet. Für eine Einführung zur Programmierung in Python lesen Sie das Python\-Tutorial. Die Referenz der Python\-Bibliothek (Python Library Reference) dokumentiert integrierte Typen und Standard\-Typen, Konstanten, Funktionen und Module. Abschliessend beschreibt das Python\-Referenzhandbuch (Python Reference Manual) Syntax und Semantik vom Kern der Sprache (vielleicht zu) detailliert. (Diese Dokumente können über \fBINTERNETRESOURCEN\fP am Ende dieser Seite gefunden werden; sie könnten auch auf Ihrem System installiert sein.) .PP Die Leistungsfähigkeit von Python kann mit eigenen C\- oder C++\-Modulen erweitert werden. Auf den meisten Systemen können solche Module dynamisch geladen werden. Python ist auch als eine Sprache zur Erweiterung bestehender Anwendungen anpassbar. Hinweise sind in der internen Dokumentation zu finden. .PP Die Dokumentation zu installierten Python\-Modulen und \-Paketen kann mit dem Programm \fBpydoc\fP angezeigt werden. .SH BEFEHLSZEILENOPTIONEN .TP \fB\-B\fP Keine \fI.pyc\fP\-Dateien beim Import schreiben. Siehe auch PYTHONDONTWRITEBYTECODE. .TP \fB\-b\fP Gibt Warnungen aus, wenn die Funktion str() mit einer Bytes\-Instanz oder einer Bytearray\-Instanz ohne Kodierungsargument aufgerufen, oder ein Bytes\- oder Bytearray\-Objekt mit einem String\-Objekt verglichen werden soll. (\-bb: gibt stattdessen Fehler aus) .TP \fB\-c \fP\fIBefehl\fP Angabe des auszuführenden Befehls (sieht nächster Abschnitt). Das schliesst die Liste der Optionen ab (darauf folgende Optionen werden als Argumente des Befehls übergeben). .TP \fB\-\-check\-hash\-based\-pycs \fP\fIModus\fP Konfiguriert, wie Python die Aktualität Hash\-basierender .pyc\-Dateien auswertet. .TP \fB\-d\fP Aktiviert die Auswertung der Ausgaben zur Fehlersuche (nur für Experten, abhängig von Optionen bei der Kompilierung). .TP \fB\-E\fP Ignoriert Umgebungsvariable wie PYTHONPATH und PYTHONHOME, die das Verhalten des Interpreters verändern. .TP \fB\-h\fP, \fB\-?\fP, \fB\-\-help\fP Gibt eine Hilfe zur Verwendung des ausführbaren Interpreters aus und beendet sich. .TP \fB\-\-help\-env\fP Gibt eine Hilfe zu Python\-spezifischen Umgebungsvariablen aus und beendet sich. .TP \fB\-\-help\-xoptions\fP Gibt eine Hilfe zu implementierungsspezifischen Optionen \fB\-X\fP aus und beendet sich. .TP .TP \fB\-\-help\-all\fP Gibt alle Informationen zur Verwendung aus und beendet sich. .TP \fB\-i\fP Wechselt nach Ausführung des Skripts oder des Befehls in den interaktiven Modus, falls als erstes Argument ein Skript angegeben oder die Option \fB\-c\fP verwendet wurde. Damit wird die $PYTHONSTARTUP\-Datei nicht gelesen. Das kann hilfreich sein, um globale Variable oder einen Verlaufsbericht (Stacktrace) zu untersuchen, wenn ein Skript einen Ausnahmefehler auslöst. .TP \fB\-I\fP Startet Python im isolierten Modus. Das impliziert auch \fB\-E\fP, \fB\-P\fP und \fB\-s\fP. Im isolierten Modus beinhaltet sys.path weder das Verzeichnis des Skripts noch das lokale Paketverzeichnis \fIsite\-packages\fP des Benutzers. Alle PYTHON*\-Umgebungsvariablen werden ebenfalls ignoriert. Weitere Einschränkungen können auferlegt werden, um den Benutzer daran zu hindern, böswilligen Code einzuschleusen. .TP \fB\-m \fP\fIModulename\fP Sucht in \fIsys.path\fP nach dem genannten Modul und startet die entsprechende \&\fI.py\fP\-Datei als ein Skript. Das schliesst die Liste der Optionen ab (darauf folgende Optionen werden als Argumente an das Modul übergeben). .TP \fB\-O\fP Entfernt Assert\-Anweisungen und jeden Code, der vom Wert von __debug__ abhängt; erweitert den Dateinamen für kompilierte (Bytecode\-) Dateien durch das Einfügen von ».opt\-1« vor der Erweiterung ».pyc«. .TP \fB\-OO\fP Verhält sich wie \fB\-O\fP und schließt zusätzlich Docstrings aus; ändert den Dateinamen für kompilierte (Bytecode\-) Dateien durch das Einfügen von ».opt\-2« vor der Erweiterung ».pyc«. .TP \fB\-P\fP Stellt nicht automatisch einen potentiell unsicheren Pfad wie das aktuelle Verzeichnis, das Verzeichnis des Skripts oder eine leere Zeichenkette vor \fBsys.path\fP. Siehe auch die Umgebungsvariable \fBPYTHONSAFEPATH\fP. .TP \fB\-q\fP Keine Anzeige von Version\- und Copyright\-Meldungen. Diese Meldungen werden im nicht interaktiven Modus ebenfalls unterdrückt. .TP \fB\-R\fP Schaltet Hash\-Verwürfelung ein. Diese Option wird nur wirksam, falls die Umgebungsvariable \fBPYTHONHASHSEED\fP auf \fB0\fP gesetzt ist, da die Hash\-Verwürfelung standardmäßig aktiviert ist. .TP \fB\-s\fP Fügt das lokale Paketverzeichnis des Benutzers nicht dem sys.path hinzu. .TP \fB\-S\fP Unterbindet den Import des Moduls \fIsite\fP und der installationsabhängigen Veränderungen von \fIsys.path\fP, die er zur Folge hätte. Unterbindet diese Veränderungen auch, wenn \fIsite\fP später explizit importiert wird. .TP \fB\-u\fP Erzwingt, dass die Standardeingabe\- und Standardfehlerausgabeströme ungepuffert sind. Diese Option hat keinen Einfluss auf den Standardeingabestrom. .TP \fB\-v\fP Zeigt bei jeder Initialisierung eines Moduls an, woher (Dateiname oder eingebautes Modul) es geladen wurde. Gibt bei doppelter Angabe eine Meldung für jede untersuchte Datei aus, wenn ein Modul gesucht wird. Liefert auch Informationen über das Aufräumen eines Moduls bei Beendigung. .TP \fB\-V\fP, \fB\-\-version\fP Zeigt die Python\-Versionsnummer an und beendet sich. Zeigt bei doppelter Angabe zusätzliche Informationen zum Bau an. .TP \fB\-W \fP\fIArgument\fP Steuerung von Warnungen. Der Warnungsmechanismus von Python gibt Meldungen standardmäßig auf \fIsys.stderr\fP aus. Die einfachsten Einstellungen wenden jeweils eine bestimmte Aktion an, unabhängig von allen Warnungen, die ein Prozess ausgibt (sogar von denen, die sonst standardmäßig ignoriert werden würden): \-Wdefault # Einmal pro aufrufender Stelle warnen \-Werror # Umwandlung zu Ausnahmefehlern \-Walways # Immer warnen \-Wall # Identisch zu \-Walways \-Wmodule # Einmal pro aufrufendem Modul warnen \-Wonce # Einmal pro Python\-Prozess warnen \-Wignore # Niemals warnen Die Aktionsnamen können wie gewünscht abgekürzt werden und der Interpreter wird sie zum passenden Namen auflösen. Zum Beispiel ist \fB\-Wi\fP das gleiche wie \fB\-Wignore\fP. Die vollständige Form des Arguments lautet: \fIAktion:Meldung:Kategorie:Modul:Zeilennummer\fP Leere Felder passen auf alle Werte; leere Felder am Ende können weggelassen werden. Zum Beispiel ignoriert \fB\-W ignore::DeprecationWarning\fP alle Warnungen vom Typ DeprecationWarning. Das Feld \fIAktion\fP wirkt wie oben erklärt, betrifft aber nur Warnungen, die auf die restlichen Felder passen. Das Feld \fIMeldung\fP muss auf die gesamte ausgegebene Warnmeldung passen; der Vergleich ignoriert Groß\- und Kleinschreibung. Das Feld \fIKategorie\fP passt auf die Kategorie der Warnung (z.B.: »DeprecationWarning«). Dies muss ein Klassenname sein; es wird verglichen, ob die Kategorie der aktuellen Warnmeldung eine Unterklasse der angegebenen Kategorie der Warnung ist. Das Feld \fIModul\fP passt auf den (vollständigen) Modulnamen; dieser Vergleich berücksichtigt die Groß\- und Kleinschreibung. Das Feld \fIZeilennummer\fP passt auf die Zeilennummer, wobei die Null auf alle Zeilennummern passt und damit äquivalent zu einer weggelassenen Zeilennummer ist. Es können mehrere Optionen \fB\-W\fP angegeben werden; wenn eine Warnung auf mehr als eine Option passt, dann wird die Aktion zur letzten passenden Option ausgeführt. Ungültige Optionen \fB\-W\fP werden ignoriert (jedoch wird bei der ersten ausgegebenen Warnmeldung eine Meldung zu ungültigen Optionen ausgegeben). Warnungen können auch mittels der Umgebungsvariablen \fBPYTHONWARNINGS\fP und aus einem Python\-Programm heraus mit dem Warnings\-Modul gesteuert werden. Zum Beispiel kann die Funktion warnings.filterwarnings() verwendet werden, um einen regulären Ausdruck auf die Warnmeldung anzuwenden. .TP \fB\-X \fP\fIOption\fP Setzt implementierungsspezifische Option. Folgende Optionen sind verfügbar: \fB\-X cpu_count=\fP\fIN\fP: setzt den Rückgabewert von \fIos.cpu_count()\fP außer Kraft; \fB\-X cpu_count=default\fP bricht die Außerkraftsetzung ab; auch \fBPYTHON_CPU_COUNT\fP \fI \fP\fB\-X dev\fP: aktiviert den »Entwicklungsmodus« von CPython, der zusätzliche Laufzeit\- Diagnosen bereitstellt, die für eine standardmäßige Aktivierung zu aufwendig sind. Wenn der Code in Ordnung ist, werden nicht mehr Meldungen ausgegeben als in der Voreinstellung: Neue Warnungen werden nur ausgegeben, wenn ein Problem erkannt wird. Effekt des »Entwicklungsmodus«: * Hinzufügen eines standardmäßigen Warnungsfilters, wie \fB\-W default\fP * Installiert zur Fehlersuche Hooks auf Speicherzuweiser: siehe die C\-Funktion PyMem_SetupDebugHooks() * Aktiviert das Modul zur Fehlerbehandlung, um bei einem Absturz Python\-Rückverfolgungsprotokolle zu schreiben * Aktiviert den Modus zur Fehlersuche des Asyncio\-Moduls * Setzt das dev_mode Attribut vom sys.flags auf »True« * io.IOBase Destruktor zeichnet close()\-Ausnahmefehler auf \fB\-X importtime\fP: zeigt, wie lange jeder Import dauert. Angezeigt werden Modulname, Gesamtzeit (inklusive verschachtelter Importe) und Einzelzeit (ohne verschachtelter Importe). Beachten Sie, dass dessen Ausgabe in Applikationen mit mehreren Threads zerstückelt sein kann. Ein typischer Aufruf ist \fBpython3 \-X importtime \-c 'import asyncio'\fP \fB\-X importtime=2\fP aktiviert zusätzliche Ausgabe, die anzeigt, wenn ein importiertes Modul bereits geladen wurde. In diesen Fällen wird die Zeichenkette \fBcached\fP in beiden Zeitspalten ausgegeben. \fB\-X faulthandler\fP: aktiviert Fehlerbehandlung \fB\-X frozen_modules=\fP[\fBon\fP|\fBoff\fP]: ob eingefrorene Module (als statisches Programm inklusive Interpreter, siehe https://wiki.python.org/moin/Freeze) verwendet werden können oder nicht. Die Voreinstellung ist »on« (oder »off«, wenn Sie einen lokalen Bau laufen lassen). \fB\-X gil=\fP[\fB0\fP|\fB1\fP]: aktiviert (1) oder deaktiviert (0) die GIL; auch \fBPYTHON_GIL\fP Nur verfügbar in Bauten, die mit \fB\-\-disable\-gil\fP konfiguriert worden sind. \fB\-X int_max_str_digits=\fP\fIZahl\fP: begrenzt die Größe bei Umwandlungen von int<\->str. Das ist hilfreich, um Diensteverweigerungsangriffe bei der Verarbeitung nicht vertrauenswürdiger Daten zu vermeiden. Die Voreinstellung ist sys.int_info.default_max_str_digits. 0 deaktiviert dies. \fB\-X no_debug_ranges\fP: deaktiviert das Hinzufügen von Tabellen zur Zuordnung von zusätzlichen Positionsangaben (letzte Zeile, Start und Ende vom Spaltenversatz) zu jedem Befehl in Codeobjekten. Das ist hilfreich, wenn kleinere Codeobjekte und pyc\-Dateien gewünscht werden oder zur Unterdrückung zusätzlicher visueller Positionsindikatoren beim Anzeigen von Rückverfolgungen durch den Interpreter. \fB\-X perf\fP: unterstützt den Linux\-Profiler »perf«; auch \fBPYTHONPERFSUPPORT=1\fP \fB\-X perf_jit\fP: unterstützt den Linux\-Profiler »perf« mit DWARF\-Unterstützung; auch \fBPYTHON_PERF_JIT_SUPPORT=1\fP \fB\-X presite=\fP\fIMOD\fP: importiert dieses Modul vor »site«; auch \fBPYTHON_PRESITE\fP Dies funktioniert nur in Fehlersuch\-Bauten. \fB\-X pycache_prefix=\fP\fIPFAD\fP: ermöglicht das Schreiben von .pyc\-Dateien in einen parallelen Baum, dessen Wurzel im angegebenen Verzeichnis anstatt in dem Baum des Codes liegt. \fB\-X showrefcount\fP: gibt nach jedem Befehl im interaktiven Interpreter oder bei Beendigung des Programms den gesamten Referenzzähler sowie die Anzahl der verwendeten Speicherblöcke aus. Das funktioniert nur mit Programmen, die mit aktivierter Fehlersuchoption gebaut wurden \fB\-X tracemalloc\fP: beginnt die Verfolgung von Speicherzuweisungen von Python mit dem Tracemalloc\-Modul. Standardmäßig wird nur der allerneuste Frame in der Rückverfolgung abgespeichert. Verwenden Sie \fB\-X tracemalloc=NFRAME\fP, um die Rückverfolgung mit einer Begrenzung auf \fINFRAME\fP Frames zu starten \fB\-X utf8\fP: aktiviert den UTF\-8\-Modus für Schnittstellen zum Betriebssystem. Der voreingestellte »locale\-aware«\-Modus wird überschrieben. \fB\-X utf8=0\fP deaktiviert den UTF\-8 Modus explizit (auch, wenn es auf andere Weise automatisch aktiviert worden wäre). Siehe \fBPYTHONUTF8\fP für weitere Details \fB\-X warn_default_encoding\fP: aktiviert die optionale EncodingWarning für 'encoding=None' .TP \fB\-x\fP Überspringt die erste Zeile der Quelle. Dies ist nur für einen DOS\-spezifischen Hackvorgesehen. Vorsicht: die Zeilennummern in Fehlermeldungen sind um eins versetzt! .SH INTERPRETERSCHNITTSTELLE Das Interpreter\-Schnittstelle ähnelt dem der UNIX\-Shell: wenn sie angeschlossen an einem TTY\-Gerät über die Standardeingabe aufgerufen wird, fragt sie nach Befehlen, bis sie ein EOF liest; wenn sie mit einem Dateinamen als Argument oder mit einer Datei als Standardeingabe aufgerufen wird, liest sie ein \fISkript\fP aus dieser Datei und führt sie aus; wenn sie mit \fB\-c\fP \fIBefehl\fP aufgerufen wird, führt sie die als \fIBefehl\fP gegebenen Python\-Anweisungen aus. Hier kann \fIBefehl\fP mehrere durch Zeilenumbrüche getrennte Anweisungen beinhalten. In Python\-Anweisungen sind führende Leerzeichen relevant! Im nicht interaktiven Modus wird die gesamte Eingabe ausgewertet, bevor sie ausgeführt wird. .PP Der Skriptname und zusätzliche Argumente werden, falls verfügbar, danach dem Skript in der Python\-Variablen \fIsys.argv\fP übergeben, die eine Liste von Zeichenketten ist (Sie müssen erst \fIimport sys\fP aufrufen, um darauf zugreifen zu können). Wenn kein Skriptname angegeben ist, ist \fIsys.argv[0]\fP eine leere Zeichenkette; wenn \fB\-c\fP verwendet wird, enthält \fIsys.argv[0]\fP die Zeichenkette \fI»\-c«\fP. Beachten Sie, dass Optionen, die der Python\-Interpreter selbst interpretiert, nicht in \fIsys.argv\fP erscheinen. .PP Die primäre Eingabeaufforderung im interaktiven Modus ist »>>>«; die sekundäre (welche erscheint, wenn ein Befehl nicht vollständig ist) ist »...«. Diese Eingabeaufforderungen können mittels Zuweisungen zu \fIsys.ps1\fP oder \fIsys.ps2\fP geändert werden. Der Interpreter beendet sich, wenn er in der Eingabeaufforderung ein EOF liest. Wenn ein unbehandelter Ausnahmefehler auftritt, wird ein Verlaufsbericht ausgegeben und die Kontrolle wird an die primäre Eingabeaufforderung zurückgegeben; im nicht interaktiven Modus beendet sich der Interpreter nach der Ausgabe des Verlaufsberichts. Das Interrupt\-Signal löst eine \fIKeyboard\%Interrupt\fP\-Ausnahme aus; andere UNIX\-Signale werden nicht abgefangen (abgesehen davon, dass SIGPIPE manchmal zu Gunsten eines \fIIOError\fP\-Ausnahmefehlers ignoriert wird). Fehlermeldungen werden in die Standardfehlerausgabe geschrieben. .SH "DATEIEN UND VERZEICHNISSE" Sie sind unterliegen Unterschieden und sind abhängig von den lokalen Konventionen der Installationen; ${prefix} und ${exec_prefix} sind installationsabhängig und sollten wie für GNU\-Software interpretiert werden; sie können identisch sein. Die Voreinstellung ist für beide \fI/usr/local\fP. .IP \fI${exec_prefix}/bin/python\fP Empfohlener Ort des Interpreters. .PP \fI${prefix}/lib/python\fP .br \fI${exec_prefix}/lib/python\fP .RS Empfohlene Orte der Verzeichnisse für die Standard\-Module. .RE .PP \fI${prefix}/include/python\fP .br \fI${exec_prefix}/include/python\fP .RS Empfohlene Orte der Verzeichnisse für Include\-Dateien, die zur Entwicklung von Python\-Erweiterungen und zur Einbettung des Interpreters benötigt werden. .RE .SH UMGEBUNGSVARIABLEN .IP PYTHONASYNCIODEBUG Wenn diese Umgebungsvariable auf eine nicht\-leere Zeichenkette gesetzt ist, aktiviert das den Modus zur Fehlersuche des Asyncio\-Moduls. .IP PYTHON_BASIC_REPL Falls diese Variable auf irgendeinen Wert gesetzt ist, wird der Interpreter nicht versuchen, den Python\-basierten REPL zu laden, der Curses und Readline benötigt und wird stattdessen den traditionellen, Auswerte\-basierten REPL laden. .IP PYTHONBREAKPOINT Wenn diese Umgebungsvariable auf 0 gesetzt ist, deaktiviert dies das standardmäßige Programm zur Fehlersuche. Es kann auf die ausführbare Datei des Fehlersuchprogramms Ihrer Wahl gesetzt werden. .IP PYTHONCOERCECLOCALE Falls auf den Wert 0 gesetzt ist, führt dies dazu, dass die Haupt\-Python\-Befehlszeilenanwendung das Erzwingen der veralteten ASCII\-basierten C\- und POSIX\-Locales für eine leistungsfähigere UTF\-8\-basierte Alternative überspringt. .IP PYTHON_COLORS Wenn diese Variable auf 1 gesetzt ist, wird der Interpreter verschiedene Ausgaben farblich hervorheben. Setzen auf 0 deaktiviert dieses Verhalten. .IP PYTHON_CPU_COUNT Falls diese Variable auf eine positive Ganzzahl gesetzt wird, setzt sie die Rückgabewerte von \fIos.cpu_count\fP und \fIos.process_cpu_count\fP außer Kraft. .IP Siehe auch die Option \fB\-X cpu_count\fP. .IP PYTHONDEBUG Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-d\fP. Im Fall einer Ganzzahl entspricht es der mehrmaligen Verwendung von \fB\-d\fP. .IP PYTHONEXECUTABLE Wenn diese Umgebungsvariable gesetzt ist, wird \fIsys.argv[0]\fP auf diesen Wert gesetzt, und zwar anstatt des Wertes, der über die C\-Laufzeitumgebung erhalten wird. Dies funktioniert nur unter MAC OS X. .IP PYTHONFAULTHANDLER Wenn diese Umgebungsvariable auf eine nicht\-leere Zeichenkette gesetzt ist, wird \fIfaulthandler.enable()\fP beim Start aufgerufen; installiert einen Handler für die Signale SIGSEGV, SIGFPE, SIGABRT, SIGBUS und SIGILL zur Abspeicherung der Python\-Rückverfolgung. .IP Dies ist zu der Option \fB\-X faulthandler\fP äquivalent. .IP PYTHON_FROZEN_MODULES Falls diese Variable auf \fBon\fP oder \fBoff\fP gesetzt wird, bestimmt sie, ob eingefrorene Module durch die Importier\-Maschinerie ignoriert werden oder nicht. Ein Wert von \fBon\fP bedeutet, dass sie importiert werden und \fBoff\fP bedeutet, dass sie ignoriert werden. Der Vorgabewert ist \fBon\fP, falls kein Fehlersuchbau aktiviert ist (dem normalen Fall), und \fBoff\fP beim aktivierten Fehlersuchbau. .IP Siehe auch die Option \fB\-X frozen_modules\fP. .IP PYTHON_GIL Wenn diese Variable auf 1 gesetzt ist, wird die globale Interpretersperre (global interpreter lock, GIL) zwangsweise eingeschaltet. Das Setzen auf 0 schaltet die Sperre zwangsweise aus. Nur verfügbar in Bauten, die mit \fB\-\-disable\-gil\fP konfiguriert worden sind. .IP Dies ist zu der Option \fB\-X gil\fP äquivalent. .IP PYTHON_HISTORY Diese Umgebungsvariable kann verwendet werden, um den Ort einer Verlaufsdatei zu spezifizieren (unter Unix ist die Voreinstellung \fI~/.python_history\fP). .IP PYTHONNODEBUGRANGES Falls diese Variable gesetzt ist, wird das Hinzufügen von Tabellen zur Zuordnung von zusätzlichen Positionsangaben (letzte Zeile, Start und Ende vom Spaltenversatz) zu jedem Befehl in Codeobjekten deaktiviert. Das ist hilfreich, wenn kleinere Codeobjekte und pyc\-Dateien gewünscht werden oder zur Unterdrückung zusätzlicher visueller Positionsindikatoren beim Anzeigen von Rückverfolgungen durch den Interpreter. .IP PYTHONDONTWRITEBYTECODE Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-B\fP (versucht nicht, \fI.pyc\fP\-Dateien zu schreiben). .IP PYTHONDEVMODE Wenn diese Umgebungsvariable auf eine nicht\-leere Zeichenkette gesetzt ist, aktiviert das den »Entwicklungsmodus«, der zusätzliche Laufzeitüberprüfungen einführt, die zu aufwändig für den Standardfall sind. .IP Dies ist zu der Option \fB\-X dev\fP äquivalent. .IP PYTHONHASHSEED Wenn diese Variable auf »random« gesetzt ist, wird zur Initialisierung der Hashes von String\- und Byte\-Objekten ein Zufallswert genommen. Wenn PYTHONHASHSEED auf einen ganzzahligen Wert gesetzt ist, wird dieser als fester Initialisierungswert zur Erzeugung vom hash() der Typen, die durch die Hash\-Verwürfelung abgedeckt werden. Sein Zweck besteht darin, reproduzierbare Hashes zu ermöglichen, wie zum Beispiel für Selbsttest des Interpreters, oder um Cluster von Python\-Prozessen zu ermöglichen, die selben Hash\-Werte zu verwenden. Die Ganzzahl muss eine Dezimalzahl im Intervall [0,4294967295] sein. Die Angabe des Wertes 0 deaktiviert die Hash\-Verwürfelung. .IP PYTHONHOME Ändert den Ort der Standard\-Python\-Bibliotheken. Standardmäßig werden Bibliotheken in ${prefix}/lib/python und ${exec_prefix}/lib/python gesucht, wobei ${prefix} und ${exec_prefix} installationsabhängige Verzeichnisse sind, beide sind standardmäßig \fI/usr/local\fP. Wenn $PYTHONHOME ein einzelnes Verzeichnis ist, ersetzt dessen Name sowohl ${prefix} als auch ${exec_prefix}. Um dafür unterschiedliche Namen festzulegen, ist $PYTHONHOME auf ${prefix}:${exec_prefix} zu setzen. .IP PYTHONINSPECT Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-i\fP. .IP PYTHONINTMAXSTRDIGITS Begrenzt die Anzahl der Ziffern einer Ganzzahl bei der Umwandlung zu einer Zeichenkette und der Umwandlung von einer Ganzzahl zurück zu einer Zeichenkette. Ein Wert von 0 deaktiviert die Begrenzung. Umwandlungen von oder zu den Basen 2, 4, 8, 16 und 32 sind stets unbegrenzt. .IP Dies ist zu der Option \fB\-X int_max_str_digits=\fP\fIZAHL\fP äquivalent. .IP PYTHONIOENCODING Wenn dies vor dem Start des Interpreters gesetzt wird, überschreibt es die Kodierung, die für die Standardeingabe, \-ausgabe und \-fehlerausgabe verwendet wird, in der Syntax \fIKodierungsname\fP\fB:\fP\fIFehlersteuerungsprogramm\fP Der Teil \fIFehlersteuerungsprogramm\fP ist optional und hat dieselbe Bedeutung wie in str.encode. Der Teil \fIFehlersteuerungsprogramm\fP wird für die Standardfehlerausgabe ignoriert; die Steuerung ist stets \'backslashreplace\'. .IP PYTHONMALLOC Setzt Python\-Speicherzuweiser und/oder installiere Hooks zur Fehlersuche. Die verfügbaren Speicherzuweiser sind \fImalloc\fP und \fIpymalloc\fP. Die verfügbaren Hooks zur Fehlersuche sind \fIdebug\fP, \fImalloc_debug\fP und \fIpymalloc_debug\fP. .IP Wenn Python im Fehlersuchmodus kompiliert worden ist, ist die Voreinstellung \fIpymalloc_debug\fP und die Hooks zur Fehlersuche werden automatisch verwendet. Ansonsten ist die Voreinstellung \fIpymalloc\fP. .IP PYTHONMALLOCSTATS Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, wird Python jedes mal, wenn eine Pymalloc\-Objekt\-Arena erzeugt wird, und beim Beenden eine Statistik der Pymalloc\-Speicherzuweisungen anzeigen. .IP Diese Variable wird ignoriert, falls die $\fBPYTHONMALLOC\fP Umgebungsvariable verwendet wird, um den Zuweiser der C\-Bibliothek \fBmalloc\fP(3) zu erzwingen, oder falls Python ohne Pymalloc\-Unterstützung konfiguriert worden ist. .IP PYTHONNOUSERSITE Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-s\fP (fügt das lokale Paketverzeichnis des Benutzers nicht dem sys.path hinzu). .IP PYTHONOPTIMIZE Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-O\fP. Im Fall einer Ganzzahl entspricht es der mehrmaligen Verwendung von \fB\-O\fP. .IP PYTHONPATH Erweitert den standardmäßigen Suchpfad für Modul\-Dateien. Das Format ist wie von $PATH der Shell: Einer oder mehrere durch Doppelpunkte getrennte Verzeichnisnamen. Nicht existierende Verzeichnisse werden ohne Rückmeldung ignoriert. Der standardmäßige Suchpfad ist installationsabhängig, beginnt aber generell mit ${prefix}/lib/python (siehe PYTHONHOME oben). Der standardmäßige Suchpfad wird stets an $PYTHONPATH angehängt. Wenn als Argument ein Skript angegeben ist, dann wird das Verzeichnis, in dem das Skript liegt, im Pfad noch vor $PYTHONPATH eingefügt. Der Suchpfad kann aus einem Python\-Programm heraus mittels der Variablen \fIsys.path\fP verändert werden. .IP PYTHON_PERF_JIT_SUPPORT Falls diese Variable auf einen von Null verschiedenen Wert gesetzt ist, wird die Unterstützung für den Profiler perf aktiviert, so das Python\-Aufrufe durch ihn mittels DWARF\-Informationen erkannt werden können. Setzen auf 0 deaktiviert dies. .IP Siehe auch die Option \fB\-X perf_jit\fP. .IP PYTHONPERFSUPPORT Falls diese Variable auf einen von Null verschiedenen Wert gesetzt ist, wird die Unterstützung für den Profiler perf aktiviert, so das Python\-Aufrufe durch ihn erkannt werden können. Setzen auf 0 deaktiviert dies. .IP Siehe auch die Option \fB\-X perf\fP. .IP PYTHONPLATLIBDIR Überschreibt sys.platlibdir. .IP PYTHONPROFILEIMPORTTIME Falls diese Umgebungsvariable auf \fB1\fP gesetzt ist, wird Python anzeigen, wie lange jeder Import benötigt. Falls auf \fB2\fP gesetzt, wird Python Ausgaben für importierte Module aufnehmen, die bereits geladen wurden. Dies ist genau äquivalent zum Setzen von \fB\-X importtime\fP auf der Befehlszeile. .IP PYTHONPYCACHEPREFIX Falls dies gesetzt ist, wird Python \fB.pyc\fP\-Dateien in einem Spiegelverzeichnisbaum unter diesem Pfad anstelle von \fB__pycache__\fP\-Verzeichnissen innerhalb des Quellbaums schreiben. .IP Dies ist zu der Angabe der Option \fB\-X pycache_prefix=\fP\fIPFAD\fP äquivalent. .IP PYTHONSAFEPATH Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, wird nicht automatisch ein potentiell unsicher Pfad wie das aktuelle Verzeichnis, das Verzeichnis des Skripts oder eine leere Zeichenkette \fBsys.path\fP vorangestellt. Siehe auch die Option \fB\-P\fP. .IP PYTHONSTARTUP Wenn dies der Name einer lesbaren Datei ist, werden die Python\-Befehle aus dieser Datei ausgeführt, bevor die erste Eingabeaufforderung im interaktiven Modus angezeigt wird. Die Datei wird im selben Namensraum ausgeführt, in dem interaktive Befehle ausgeführt werden, so dass in ihr definierte oder importierte Objekte unverändert in der interaktiven Sitzung verwendet werden können. Sie können in dieser Datei auch die Eingabeaufforderungen \fIsys.ps1\fP und \fIsys.ps2\fP ändern. .IP PYTHONTRACEMALLOC Wenn diese Umgebungsvariable auf eine nicht\-leere Zeichenkette gesetzt ist, startet das die Rückverfolgung von Python\-Speicherzuweisungen mit dem Tracemalloc\-Modul. .IP Der Wert dieser Variablen ist die maximale Anzahl von Frames, die in der Rückverfolgung abgespeichert werden. Zum Beispiel speichert \fIPYTHONTRACEMALLOC=1\fP nur den allerneusten Frame. .IP PYTHONUNBUFFERED Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-u\fP. .IP PYTHONUSERBASE Definiert das Benutzerverzeichnis, welches verwendet wird, um das lokale Paketverzeichnis \fIsite\-packages\fP des Benutzers und die Installationspfade für \fIpython \-m pip install \-\-user\fP zu bestimmen. .IP PYTHONUTF8 Falls auf 1 gesetzt ist, aktiviert Python den »UTF\-8 Mode«. Setzen auf 0 deaktiviert. .IP PYTHONVERBOSE Wenn dies auf eine nicht\-leere Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-v\fP. Im Fall einer Ganzzahl entspricht es der mehrmaligen Verwendung von \fB\-v\fP. .IP PYTHONWARNDEFAULTENCODING Wenn diese Umgebungsvariable auf eine nicht\-leere Zeichenkette gesetzt ist, löst dies eine \fIEncodingWarning\fP aus, wenn die Locale\-genaue Standardkodierung verwendet wird. .IP PYTHONWARNINGS Wenn dies auf eine durch Kommata getrennte Zeichenkette gesetzt ist, entspricht es der Verwendung der Option \fB\-W\fP für jeden einzelnen Wert. .SS "Variablen des Fehlersuchmodus" Das Setzen dieser Variablen hat nur eine Wirkung in einem Python mit aktivierter Fehlersuche, also nur, wenn Python mit der Bauoption \fB\-\-with\-pydebug\fP konfiguriert worden ist. .IP PYTHONDUMPREFS Wenn diese Umgebungsvariable gesetzt ist, wird Python Objekte und Referenzzähler rausschreiben, die nach dem Herunterfahren des Interpreters noch aktiv sind. .IP PYTHONDUMPREFSFILE Wenn gesetzt, wird Python Objekte und Referenzzähler, die nach dem Herunterfahren des Interpreters noch aktiv sind in eine Datei unter einem Pfad, der als Wert für diese Umgebungsvariable angegeben ist, rausschreiben. .IP PYTHON_PRESITE Falls diese Variable auf ein Modul gesetzt ist, wird dieses Modul früh im Lebenszyklus des Interpreters importiert, bevor das Modul \fIsite\fP ausgeführt und das Modul \fI__main__\fP erstellt wird. Dies funktioniert nur für Fehlersuchbauten. .IP Dies ist zu der Option \fB\-X presite=\fP\fIModul\fP äquivalent. .SH AUTOR Die Python Software Foundation: https://www.python.org/psf/ .SH INTERNETRESOURCEN Haupt\-Website: https://www.python.org/ .br Dokumentation: https://docs.python.org/ .br Entwicklerressourcen: https://devguide.python.org/ .br Downloads: https://www.python.org/downloads/ .br Modul\-Depot: https://pypi.org/ .br Newsgroups: comp.lang.python, comp.lang.python.announce .SH LIZENSIERUNG Python wird unter einer Open\-Source\-Lizenz verbreitet. Siehe die Datei »LICENSE« in der Python\-Quell\-Distribution zu Informationen über Lizenzbedingungen zum Zugang zu Python und dessen anderweitiger Verwendung und zu einem HAFTUNGSAUSSCHLUSS. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Christoph Brinkhaus und Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: .MT debian-l10n-german@lists.debian.org .ME .