Skip to content

c2f4dt.utils.systeminfo

c2f4dt.utils.systeminfo

disk_usage_percent(path='/')

Return disk usage as (used_GB, free_GB, used_percent).

Parameters:

Name Type Description Default
path str

Filesystem path to query. Defaults to root.

 '/'

Returns:

Type Description
tuple[float, float, float]

Tuple containing used space (GB), free space (GB), and used percentage.
Source code in src/c2f4dt/utils/systeminfo.py 
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
def disk_usage_percent(path: str = "/") -> tuple[float, float, float]:
    """Return disk usage as (used_GB, free_GB, used_percent).

    Args:
        path: Filesystem path to query. Defaults to root.

    Returns:
        Tuple containing used space (GB), free space (GB), and used percentage.
    """
    total, used, free = shutil.disk_usage(path)
    to_gb = lambda b: b / (1024**3)
    percent = (used / total) * 100 if total else 0.0
    return to_gb(used), to_gb(free), percent