pyexecute is a python package that facilitates the conversion of python files (.py) to executable (.exe).
1. Virtual Environment Management:
- Automatically detects if a script is being run within a virtual environment.
- Activates a specified virtual environment if not already active.
2. Script Execution:
- Executes a given Python script using
PyInstallerto create a standalone executable. - Ensures the script is executed within the correct environment and with the necessary dependencies.
3. PyInstaller Integration:
- Checks for the presence of
PyInstallerand installs it if not already available. - Uses
PyInstallerto bundle the specified script into a single executable file.
4. Command-Line Interface (CLI):
- Provides a simple CLI for users to specify the script to be executed and the virtual environment to be used.
- Supports additional options such as allowing overwrite of existing files.
5. File Management:
- Copies the generated executable to the specified directory.
- Cleans up build artifacts created during the
PyInstallerprocess.
6. Error Handling:
- Provides comprehensive error handling to manage issues such as missing scripts, failed installations, and execution errors.
It is recommended to install in a global environment to ensure that the pyexecute command is available system-wide.
pip install git+https://github.com/fernandoluiz2003/pyexecute.gitAfter the installation, you need to add the Scripts directory to the PATH to use the commands from any directory.
- Locate the
Scriptsdirectory:
C:\Users\<YourUsername>\AppData\Local\Packages\PythonSoftwareFoundation.Python.<Version>\LocalCache\local-packages\Python<Version>\Scripts- Add to PATH:
Open the Start Menu, search for Environment Variables, and select "Edit the system environment variables".
In the System Properties window, click on the Environment Variables button.
Under System variables, scroll down and find the Path variable, then select it and click "Edit."
Click "New" and paste the path to the Scripts directory.
Click "OK" to close all windows.
To use the package, you need to have an virtualenv in the directory of your project.
pyexecute <script_path> [--venv <venv_path>] [--overwrite]- script_path: The path to the python file.
- venv:(optional): The path to the venv folder. If default, it will try to find the virtual environment in the directory.
- overwrite:(optional): A flag to allow overwriting. If default:, overwrite is False.
The main reason is to simplify the process of managing virtual environments and running Python scripts, making it a valuable tool for developers who frequently work with different environments and need to generate independent executables.
