environments-utils 1.0.11

Utilities to identify which environments is your python script running within.

Environment Utils

Utilities to identify the environment in which your Python script is running.

This includes determining whether you are in a Jupyter Notebook, within a node of a SLURM cluster, the architecture of the system you are using, and the operating system.

Installation

To install this package, use pip:

pip install environments_utils

Examples

is_tmux

Return a boolean representing if the script is running within a TMUX-like terminal.

from environments_utils import is_tmux

if not is_tmux():
    print("This script is long-running; consider starting it within a TMUX-like terminal.")

is_notebook

Return a boolean representing if the script is running within a Jupyter notebook.

from environments_utils import is_notebook
from tqdm import tqdm_notebook, tqdm as tqdm_cli

tqdm = tqdm_notebook if is_notebook() else tqdm_cli

is_slurm_node

Returns whether you are in a SLURM cluster node.

from environments_utils import (
    is_slurm_node,
    get_slurm_node_id,
    get_number_of_available_slurm_nodes
)

if is_slurm_node():
    print("YAY! I'm in node {} of {}!".format(get_slurm_node_id(), get_number_of_available_slurm_nodes()))

Operating System Identifiers

Utilities to identify the operating system running the app.

from environments_utils import is_macos, is_windows, is_linux, is_macos_with_arm

if is_macos():
    print("The OS is macOS")

if is_windows():
    print("The OS is Windows")

if is_linux():
    print("The OS is Linux")

if is_macos_with_arm():
    print("The machine is macOS with ARM processors like M1")

Architecture Identifiers

Utilities to identify the architectures running the app.

from environments_utils import is_x86, is_x86_64, is_arm

if is_x86():
    print("This is a 32-bit system with x86 architecture.")

if is_x86_64():
    print("This is a 64-bit system with x86_64 architecture.")

if is_arm():
    print("This is an ARM machine, such as Mac M1")

Internet Connection

Utility to detect whether the user is connected to the internet.

from environments_utils import is_online

if is_online():
    print("You are online.")
else:
    print("You are offline")