CONTENTS 1 Command line and environment 3 1.1 Command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1.1 Interface options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1.2 Generic options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.1.3 Miscellaneous options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.1.4 Options you shouldn’t use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1.2 Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1.2.1 Debug-mode variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2 Using Python on Unix platforms 15 2.1 Getting and installing the latest version of Python . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.1.1 On Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.1.2 On FreeBSD and OpenBSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.1.3 On OpenSolaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.2 Building Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.3 Python-related paths and files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.4 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3 Using Python on Windows 17 3.1 The full installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 3.1.1 Installation steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 3.1.2 Removing the MAX_PATH Limitation . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 3.1.3 Installing Without UI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 3.1.4 Installing Without Downloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.1.5 Modifying an install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.2 The Microsoft Store package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 3.2.1 Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 3.3 The nuget.org packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 3.4 The embeddable package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 3.4.1 Python Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.4.2 Embedding Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.5 Alternative bundles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.6 Configuring Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.6.1 Excursus: Setting environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . 25 3.6.2 Finding the Python executable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 3.7 UTF-8 mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 3.8 Python Launcher for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 3.8.1 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 3.8.2 Shebang Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 3.8.3 Arguments in shebang lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 3.8.4 Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 3.8.5 Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 3.9 Finding modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 3.10 Additional modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 i