dadidanlab.com

Executing Python (.py) Files and Creating Standalone Binaries

Python .py files are source code that are executed by a Python interpreter. To distribute a Python application as a standalone program without requiring a separate Python installation, tools like PyInstaller can package the script and its dependencies into a single, platform-specific executable.

The Problem

The user is attempting to treat a .py file as a data format rather than a source code file. They are seeking methods to execute these files directly and inquire about alternatives to compiled executables (e.g., .exe on Windows) that would allow their Python program to run independently of a full Python environment.

The Solution

To execute a Python script or to package it into a standalone executable, follow these procedures:

To run a .py file directly using the Python interpreter:

# Assuming your script is named 'my_script.py'
# my_script.py
def main():
    print("This is a Python application.")
    print("It runs using the Python interpreter.")

if __name__ == "__main__":
    main()

Execute this script from your terminal:

python my_script.py

To create a standalone executable (e.g., an .exe on Windows, or a similar binary on macOS/Linux) using PyInstaller:

# First, install PyInstaller if you haven't already
pip install pyinstaller

# Then, run PyInstaller on your script.
# The --onefile option packages everything into a single executable file.
pyinstaller --onefile my_script.py

After successful execution, your standalone executable will be located in the dist/ directory relative to your project.

Why It Works

  • Python Interpreter: The fundamental method for executing a .py file is by invoking the Python interpreter (python command) followed by the script’s path. The interpreter reads the source code, translates it into bytecode, and executes the instructions.
  • if __name__ == "__main__": Construct: This standard Python idiom ensures that code within this block (e.g., main() function call) only executes when the script is run directly. When the script is imported as a module into another Python file, this block is skipped, preventing unintended execution.
  • PyInstaller’s Bundling Mechanism: PyInstaller is a third-party utility that analyzes your Python script to identify all its required modules and external libraries. It then bundles these dependencies, along with a stripped-down Python interpreter, into a single, self-contained folder or file. This output is a native executable for the operating system it was built on, allowing the application to run on machines that do not have Python installed.
  • Platform Specificity: PyInstaller generates executables that are specific to the operating system and architecture on which the pyinstaller command is executed. A Windows executable must be built on Windows, a macOS executable on macOS, and a Linux executable on Linux.

Reference