ezKit 2.0.28__tar.gz → 2.0.30__tar.gz

{ezkit-2.0.28/ezKit.egg-info → ezkit-2.0.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ezKit
-Version: 2.0.28
+Version: 2.0.30
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com

{ezkit-2.0.28 → ezkit-2.0.30}/ezKit/bandwagon.py

@@ -2,12 +2,17 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from datetime import datetime, timedelta, timezone
+from decimal import ROUND_HALF_UP, Decimal
 from typing import Any
 
 import requests
 
 BASE_URL = "https://api.64clouds.com/v1"
 
+GB = Decimal(1024) ** 3
+
+TWO_PLACES = Decimal("0.01")
+
 
 @dataclass(slots=True)
 class BandwagonConfig:
@@ -103,3 +108,34 @@ def expiration_date(info: dict) -> str:
     # 将时间戳转为 UTC+8 时间
     date = datetime.fromtimestamp(info["data_next_reset"], tz=timezone(timedelta(hours=8))).strftime("%Y-%m-%d")
     return date
+
+
+# --------------------------------------------------------------------------------------------------
+
+
+def _to_gb(value: int | str | float) -> Decimal:
+    """字节转 GB（Decimal 精确）"""
+    return (Decimal(str(value)) / GB).quantize(TWO_PLACES, rounding=ROUND_HALF_UP)
+
+
+def bandwidth_allowance(info: dict) -> dict[str, Decimal]:
+    """
+    计算带宽配额使用情况（精确计算，保留两位小数）
+    返回值单位：GB / %
+    """
+
+    total = _to_gb(info["plan_monthly_data"])
+    used = _to_gb(info["data_counter"])
+    available = total - used
+
+    if total == 0:
+        usage_percent = Decimal("0.00")
+    else:
+        usage_percent = (used / total * 100).quantize(TWO_PLACES, rounding=ROUND_HALF_UP)
+
+    return {
+        "total": total,  # Decimal('123.45')
+        "used": used,  # Decimal('67.89')
+        "available": available,
+        "usage_percent": usage_percent,  # Decimal('54.32')
+    }

ezkit-2.0.30/ezKit/linux.py

@@ -0,0 +1,45 @@
+import shutil
+
+from . import utils
+
+
+def get_uptime_info():
+
+    try:
+        return int(utils.read_file("/proc/uptime").split()[0])
+    except Exception:
+        return 0
+
+
+def get_memory_info() -> dict:
+
+    meminfo = {}
+
+    with open("/proc/meminfo", encoding="utf-8") as f:
+
+        for line in f:
+            key, value = line.split(":", 1)
+            meminfo[key] = int(value.strip().split()[0]) * 1024  # kB -> bytes
+
+    total = meminfo.get("MemTotal", 0)
+    available = meminfo.get("MemAvailable", 0)
+    used = total - available
+
+    return {
+        "total": utils.bytes_to_gigabyte(total),
+        "used": utils.bytes_to_gigabyte(used),
+        "available": utils.bytes_to_gigabyte(available),
+        "usage_percent": round(used / total * 100, 2) if total else 0,
+    }
+
+
+def get_disk_info(path: str = "/") -> dict:
+
+    usage = shutil.disk_usage(path)
+
+    return {
+        "total": utils.bytes_to_gigabyte(usage.total),
+        "used": utils.bytes_to_gigabyte(usage.used),
+        "available": utils.bytes_to_gigabyte(usage.free),
+        "usage_percent": round(usage.used / usage.total * 100, 2),
+    }

{ezkit-2.0.28 → ezkit-2.0.30}/ezKit/utils.py

@@ -489,3 +489,24 @@ def resolve_path(
 
 
 # --------------------------------------------------------------------------------------------------
+
+
+def bytes_to_gigabyte(value: int) -> float:
+    """Convert bytes to gigabytes"""
+
+    try:
+        return round(value / 1024 / 1024 / 1024, 2)
+    except Exception:
+        return 0
+
+
+# --------------------------------------------------------------------------------------------------
+
+
+def read_file(path: str) -> str:
+    """Read file"""
+
+    try:
+        return Path(path).read_text(encoding="utf-8").strip()
+    except Exception:
+        return ""

{ezkit-2.0.28 → ezkit-2.0.30/ezKit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ezKit
-Version: 2.0.28
+Version: 2.0.30
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com

{ezkit-2.0.28 → ezkit-2.0.30}/ezKit.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ ezKit/database.py
 ezKit/errorcode.py
 ezKit/fastapix.py
 ezKit/http.py
+ezKit/linux.py
 ezKit/redix.py
 ezKit/sendemail.py
 ezKit/stock.py

{ezkit-2.0.28 → ezkit-2.0.30}/setup.py

@@ -4,7 +4,7 @@ from setuptools import find_packages, setup
 
 setup(
     name="ezKit",
-    version="2.0.28",
+    version="2.0.30",
     author="septvean",
     author_email="septvean@gmail.com",
     description="Easy Kit",