from datetime import datetime, timezone

def iso_stamp_filename(prefix: str, ext: str) -> str:
  """Generate timestamped filename, e.g. pasted-2025-10-23T121212Z.png"""
  ts = datetime.now(timezone.utc).isoformat()
  ts = ts.replace(":", "").split(".")[0]
  if ts.endswith("+00:00"):
    ts = ts.replace("+00:00", "Z")
  return f"{prefix}-{ts}.{ext}"

def format_size(num_bytes: int) -> str:
  """Return a human-readable file size (e.g., '2.3 MB', '10 Bytes')."""
  if num_bytes < 1024:
    return f"{num_bytes} Byte{'s' if num_bytes != 1 else ''}"

  units = ["KB", "MB", "GB", "TB", "PB", "EB"]
  size = float(num_bytes)
  for unit in units:
    size /= 1024.0
    if size < 1024.0 or unit == units[-1]:
      # 1 decimal place; drop trailing .0 (optional)
      val = f"{size:.1f}"
      if val.endswith(".0"):
        val = val[:-2]
      return f"{val} {unit}"
  return f"{num_bytes} Bytes"  # fallback

