diskmon 0.1.0__104dbeeaa-py3-none-any.whl

diskmon/disk_monitor.py

@@ -0,0 +1,86 @@
+import shutil
+import logging
+from datetime import datetime
+
+# Thresholds for disk usage percentage
+DISK_WARN_THRESHOLD  = 80   # log a warning when disk is this full
+DISK_ABORT_THRESHOLD = 95   # log a critical error and exit when disk is this full
+
+# Path to the log file
+LOG_FILE = "/var/log/freespace.log"
+
+# Disk path to monitor
+DISK_PATH = "/"
+
+
+def get_logger() -> logging.Logger:
+    """Configure and return a logger that writes to both a file and stdout."""
+    logger = logging.getLogger("disk_monitor")
+    logger.setLevel(logging.DEBUG)
+
+    fmt = logging.Formatter(
+        fmt="%(asctime)s  [%(levelname)s]  %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+    # File handler — requires write permission to LOG_FILE
+    try:
+        fh = logging.FileHandler(LOG_FILE)
+        fh.setFormatter(fmt)
+        logger.addHandler(fh)
+    except PermissionError:
+        print(f"[WARN] No permission to write to {LOG_FILE}. Logging to stdout only.")
+
+    # Console handler — always active
+    ch = logging.StreamHandler()
+    ch.setFormatter(fmt)
+    logger.addHandler(ch)
+
+    return logger
+
+
+def check_disk_space(path: str, logger: logging.Logger) -> bool:
+    """
+    Check disk usage at the given path and log the result.
+
+    Returns True if usage is below DISK_ABORT_THRESHOLD, False otherwise.
+    """
+    usage = shutil.disk_usage(path)
+
+    used_pct = usage.used / usage.total * 100
+    free_gb  = usage.free  / (1024 ** 3)
+    total_gb = usage.total / (1024 ** 3)
+
+    # Human-readable summary included in every log record
+    summary = (
+        f"disk={path!r}  "
+        f"used={used_pct:.1f}%  "
+        f"free={free_gb:.2f}GB / {total_gb:.2f}GB"
+    )
+
+    if used_pct >= DISK_ABORT_THRESHOLD:
+        # Disk is critically full — caller should stop any heavy operation
+        logger.critical(f"Disk critically full. {summary}")
+        return False
+
+    if used_pct >= DISK_WARN_THRESHOLD:
+        # Disk is getting full — warn so the operator can act
+        logger.warning(f"Low disk space. {summary}")
+    else:
+        # Plenty of space available — routine info record
+        logger.info(f"Disk space OK. {summary}")
+
+    return True
+
+
+if __name__ == "__main__":
+    logger = get_logger()
+
+    logger.info("=" * 60)
+    logger.info(f"Disk monitor started at {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+
+    ok = check_disk_space(path=DISK_PATH, logger=logger)
+
+    if not ok:
+        # Non-zero exit code signals failure to any calling process or CI system
+        raise SystemExit(1)

diskmon-0.1.0.dist-info/METADATA

@@ -0,0 +1,4 @@
+Metadata-Version: 2.1
+Name: diskmon
+Version: 0.1.0
+Summary: Pure Python wheel

diskmon-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+diskmon/disk_monitor.py,sha256=cA4TH836Dz-sfRQRYeDIY4utm-qpdO5Rpb6Sto-MjtI,2534
+diskmon-0.1.0.dist-info/METADATA,sha256=_qgFztpZ-QUyxhy_WYjQj2mQ07k2m0TAEKkxWYQQJxs,78
+diskmon-0.1.0.dist-info/WHEEL,sha256=ecvr-UMg8NATu7SzWPtikHyoPU6iJZ_q1ow9yAlbDzQ,89
+diskmon/fs_types.so,sha256=y_qv5YCh1hjvx2Ce55Yi7SqN5v2W3vi-5ExgCtRRSck,2568
+diskmon-0.1.0.dist-info/RECORD,,

diskmon-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: pure-python-script
+Root-Is-Purelib: true
+Tag: py3-none-any