stouputils.installer.main module#

Main module of the installer subpackage for stouputils.

Provides functions for installing programs from local zip files or URLs. It handles downloading, extracting, and setting up programs in a platform-agnostic way.

This module contains the core installation functions that are used by both the Windows and Linux/macOS specific modules.

extract_archive(
extraction_path: str,
temp_dir: str,
extract_func: Callable[[str], None],
get_file_list_func: Callable[[], list[str]],
) → None[source]#

Helper function to extract archive files with consistent handling.

Parameters:

  • extraction_path (str) – Path where files should be extracted

  • temp_dir (str) – Temporary directory for intermediate extraction

  • extract_func (Callable[[str], None]) – Function to extract the archive

  • get_file_list_func (Callable[[], list[str]]) – Function to get the list of files in the archive

get_install_path(
program_name: str,
platform_str: str = 'Linux',
ask_global: int = 0,
add_path: bool = True,
append_to_path: str = '',
) → str[source]#

Get the installation path for the program on the current platform.

Parameters:

  • program_name (str) – The name of the program to install.

  • platform_str (str) – The platform to get the installation path for.

  • ask_global (int) – Whether to ask the user for a path, 0 = ask, 1 = install globally, 2 = install locally.

  • add_path (bool) – Whether to add the program to the PATH environment variable.

  • append_to_path (str) – String to append to the installation path when adding to PATH. (ex: “bin” if executables are in the bin folder)

Returns:

The installation path for the program.

Return type:

str

add_to_path(
install_path: str,
platform_str: str = 'Linux',
) → bool[source]#

Add the program to the PATH environment variable.

Parameters:

  • install_path (str) – The path to the program to add to the PATH environment variable.

  • platform_str (str) – The platform you are running on (ex: “Windows”, “Linux”, “Darwin”, …), we use this to determine the installation path if not provided.

Returns:

True if add to PATH was successful, False otherwise.

Return type:

bool

install_program(
input_path: str,
install_path: str = '',
platform_str: str = 'Linux',
program_name: str = '',
add_path: bool = True,
append_to_path: str = '',
) → bool[source]#

Install a program to a specific path from a local zip file or URL.

Parameters:

  • input_path (str) – Path to a zip file or a download URL.

  • install_path (str) – The directory to extract the program into, we ask user for a path if not provided.

  • platform_str (str) – The platform you are running on (ex: “Windows”, “Linux”, “Darwin”, …), we use this to determine the installation path if not provided.

  • add_path (bool) – Whether to add the program to the PATH environment variable.

  • program_name (str) – Override the program name, we get it from the input path if not provided.

  • append_to_path (str) – String to append to the installation path when adding to PATH. (ex: “bin” if executables are in the bin folder)

Returns:

True if installation was successful, False otherwise.

Return type:

bool