PRIVATE_STUFF/7Z_Python_Script
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v3

Browse Source
This commit is contained in:
jpmvaz
2026-09-13 19:48:16 +01:00
commit 3e287bda1a
7 changed files with 2375 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+314
View File
@@ -0,0 +1,314 @@
# 📦 Folder Compressor
A command-line Python script that lets you pick any sub-folder to compress, or compress **all folders in one go** — each one individually with its own live progress bar. Uses **7-Zip store mode** (no compression) for maximum speed and zero CPU overhead.
---
## Features
- Browse all sub-folders with their sizes before choosing
- **Two modes at runtime:**
- **Single folder** — select one folder by number
- **Compress all** — process every folder sequentially, one by one
- Real-time progress bar per job showing:
- Percentage complete
- Elapsed time
- Live transfer speed (MB/s)
- File count
- Currently processing file name
- Pause between jobs in batch mode so you can read each result before continuing
- Batch summary table at the end showing all jobs, sizes, times, and speeds
- Color-coded terminal output (auto-disabled if not supported)
- Cross-platform: Windows, macOS, Linux
---
## Requirements
### Python
Version **3.10 or higher** is required (uses `str | None` union type syntax).
Check your version:
```bash
python --version
# or
python3 --version
```
No third-party packages are needed — only Python's standard library is used.
### 7-Zip
7-Zip must be installed and accessible on your system PATH.
| Platform | Install command |
|----------|----------------|
| **Linux** (Debian/Ubuntu) | `sudo apt install p7zip-full` |
| **Linux** (Fedora/RHEL) | `sudo dnf install p7zip p7zip-plugins` |
| **macOS** (Homebrew) | `brew install p7zip` |
| **macOS** (MacPorts) | `sudo port install p7zip` |
| **Windows** | Download installer from [https://www.7-zip.org/download.html](https://www.7-zip.org/download.html) |
> **Windows note:** After installing, make sure `C:\Program Files\7-Zip\` is added to your system PATH, or the script will auto-detect it from the default install location automatically.
> **Minimum version:** 7-Zip **15.06 or newer** is required for the `-bsp1` progress flag used for real-time output. Most current installs will meet this requirement.
Verify 7-Zip is available:
```bash
7z i
```
---
## Installation
No installation needed. Just download the script:
```bash
# Download compress_folder.py to any directory, then run it directly with Python
```
Optionally make it executable on Linux/macOS:
```bash
chmod +x compress_folder.py
```
---
## Usage
### Basic — scan the current directory
```bash
python compress_folder.py
```
### Specify a directory to scan
```bash
python compress_folder.py /path/to/directory
```
### On Linux/macOS (if made executable)
```bash
./compress_folder.py
./compress_folder.py /path/to/directory
```
### On Windows
```bash
python compress_folder.py
python compress_folder.py C:\Users\YourName\Documents
```
---
## Step-by-step walkthrough
### Step 1 — Launch the script
```
📦 Folder Compressor
Scanning: /home/user/projects
```
### Step 2 — Browse folders and choose a mode
All sub-folders are listed with their sizes, followed by the option to compress all:
```
Available folders:
[ 1] archive (240.0 MB)
[ 2] builds (1.4 GB)
[ 3] logs (88.3 MB)
[ 4] source (320.5 MB)
[ A] Compress ALL folders one by one
Enter a folder number or A to compress all:
```
**To compress a single folder:** type its number and press Enter.
**To compress all folders:** type `A` and press Enter.
---
### Single folder mode
```
Enter a folder number or A to compress all: 2
✔ Mode: Single folder → builds
Calculating source size… 1.4 GB
────────────────────────────────────────────────────────────────
████████████████░░░░░░░░░░░░░░░░░░░ 62% elapsed 0m 08s 178.4 MB/s files: 312
↳ builds/release/v2.1.0/installer.exe
────────────────────────────────────────────────────────────────
✅ Archive created successfully!
Path : /home/user/projects/builds.7z
Source : 1.4 GB
Archive : 1.4 GB
Time : 0m 09s
Avg speed: 159.2 MB/s
```
---
### Compress all mode
Each folder gets a numbered job header and its own progress bar. Each folder gets a numbered job header and its own progress bar. As soon as one job finishes and displays its stats, the next one starts automatically:
```
Enter a folder number or A to compress all: A
✔ Mode: Compress all folders sequentially
[1/4] archive ────────────────────────────────────────────
Calculating source size… 240.0 MB
...
✅ Archive created successfully! (240.0 MB · 1s · 240.0 MB/s)
[2/4] builds ─────────────────────────────────────────────
...
```
After all jobs complete, a **batch summary** is printed:
```
══════════════════════════════════════════════════════════════════
BATCH SUMMARY — 4 folder(s) processed
══════════════════════════════════════════════════════════════════
✅ archive 240.0 MB → 1s @ 240.0 MB/s
✅ builds 1.4 GB → 9s @ 159.2 MB/s
✅ logs 88.3 MB → 0s @ 310.5 MB/s
✅ source 320.5 MB → 2s @ 192.1 MB/s
──────────────────────────────────────────────────────────────────
Total source size : 2.0 GB
Total archive size: 2.0 GB
Total time : 12s
Overall avg speed : 170.4 MB/s
══════════════════════════════════════════════════════════════════
```
If any jobs fail, they are flagged in the summary with their error code.
---
## Progress bar reference
| Element | Description |
|---------|-------------|
| `████░░░` | Progress bar filling left to right |
| `62%` | Percentage of data processed |
| `elapsed 0m 08s` | Time since this job started |
| `178.4 MB/s` | Rolling average throughput speed |
| `files: 312` | Number of files added so far |
| `↳ filename` | The file currently being processed |
---
## Compression settings
The script uses the following 7-Zip flags:
| Flag | Value | Meaning |
|------|-------|---------|
| `-t7z` | — | Output format: 7z |
| `-mx=0` | 0 | Compression level 0 = **store** (no compression) |
| `-ms=off` | off | Solid archive **disabled** (faster for many files) |
| `-bsp1` | — | Stream progress output to stdout (enables live display) |
**Why no compression?**
Store mode (`-mx=0`) copies files into the archive as-is without compressing them. This is ideal when:
- Speed matters more than file size reduction
- The contents are already compressed (videos, images, zip files, etc.)
- You want to bundle files for transfer without the CPU cost of compression
---
## How the real-time progress works
7-Zip does not write progress on separate lines — instead it continuously overwrites the same terminal line using special control characters. The exact character it uses depends on the platform:
| Platform | Character used | Code |
|----------|---------------|------|
| Linux / macOS | Backspace | `\x08` |
| Windows | Carriage return | `\r` |
The script reads 7-Zip's output as a raw binary stream and splits on **both** characters, so progress is captured correctly on every platform. The percentage, file count, and current filename are extracted from each segment using a regex and rendered live into two reserved terminal lines that update in place.
---
## Output location
Each archive is created in the **same directory that contains the source folder**.
Example:
```
/home/user/projects/ ← scanned directory
archive/ ← source folder
archive.7z ← archive created here
builds/
builds.7z
```
If an archive with the same name already exists, 7-Zip will update it (adding/replacing files). Delete the existing `.7z` first if you want a clean archive.
---
## Interrupting a batch
Press `Ctrl+C` at any point during a batch to stop early. Any jobs already completed will have their archives saved. A partial batch summary will be printed for the jobs that ran.
---
## Troubleshooting
**`7-Zip not found` error**
- Ensure 7-Zip is installed (see Requirements above)
- Confirm `7z` is on your PATH: run `which 7z` (Linux/macOS) or `where 7z` (Windows)
- On Windows, try re-installing 7-Zip and ticking the "Add to PATH" option, or place `7z.exe` in `C:\Program Files\7-Zip\` which the script checks automatically
**Progress bar stays at 0% / no stats shown**
- Make sure you are using the latest version of the script
- The root cause of this bug was that Windows 7-Zip uses `\r` to update progress lines while Linux/macOS uses `\x08` (backspace). The current version handles both
- If you still see 0% after updating, confirm your 7-Zip version is 15.06 or newer: run `7z i` and check the version line at the top
**No progress bar / garbled output**
- The live progress display requires a terminal that supports ANSI escape codes
- On older Windows CMD, switch to Windows Terminal or PowerShell
- Progress and stats are still printed even if color/ANSI is not supported
**`SyntaxError` on startup**
- Your Python version is below 3.10 — upgrade to Python 3.10+
**Permission denied on folder**
- Run the script with elevated permissions (`sudo` on Linux/macOS, Run as Administrator on Windows)
- Or select a folder you have read access to
---
## Examples
```bash
# Compress a single folder or all folders in the current directory
python compress_folder.py
# Compress a single folder or all folders inside a specific path
python compress_folder.py /mnt/data/backups
# Windows example
python compress_folder.py "C:\Users\Alice\Desktop"
```
---
## License
This script is provided as-is for personal and commercial use. No warranty is expressed or implied.
compress_folder.py
+427
View File
@@ -0,0 +1,427 @@
#!/usr/bin/env python3
"""
Folder Compressor using 7-Zip
- Select a single folder to compress, OR
- Compress all folders one by one automatically
Uses 7-Zip store mode (no compression) for maximum speed.
Real-time progress bar shown during each compression job.
"""
import os
import re
import sys
import shutil
import subprocess
import time
from pathlib import Path
from dataclasses import dataclass
# ── Terminal color helpers ────────────────────────────────────────────────────
SUPPORTS_COLOR = (
sys.stdout.isatty()
and (sys.platform != "win32" or os.environ.get("WT_SESSION") or os.environ.get("TERM"))
)
def _c(code: str, text: str) -> str:
return f"\033[{code}m{text}\033[0m" if SUPPORTS_COLOR else text
def green(t): return _c("32", t)
def yellow(t): return _c("33", t)
def cyan(t): return _c("36", t)
def bold(t): return _c("1", t)
def dim(t): return _c("2", t)
def red(t): return _c("31", t)
def magenta(t): return _c("35", t)
# ── Size / time formatters ────────────────────────────────────────────────────
def fmt_size(b: float) -> str:
for unit in ("B", "KB", "MB", "GB", "TB"):
if b < 1024:
return f"{b:.1f} {unit}"
b /= 1024
return f"{b:.1f} PB"
def fmt_time(seconds: float) -> str:
s = int(seconds)
if s < 60:
return f"{s}s"
m, s = divmod(s, 60)
if m < 60:
return f"{m}m {s:02d}s"
h, m = divmod(m, 60)
return f"{h}h {m:02d}m {s:02d}s"
# ── Folder size calculator ────────────────────────────────────────────────────
def folder_size(path: Path) -> int:
total = 0
for root, _, files in os.walk(path):
for f in files:
try:
total += os.path.getsize(os.path.join(root, f))
except OSError:
pass
return total
# ── 7-Zip locator ─────────────────────────────────────────────────────────────
def find_7zip() -> str | None:
for name in ("7z", "7za", "7zz", "7zip"):
path = shutil.which(name)
if path:
return path
if sys.platform == "win32":
for p in (
r"C:\Program Files\7-Zip\7z.exe",
r"C:\Program Files (x86)\7-Zip\7z.exe",
):
if os.path.isfile(p):
return p
return None
# ── Folder listing ────────────────────────────────────────────────────────────
def list_folders(base_dir: str) -> list[Path]:
base = Path(base_dir)
return sorted(
(e for e in base.iterdir() if e.is_dir()),
key=lambda p: p.name.lower(),
)
# ── Mode + folder selection menu ─────────────────────────────────────────────
def prompt_mode_and_selection(folders: list[Path]) -> list[Path]:
"""
Print the folder list then ask the user what to do:
A — compress ALL folders sequentially
1…N — compress a single specific folder
Returns the list of folders to compress (one or all).
"""
print("\nAvailable folders:\n")
for i, folder in enumerate(folders, start=1):
try:
sz = folder_size(folder)
size_label = dim(f" ({fmt_size(sz)})")
except PermissionError:
size_label = dim(" (no access)")
print(f" {dim(f'[{i:>3}]')} {folder.name}{size_label}")
print()
print(f" {dim('[ A]')} {bold('Compress ALL folders one by one')}")
print()
while True:
try:
raw = input("Enter a folder number or A to compress all: ").strip().upper()
if raw == "A":
print(f"\n {green('✔')} Mode: {bold('Compress all folders sequentially')}")
return list(folders)
idx = int(raw)
if 1 <= idx <= len(folders):
chosen = folders[idx - 1]
print(f"\n {green('✔')} Mode: {bold('Single folder')} → {chosen.name}")
return [chosen]
print(f" Please enter a number between 1 and {len(folders)}, or A.")
except ValueError:
print(" Invalid input — enter a number or A.")
except (EOFError, KeyboardInterrupt):
print("\nAborted.")
sys.exit(0)
# ── Progress bar renderer ─────────────────────────────────────────────────────
BAR_WIDTH = 36
_PROGRESS_RE = re.compile(r"(\d{1,3})%(?:\s+(\d+)\s*\+?\s*(.*))?")
# Split on backspaces (\x08, Linux/macOS) or carriage returns (\r, Windows)
_SPLIT_RE = re.compile(rb"[\x08\r]+")
def _move_up(n: int):
if SUPPORTS_COLOR:
sys.stdout.write(f"\033[{n}A")
def _clear_line():
if SUPPORTS_COLOR:
sys.stdout.write("\033[2K\r")
else:
sys.stdout.write("\r" + " " * 78 + "\r")
def _redraw(pct: int, elapsed: float, files_done: int,
current_file: str, speed_bps: float):
filled = int(BAR_WIDTH * pct / 100)
bar = "█" * filled + "░" * (BAR_WIDTH - filled)
color = green if pct == 100 else cyan
speed_s = f"{fmt_size(speed_bps)}/s" if speed_bps > 0 else "─"
_move_up(2)
_clear_line()
sys.stdout.write(
f" {color(bar)} {bold(f'{pct:>3}%')}"
f" {dim('elapsed')} {dim(fmt_time(elapsed))}"
f" {yellow(speed_s)}"
f" {dim(f'files: {files_done}')}\n"
)
_clear_line()
label = current_file.strip() or "starting…"
if len(label) > 60:
label = "…" + label[-59:]
sys.stdout.write(f" {dim('↳ ' + label)}\n")
sys.stdout.flush()
# ── Result record ─────────────────────────────────────────────────────────────
@dataclass
class JobResult:
folder: Path
archive: Path | None
src_size: int
arc_size: int
elapsed: float
avg_speed: float
success: bool
error: str = ""
# ── Single compression job ────────────────────────────────────────────────────
def compress_folder(seven_zip: str, folder: Path, output_dir: Path,
job_label: str = "") -> JobResult:
archive_path = output_dir / (folder.name + ".7z")
if job_label:
print(f"\n{job_label}")
print(f"\n {dim('Calculating source size…')} ", end="", flush=True)
src_size = folder_size(folder)
print(fmt_size(src_size))
cmd = [
seven_zip,
"a",
"-t7z",
"-mx=0",
"-ms=off",
"-bsp1",
str(archive_path),
str(folder),
]
print(f"\n {dim('Command: ' + ' '.join(cmd))}")
print()
print(" " + "─" * 64)
print()
print()
start_time = time.monotonic()
files_done = 0
current_file = ""
speed_bps = 0.0
last_bytes = 0.0
speed_ts = start_time
proc = subprocess.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
)
buf = b""
while True:
chunk = proc.stdout.read(256)
if not chunk:
break
buf += chunk
elapsed = time.monotonic() - start_time
segments = _SPLIT_RE.split(buf)
buf = segments[-1]
for seg in segments[:-1]:
text = seg.decode("utf-8", errors="replace").strip()
if not text:
continue
m = _PROGRESS_RE.search(text)
if m:
pct = min(int(m.group(1)), 100)
files_done = int(m.group(2)) if m.group(2) else files_done
fname = (m.group(3) or "").strip()
if fname:
current_file = fname
if src_size > 0 and pct > 0:
bytes_done = src_size * pct / 100
now = time.monotonic()
dt = now - speed_ts
if dt >= 0.4:
speed_bps = (bytes_done - last_bytes) / dt
last_bytes = bytes_done
speed_ts = now
_redraw(pct, elapsed, files_done, current_file, speed_bps)
proc.wait()
elapsed_total = time.monotonic() - start_time
if proc.returncode == 0:
_redraw(100, elapsed_total, files_done, current_file, speed_bps)
print()
print(" " + "─" * 64)
if proc.returncode == 0:
arc_size = archive_path.stat().st_size
avg_speed = src_size / elapsed_total if elapsed_total > 0 else 0
print(f"\n {green('✅ Archive created successfully!')}")
print(f" {bold('Path')} : {archive_path}")
print(f" {bold('Source')} : {fmt_size(src_size)}")
print(f" {bold('Archive')} : {fmt_size(arc_size)}")
print(f" {bold('Time')} : {fmt_time(elapsed_total)}")
print(f" {bold('Avg speed')}: {fmt_size(avg_speed)}/s")
return JobResult(
folder=folder, archive=archive_path,
src_size=src_size, arc_size=arc_size,
elapsed=elapsed_total, avg_speed=avg_speed,
success=True,
)
else:
msg = f"7-Zip exited with code {proc.returncode}"
print(f"\n {red(f'❌ {msg}')}")
return JobResult(
folder=folder, archive=None,
src_size=src_size, arc_size=0,
elapsed=elapsed_total, avg_speed=0,
success=False, error=msg,
)
# ── Batch summary ─────────────────────────────────────────────────────────────
def print_batch_summary(results: list[JobResult]):
succeeded = [r for r in results if r.success]
failed = [r for r in results if not r.success]
total_src = sum(r.src_size for r in results)
total_arc = sum(r.arc_size for r in results)
total_t = sum(r.elapsed for r in results)
width = 66
print()
print(" " + "═" * width)
print(f" {bold('BATCH SUMMARY')} — {len(results)} folder(s) processed")
print(" " + "═" * width)
for r in results:
icon = green("✅") if r.success else red("❌")
label = r.folder.name
if len(label) > 38:
label = label[:35] + "…"
if r.success:
detail = f"{fmt_size(r.src_size)} → {fmt_time(r.elapsed)} @ {fmt_size(r.avg_speed)}/s"
else:
detail = red(r.error)
print(f" {icon} {label:<38} {dim(detail)}")
print(" " + "─" * width)
print(f" {bold('Total source size')} : {fmt_size(total_src)}")
print(f" {bold('Total archive size')}: {fmt_size(total_arc)}")
print(f" {bold('Total time')} : {fmt_time(total_t)}")
if total_t > 0:
avg = total_src / total_t
print(f" {bold('Overall avg speed')} : {fmt_size(avg)}/s")
if failed:
print()
print(f" {red(f'⚠ {len(failed)} job(s) failed:')}")
for r in failed:
print(f" • {r.folder.name} — {r.error}")
print(" " + "═" * width)
print()
# ── Entry point ───────────────────────────────────────────────────────────────
def main():
scan_dir = os.path.abspath(sys.argv[1] if len(sys.argv) > 1 else os.getcwd())
if not os.path.isdir(scan_dir):
print(f"Error: '{scan_dir}' is not a valid directory.")
sys.exit(1)
print(f"\n{bold('📦 Folder Compressor')}")
print(f" Scanning: {cyan(scan_dir)}\n")
seven_zip = find_7zip()
if not seven_zip:
print(
f"\n{red('❌ 7-Zip not found.')}\n"
" Install it and make sure '7z' (or '7za') is on your PATH.\n"
" • Linux : sudo apt install p7zip-full\n"
" • macOS : brew install p7zip\n"
" • Windows: https://www.7-zip.org/download.html"
)
sys.exit(1)
print(f" {green('✔')} 7-Zip: {dim(seven_zip)}")
folders = list_folders(scan_dir)
if not folders:
print(f"\nNo sub-folders found in '{scan_dir}'.")
sys.exit(0)
targets = prompt_mode_and_selection(folders)
batch = len(targets) > 1
results: list[JobResult] = []
for i, folder in enumerate(targets, start=1):
label = ""
if batch:
label = (
f"\n {magenta(f'[{i}/{len(targets)}]')} "
f"{bold(folder.name)}"
f" {dim('─' * max(0, 44 - len(folder.name)))}"
)
result = compress_folder(seven_zip, folder, folder.parent, job_label=label)
results.append(result)
# In batch mode, allow Ctrl+C between jobs to abort remaining work
if batch and i < len(targets):
try:
time.sleep(0) # yield to allow KeyboardInterrupt to surface
except KeyboardInterrupt:
print(f"\n {yellow('⚠ Batch interrupted by user.')}")
break
if batch:
print_batch_summary(results)
else:
print()
if __name__ == "__main__":
main()
install_dependencies.py
+308
View File
@@ -0,0 +1,308 @@
#!/usr/bin/env python3
"""
install_dependencies.py
Installs all requirements for compress_folder.py:
- Checks the Python version (3.10+)
- Detects the OS and installs 7-Zip via the appropriate method
- Verifies the installation when done
"""
import os
import sys
import shutil
import subprocess
import platform
# ── Terminal colors (no third-party deps needed here either) ─────────────────
IS_TTY = sys.stdout.isatty()
def _c(code, text):
return f"\033[{code}m{text}\033[0m" if IS_TTY else text
def green(t): return _c("32", t)
def yellow(t): return _c("33", t)
def cyan(t): return _c("36", t)
def bold(t): return _c("1", t)
def dim(t): return _c("2", t)
def red(t): return _c("31", t)
# ── Helpers ───────────────────────────────────────────────────────────────────
def header(text):
print(f"\n{bold('── ' + text + ' ' + '─' * max(0, 54 - len(text)))}")
def ok(text): print(f" {green('✔')} {text}")
def info(text): print(f" {cyan('ℹ')} {text}")
def warn(text): print(f" {yellow('⚠')} {text}")
def fail(text): print(f" {red('✘')} {text}")
def run(cmd, check=True, capture=False):
"""Run a shell command, print it first, and return the CompletedProcess."""
print(f"\n {dim('$')} {dim(' '.join(cmd))}")
return subprocess.run(
cmd,
check=check,
capture_output=capture,
text=True,
)
# ── Step 1: Python version ────────────────────────────────────────────────────
def check_python():
header("Checking Python version")
major, minor = sys.version_info[:2]
ver = f"{major}.{minor}.{sys.version_info.micro}"
if (major, minor) >= (3, 10):
ok(f"Python {ver} — requirement satisfied (3.10+)")
return True
else:
fail(f"Python {ver} is too old. compress_folder.py requires Python 3.10 or higher.")
info("Download the latest Python from https://www.python.org/downloads/")
return False
# ── Step 2: Detect OS and pick install strategy ───────────────────────────────
def detect_os() -> dict:
"""Return a dict describing the OS and the best install method."""
system = platform.system()
if system == "Windows":
return {"os": "windows"}
if system == "Darwin":
brew = shutil.which("brew")
port = shutil.which("port")
method = "homebrew" if brew else ("macports" if port else "manual")
return {"os": "macos", "method": method, "brew": brew, "port": port}
if system == "Linux":
# Identify distro family
for mgr, cmd in (
("apt", ["apt", "--version"]),
("dnf", ["dnf", "--version"]),
("yum", ["yum", "--version"]),
("pacman", ["pacman", "--version"]),
("zypper", ["zypper", "--version"]),
):
if shutil.which(mgr):
return {"os": "linux", "manager": mgr}
return {"os": "linux", "manager": None}
return {"os": "unknown"}
# ── Step 3: Install 7-Zip ─────────────────────────────────────────────────────
def already_installed() -> str | None:
"""Return the path to 7-Zip if it is already on PATH."""
for name in ("7z", "7za", "7zz"):
path = shutil.which(name)
if path:
return path
if sys.platform == "win32":
for p in (
r"C:\Program Files\7-Zip\7z.exe",
r"C:\Program Files (x86)\7-Zip\7z.exe",
):
if os.path.isfile(p):
return p
return None
def get_7zip_version(path: str) -> str:
"""Return the version string reported by 7-Zip."""
try:
result = subprocess.run(
[path, "i"], capture_output=True, text=True, check=False
)
for line in (result.stdout + result.stderr).splitlines():
if "7-Zip" in line:
return line.strip()
except Exception:
pass
return "(version unknown)"
def install_linux(manager: str) -> bool:
install_cmds = {
"apt": ["sudo", "apt", "install", "-y", "p7zip-full"],
"dnf": ["sudo", "dnf", "install", "-y", "p7zip", "p7zip-plugins"],
"yum": ["sudo", "yum", "install", "-y", "p7zip", "p7zip-plugins"],
"pacman": ["sudo", "pacman", "-S", "--noconfirm", "p7zip"],
"zypper": ["sudo", "zypper", "install", "-y", "p7zip"],
}
cmd = install_cmds.get(manager)
if not cmd:
return False
try:
run(cmd)
return True
except subprocess.CalledProcessError:
return False
def install_macos(method: str, brew: str | None, port: str | None) -> bool:
if method == "homebrew":
try:
run([brew, "install", "p7zip"])
return True
except subprocess.CalledProcessError:
return False
if method == "macports":
try:
run(["sudo", port, "install", "p7zip"])
return True
except subprocess.CalledProcessError:
return False
return False
def install_windows() -> bool:
"""Try winget first, then chocolatey, then fall back to manual."""
if shutil.which("winget"):
try:
run(["winget", "install", "--id", "7zip.7zip", "-e", "--silent"])
return True
except subprocess.CalledProcessError:
pass
if shutil.which("choco"):
try:
run(["choco", "install", "7zip", "-y"])
return True
except subprocess.CalledProcessError:
pass
return False
def install_7zip(os_info: dict) -> bool:
header("Installing 7-Zip")
# Already present?
path = already_installed()
if path:
ver = get_7zip_version(path)
ok(f"7-Zip is already installed: {dim(path)}")
ok(f"{dim(ver)}")
return True
system = os_info["os"]
if system == "linux":
manager = os_info.get("manager")
if not manager:
fail("No supported package manager found (apt / dnf / yum / pacman / zypper).")
info("Install 7-Zip manually: https://www.7-zip.org/download.html")
return False
info(f"Using package manager: {bold(manager)}")
success = install_linux(manager)
elif system == "macos":
method = os_info.get("method", "manual")
if method == "manual":
fail("Neither Homebrew nor MacPorts was found.")
info("Install Homebrew first: https://brew.sh")
info("Then re-run this script, or install p7zip manually.")
return False
info(f"Using: {bold(method)}")
success = install_macos(method, os_info.get("brew"), os_info.get("port"))
elif system == "windows":
info("Trying winget → chocolatey …")
success = install_windows()
if not success:
fail("Automatic install failed.")
info("Download 7-Zip manually from: https://www.7-zip.org/download.html")
info("After installing, re-run this script to verify.")
return False
else:
fail(f"Unsupported OS: {platform.system()}")
info("Install 7-Zip manually: https://www.7-zip.org/download.html")
return False
if not success:
fail("Installation command failed. Check the output above for details.")
return False
return True
# ── Step 4: Verify everything ─────────────────────────────────────────────────
def verify():
header("Verifying installation")
path = already_installed()
if path:
ver = get_7zip_version(path)
ok(f"7-Zip found: {dim(path)}")
ok(f"{dim(ver)}")
return True
else:
fail("7-Zip still not found on PATH after installation.")
warn("You may need to restart your terminal or add 7-Zip to your PATH manually.")
if sys.platform == "win32":
info("Typical Windows location: C:\\Program Files\\7-Zip\\")
info("Add that directory to your PATH environment variable.")
return False
# ── Main ──────────────────────────────────────────────────────────────────────
def main():
print(f"\n{bold('🔧 compress_folder.py — Dependency Installer')}")
print(f" Platform: {cyan(platform.system())} {platform.release()} | "
f"Python {sys.version.split()[0]}")
all_ok = True
# 1. Python check
if not check_python():
all_ok = False
# 2. Detect OS
header("Detecting operating system")
os_info = detect_os()
system = os_info["os"]
if system == "linux":
mgr = os_info.get("manager", "unknown")
ok(f"Linux detected — package manager: {bold(mgr)}")
elif system == "macos":
method = os_info.get("method", "manual")
ok(f"macOS detected — install method: {bold(method)}")
elif system == "windows":
ok("Windows detected")
else:
warn(f"Unrecognised OS: {platform.system()}")
# 3. Install 7-Zip
if not install_7zip(os_info):
all_ok = False
# 4. Verify
verified = verify()
if not verified:
all_ok = False
# 5. Final report
header("Summary")
if all_ok and verified:
print(f"\n {green('✅ All dependencies satisfied.')}")
print(f" You are ready to run: {bold('python compress_folder.py')}\n")
else:
print(f"\n {yellow('⚠ One or more steps did not complete successfully.')}")
print( " Review the output above and resolve any issues before running")
print(f" {bold('compress_folder.py')}.\n")
sys.exit(1)
if __name__ == "__main__":
main()
old_01/README.md
+253
View File
@@ -0,0 +1,253 @@
# 📦 Folder Compressor
A command-line Python script that lets you pick any sub-folder and compress it into a `.7z` archive using **7-Zip** with **no compression (store mode)** — maximum speed, zero CPU overhead.
---
## Features
- Browse and select from all sub-folders in any directory
- Displays folder sizes before you choose
- Real-time progress bar with:
- Percentage complete
- Elapsed time
- Live transfer speed (MB/s)
- File count
- Currently processing file name
- Summary report on completion (source size, archive size, time, avg speed)
- Color-coded terminal output (auto-disabled if not supported)
- Cross-platform: Windows, macOS, Linux
---
## Requirements
### Python
Version **3.10 or higher** is required (uses `str | None` union type syntax).
Check your version:
```bash
python --version
# or
python3 --version
```
No third-party packages are needed — only Python's standard library is used.
### 7-Zip
7-Zip must be installed and accessible on your system PATH.
| Platform | Install command |
|----------|----------------|
| **Linux** (Debian/Ubuntu) | `sudo apt install p7zip-full` |
| **Linux** (Fedora/RHEL) | `sudo dnf install p7zip p7zip-plugins` |
| **macOS** (Homebrew) | `brew install p7zip` |
| **macOS** (MacPorts) | `sudo port install p7zip` |
| **Windows** | Download installer from [https://www.7-zip.org/download.html](https://www.7-zip.org/download.html) |
> **Windows note:** After installing, make sure `C:\Program Files\7-Zip\` is added to your system PATH, or the script will auto-detect it from the default install location automatically.
> **Minimum version:** 7-Zip **15.06 or newer** is required for the `-bsp1` progress flag used for real-time output. Most current installs will meet this requirement.
Verify 7-Zip is available:
```bash
7z i
```
---
## Installation
No installation needed. Just download the script:
```bash
# Download compress_folder.py to any directory, then run it directly with Python
```
Optionally make it executable on Linux/macOS:
```bash
chmod +x compress_folder.py
```
---
## Usage
### Basic — scan the current directory
```bash
python compress_folder.py
```
### Specify a directory to scan
```bash
python compress_folder.py /path/to/directory
```
### On Linux/macOS (if made executable)
```bash
./compress_folder.py
./compress_folder.py /path/to/directory
```
### On Windows
```bash
python compress_folder.py
python compress_folder.py C:\Users\YourName\Documents
```
---
## Step-by-step walkthrough
**1. Launch the script**
```
📦 Folder Compressor
Scanning: /home/user/projects
```
**2. Browse the folder list**
All sub-folders are listed with their sizes:
```
Available folders:
[ 1] archive (240.0 MB)
[ 2] builds (1.4 GB)
[ 3] logs (88.3 MB)
[ 4] source (320.5 MB)
Enter the number of the folder to compress:
```
**3. Select a folder**
Type the number and press Enter:
```
Enter the number of the folder to compress: 2
✔ Selected: builds
Calculating source size… 1.4 GB
```
**4. Watch real-time progress**
The progress display updates live in your terminal:
```
████████████████░░░░░░░░░░░░░░░░░░░ 62% elapsed 0m 08s 178.4 MB/s files: 312
↳ builds/release/v2.1.0/installer.exe
```
| Element | Description |
|---------|-------------|
| `████░░░` | Progress bar filling left to right |
| `62%` | Percentage of files processed |
| `elapsed 0m 08s` | Time since compression started |
| `178.4 MB/s` | Rolling average throughput speed |
| `files: 312` | Number of files added so far |
| `↳ filename` | The file currently being processed |
**5. Completion summary**
```
✅ Archive created successfully!
Path : /home/user/projects/builds.7z
Source : 1.4 GB
Archive : 1.4 GB
Time : 0m 09s
Avg speed: 159.2 MB/s
```
The `.7z` archive is saved in the **same parent directory** as the folder you selected.
---
## Compression settings
The script uses the following 7-Zip flags:
| Flag | Value | Meaning |
|------|-------|---------|
| `-t7z` | — | Output format: 7z |
| `-mx=0` | 0 | Compression level 0 = **store** (no compression) |
| `-ms=off` | off | Solid archive **disabled** (faster for many files) |
| `-bsp1` | — | Stream progress output to stdout (enables live display) |
**Why no compression?**
Store mode (`-mx=0`) copies files into the archive as-is without compressing them. This is ideal when:
- Speed matters more than file size reduction
- The contents are already compressed (videos, images, zip files, etc.)
- You want to bundle files for transfer without the CPU cost of compression
---
## How the real-time progress works
7-Zip does not write progress on separate lines — instead it continuously overwrites the same terminal line using special control characters. The exact character it uses depends on the platform:
| Platform | Character used | Code |
|----------|---------------|------|
| Linux / macOS | Backspace | `\x08` |
| Windows | Carriage return | `\r` |
The script reads 7-Zip's output as a raw binary stream and splits on **both** characters, so progress is captured correctly on every platform. The percentage, file count, and current filename are extracted from each segment using a regex and rendered live into two reserved terminal lines that update in place.
---
## Output location
The archive is always created in the **same directory that contains the selected folder**.
Example:
```
/home/user/projects/ ← scanned directory
builds/ ← selected folder
builds.7z ← archive created here
```
If an archive with the same name already exists, 7-Zip will update it (adding/replacing files). Delete the existing `.7z` first if you want a clean archive.
---
## Troubleshooting
**`7-Zip not found` error**
- Ensure 7-Zip is installed (see Requirements above)
- Confirm `7z` is on your PATH: run `which 7z` (Linux/macOS) or `where 7z` (Windows)
- On Windows, try re-installing 7-Zip and ticking the "Add to PATH" option, or place `7z.exe` in `C:\Program Files\7-Zip\` which the script checks automatically
**Progress bar stays at 0% / no stats shown**
- This was a known bug that has been fixed. Make sure you are using the latest version of the script.
- The root cause was that Windows 7-Zip uses `\r` to update progress lines while Linux/macOS uses `\x08` (backspace). The old version only handled backspaces, so on Windows the progress stream was never parsed. The current version handles both.
- If you still see 0% after updating, confirm your 7-Zip version is 15.06 or newer: run `7z i` and check the version line at the top.
**No progress bar / garbled output**
- The live progress display requires a terminal that supports ANSI escape codes
- On older Windows CMD, switch to Windows Terminal or PowerShell
- Progress and stats are still printed even if color/ANSI is not supported
**`SyntaxError` on startup**
- Your Python version is below 3.10 — upgrade to Python 3.10+
**Permission denied on folder**
- Run the script with elevated permissions (`sudo` on Linux/macOS, Run as Administrator on Windows)
- Or select a folder you have read access to
---
## Examples
```bash
# Compress a folder in the current directory (interactive)
python compress_folder.py
# Compress a folder inside a specific path
python compress_folder.py /mnt/data/backups
# Windows example
python compress_folder.py "C:\Users\Alice\Desktop"
```
---
## License
This script is provided as-is for personal and commercial use. No warranty is expressed or implied.
old_01/compress_folder.py
+329
View File
@@ -0,0 +1,329 @@
#!/usr/bin/env python3
"""
Folder Compressor using 7-Zip
Lists available folders, lets you select one, and compresses it
using 7-Zip with no compression (store) at fastest speed.
Real-time progress bar shown during compression.
"""
import os
import re
import sys
import shutil
import subprocess
import time
from pathlib import Path
# ── Terminal color helpers ────────────────────────────────────────────────────
SUPPORTS_COLOR = (
sys.stdout.isatty()
and (sys.platform != "win32" or os.environ.get("WT_SESSION") or os.environ.get("TERM"))
)
def _c(code: str, text: str) -> str:
return f"\033[{code}m{text}\033[0m" if SUPPORTS_COLOR else text
def green(t): return _c("32", t)
def yellow(t): return _c("33", t)
def cyan(t): return _c("36", t)
def bold(t): return _c("1", t)
def dim(t): return _c("2", t)
def red(t): return _c("31", t)
# ── Size / time formatters ────────────────────────────────────────────────────
def fmt_size(b: float) -> str:
for unit in ("B", "KB", "MB", "GB", "TB"):
if b < 1024:
return f"{b:.1f} {unit}"
b /= 1024
return f"{b:.1f} PB"
def fmt_time(seconds: float) -> str:
s = int(seconds)
if s < 60:
return f"{s}s"
m, s = divmod(s, 60)
if m < 60:
return f"{m}m {s:02d}s"
h, m = divmod(m, 60)
return f"{h}h {m:02d}m {s:02d}s"
# ── Folder size calculator ────────────────────────────────────────────────────
def folder_size(path: Path) -> int:
total = 0
for root, _, files in os.walk(path):
for f in files:
try:
total += os.path.getsize(os.path.join(root, f))
except OSError:
pass
return total
# ── 7-Zip locator ─────────────────────────────────────────────────────────────
def find_7zip() -> str | None:
for name in ("7z", "7za", "7zz", "7zip"):
path = shutil.which(name)
if path:
return path
if sys.platform == "win32":
for p in (
r"C:\Program Files\7-Zip\7z.exe",
r"C:\Program Files (x86)\7-Zip\7z.exe",
):
if os.path.isfile(p):
return p
return None
# ── Folder listing / selection ────────────────────────────────────────────────
def list_folders(base_dir: str) -> list[Path]:
base = Path(base_dir)
return sorted(
(e for e in base.iterdir() if e.is_dir()),
key=lambda p: p.name.lower(),
)
def prompt_folder_selection(folders: list[Path]) -> Path:
print("\nAvailable folders:\n")
for i, folder in enumerate(folders, start=1):
try:
sz = folder_size(folder)
size_label = dim(f" ({fmt_size(sz)})")
except PermissionError:
size_label = dim(" (no access)")
print(f" {dim(f'[{i:>3}]')} {folder.name}{size_label}")
print()
while True:
try:
raw = input("Enter the number of the folder to compress: ").strip()
idx = int(raw)
if 1 <= idx <= len(folders):
return folders[idx - 1]
print(f" Please enter a number between 1 and {len(folders)}.")
except ValueError:
print(" Invalid input — please enter a number.")
except (EOFError, KeyboardInterrupt):
print("\nAborted.")
sys.exit(0)
# ── Progress bar renderer ─────────────────────────────────────────────────────
BAR_WIDTH = 36
# Matches 7-Zip progress segments like "47% 3 + path/to/file.bin"
# or just "47%" when no file is on the same segment
_PROGRESS_RE = re.compile(r"(\d{1,3})%(?:\s+(\d+)\s*\+?\s*(.*))?")
# Split on ANY run of backspaces (\x08) or carriage returns (\r).
# - Linux/macOS 7-Zip uses \x08 to erase and rewrite the progress line
# - Windows 7-Zip uses \r to overwrite the progress line
# Both need to be handled so the script works cross-platform.
_SPLIT_RE = re.compile(rb"[\x08\r]+")
def _move_up(n: int):
if SUPPORTS_COLOR:
sys.stdout.write(f"\033[{n}A")
def _clear_line():
if SUPPORTS_COLOR:
sys.stdout.write("\033[2K\r")
else:
sys.stdout.write("\r" + " " * 78 + "\r")
def _redraw(pct: int, elapsed: float, files_done: int,
current_file: str, speed_bps: float):
"""Overwrite the two reserved progress lines in-place."""
filled = int(BAR_WIDTH * pct / 100)
bar = "█" * filled + "░" * (BAR_WIDTH - filled)
color = green if pct == 100 else cyan
speed_s = f"{fmt_size(speed_bps)}/s" if speed_bps > 0 else "─"
_move_up(2)
# Line 1 — bar + stats
_clear_line()
sys.stdout.write(
f" {color(bar)} {bold(f'{pct:>3}%')}"
f" {dim('elapsed')} {dim(fmt_time(elapsed))}"
f" {yellow(speed_s)}"
f" {dim(f'files: {files_done}')}\n"
)
# Line 2 — current file
_clear_line()
label = current_file.strip() or "starting…"
if len(label) > 60:
label = "…" + label[-59:]
sys.stdout.write(f" {dim('↳ ' + label)}\n")
sys.stdout.flush()
# ── Compression with real-time progress ───────────────────────────────────────
def compress_folder(seven_zip: str, folder: Path, output_dir: Path) -> Path:
archive_path = output_dir / (folder.name + ".7z")
print(f"\n {dim('Calculating source size…')} ", end="", flush=True)
src_size = folder_size(folder)
print(fmt_size(src_size))
cmd = [
seven_zip,
"a",
"-t7z",
"-mx=0", # store – no compression
"-ms=off", # no solid archive
"-bsp1", # stream progress to stdout
str(archive_path),
str(folder),
]
print(f"\n {dim('Command: ' + ' '.join(cmd))}")
print()
print(" " + "─" * 64)
# Reserve two blank lines for the live display
print()
print()
start_time = time.monotonic()
last_pct = 0
files_done = 0
current_file = ""
speed_bps = 0.0
last_bytes = 0.0
speed_ts = start_time
proc = subprocess.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
# Raw binary — we parse bytes ourselves to handle \x08 and \r
)
buf = b""
while True:
chunk = proc.stdout.read(256)
if not chunk:
break
buf += chunk
elapsed = time.monotonic() - start_time
# Split on runs of \x08 (Linux/macOS) or \r (Windows).
# Each segment between separators is one "visible write" from 7-Zip.
segments = _SPLIT_RE.split(buf)
# Keep the last (potentially incomplete) segment for the next iteration
buf = segments[-1]
for seg in segments[:-1]:
text = seg.decode("utf-8", errors="replace").strip()
if not text:
continue
m = _PROGRESS_RE.search(text)
if m:
pct = min(int(m.group(1)), 100)
files_done = int(m.group(2)) if m.group(2) else files_done
fname = (m.group(3) or "").strip()
if fname:
current_file = fname
# Rolling speed estimate (recalculate every 0.4 s)
if src_size > 0 and pct > 0:
bytes_done = src_size * pct / 100
now = time.monotonic()
dt = now - speed_ts
if dt >= 0.4:
speed_bps = (bytes_done - last_bytes) / dt
last_bytes = bytes_done
speed_ts = now
last_pct = pct
_redraw(pct, elapsed, files_done, current_file, speed_bps)
proc.wait()
elapsed_total = time.monotonic() - start_time
# Lock bar at 100% on success
if proc.returncode == 0:
_redraw(100, elapsed_total, files_done, current_file, speed_bps)
print()
print(" " + "─" * 64)
if proc.returncode == 0:
arc_size = archive_path.stat().st_size
avg_speed = src_size / elapsed_total if elapsed_total > 0 else 0
print(f"\n {green('✅ Archive created successfully!')}")
print(f" {bold('Path')} : {archive_path}")
print(f" {bold('Source')} : {fmt_size(src_size)}")
print(f" {bold('Archive')} : {fmt_size(arc_size)}")
print(f" {bold('Time')} : {fmt_time(elapsed_total)}")
print(f" {bold('Avg speed')}: {fmt_size(avg_speed)}/s")
else:
print(f"\n {red(f'❌ 7-Zip exited with code {proc.returncode}.')}")
sys.exit(proc.returncode)
return archive_path
# ── Entry point ───────────────────────────────────────────────────────────────
def main():
scan_dir = os.path.abspath(sys.argv[1] if len(sys.argv) > 1 else os.getcwd())
if not os.path.isdir(scan_dir):
print(f"Error: '{scan_dir}' is not a valid directory.")
sys.exit(1)
print(f"\n{bold('📦 Folder Compressor')}")
print(f" Scanning: {cyan(scan_dir)}\n")
seven_zip = find_7zip()
if not seven_zip:
print(
f"\n{red('❌ 7-Zip not found.')}\n"
" Install it and make sure '7z' (or '7za') is on your PATH.\n"
" • Linux : sudo apt install p7zip-full\n"
" • macOS : brew install p7zip\n"
" • Windows: https://www.7-zip.org/download.html"
)
sys.exit(1)
print(f" {green('✔')} 7-Zip: {dim(seven_zip)}")
folders = list_folders(scan_dir)
if not folders:
print(f"\nNo sub-folders found in '{scan_dir}'.")
sys.exit(0)
chosen = prompt_folder_selection(folders)
print(f"\n {green('✔')} Selected: {bold(chosen.name)}")
compress_folder(seven_zip, chosen, chosen.parent)
print()
if __name__ == "__main__":
main()
old_02/README.md
+316
View File
@@ -0,0 +1,316 @@
# 📦 Folder Compressor
A command-line Python script that lets you pick any sub-folder to compress, or compress **all folders in one go** — each one individually with its own live progress bar. Uses **7-Zip store mode** (no compression) for maximum speed and zero CPU overhead.
---
## Features
- Browse all sub-folders with their sizes before choosing
- **Two modes at runtime:**
- **Single folder** — select one folder by number
- **Compress all** — process every folder sequentially, one by one
- Real-time progress bar per job showing:
- Percentage complete
- Elapsed time
- Live transfer speed (MB/s)
- File count
- Currently processing file name
- Pause between jobs in batch mode so you can read each result before continuing
- Batch summary table at the end showing all jobs, sizes, times, and speeds
- Color-coded terminal output (auto-disabled if not supported)
- Cross-platform: Windows, macOS, Linux
---
## Requirements
### Python
Version **3.10 or higher** is required (uses `str | None` union type syntax).
Check your version:
```bash
python --version
# or
python3 --version
```
No third-party packages are needed — only Python's standard library is used.
### 7-Zip
7-Zip must be installed and accessible on your system PATH.
| Platform | Install command |
|----------|----------------|
| **Linux** (Debian/Ubuntu) | `sudo apt install p7zip-full` |
| **Linux** (Fedora/RHEL) | `sudo dnf install p7zip p7zip-plugins` |
| **macOS** (Homebrew) | `brew install p7zip` |
| **macOS** (MacPorts) | `sudo port install p7zip` |
| **Windows** | Download installer from [https://www.7-zip.org/download.html](https://www.7-zip.org/download.html) |
> **Windows note:** After installing, make sure `C:\Program Files\7-Zip\` is added to your system PATH, or the script will auto-detect it from the default install location automatically.
> **Minimum version:** 7-Zip **15.06 or newer** is required for the `-bsp1` progress flag used for real-time output. Most current installs will meet this requirement.
Verify 7-Zip is available:
```bash
7z i
```
---
## Installation
No installation needed. Just download the script:
```bash
# Download compress_folder.py to any directory, then run it directly with Python
```
Optionally make it executable on Linux/macOS:
```bash
chmod +x compress_folder.py
```
---
## Usage
### Basic — scan the current directory
```bash
python compress_folder.py
```
### Specify a directory to scan
```bash
python compress_folder.py /path/to/directory
```
### On Linux/macOS (if made executable)
```bash
./compress_folder.py
./compress_folder.py /path/to/directory
```
### On Windows
```bash
python compress_folder.py
python compress_folder.py C:\Users\YourName\Documents
```
---
## Step-by-step walkthrough
### Step 1 — Launch the script
```
📦 Folder Compressor
Scanning: /home/user/projects
```
### Step 2 — Browse folders and choose a mode
All sub-folders are listed with their sizes, followed by the option to compress all:
```
Available folders:
[ 1] archive (240.0 MB)
[ 2] builds (1.4 GB)
[ 3] logs (88.3 MB)
[ 4] source (320.5 MB)
[ A] Compress ALL folders one by one
Enter a folder number or A to compress all:
```
**To compress a single folder:** type its number and press Enter.
**To compress all folders:** type `A` and press Enter.
---
### Single folder mode
```
Enter a folder number or A to compress all: 2
✔ Mode: Single folder → builds
Calculating source size… 1.4 GB
────────────────────────────────────────────────────────────────
████████████████░░░░░░░░░░░░░░░░░░░ 62% elapsed 0m 08s 178.4 MB/s files: 312
↳ builds/release/v2.1.0/installer.exe
────────────────────────────────────────────────────────────────
✅ Archive created successfully!
Path : /home/user/projects/builds.7z
Source : 1.4 GB
Archive : 1.4 GB
Time : 0m 09s
Avg speed: 159.2 MB/s
```
---
### Compress all mode
Each folder gets a numbered job header and its own progress bar. After each job finishes, the script pauses and waits for you to press Enter before starting the next one:
```
Enter a folder number or A to compress all: A
✔ Mode: Compress all folders sequentially
[1/4] archive ────────────────────────────────────────────
Calculating source size… 240.0 MB
...
✅ Archive created successfully! (240.0 MB · 1s · 240.0 MB/s)
Press Enter to continue to the next folder…
[2/4] builds ─────────────────────────────────────────────
...
```
After all jobs complete, a **batch summary** is printed:
```
══════════════════════════════════════════════════════════════════
BATCH SUMMARY — 4 folder(s) processed
══════════════════════════════════════════════════════════════════
✅ archive 240.0 MB → 1s @ 240.0 MB/s
✅ builds 1.4 GB → 9s @ 159.2 MB/s
✅ logs 88.3 MB → 0s @ 310.5 MB/s
✅ source 320.5 MB → 2s @ 192.1 MB/s
──────────────────────────────────────────────────────────────────
Total source size : 2.0 GB
Total archive size: 2.0 GB
Total time : 12s
Overall avg speed : 170.4 MB/s
══════════════════════════════════════════════════════════════════
```
If any jobs fail, they are flagged in the summary with their error code.
---
## Progress bar reference
| Element | Description |
|---------|-------------|
| `████░░░` | Progress bar filling left to right |
| `62%` | Percentage of data processed |
| `elapsed 0m 08s` | Time since this job started |
| `178.4 MB/s` | Rolling average throughput speed |
| `files: 312` | Number of files added so far |
| `↳ filename` | The file currently being processed |
---
## Compression settings
The script uses the following 7-Zip flags:
| Flag | Value | Meaning |
|------|-------|---------|
| `-t7z` | — | Output format: 7z |
| `-mx=0` | 0 | Compression level 0 = **store** (no compression) |
| `-ms=off` | off | Solid archive **disabled** (faster for many files) |
| `-bsp1` | — | Stream progress output to stdout (enables live display) |
**Why no compression?**
Store mode (`-mx=0`) copies files into the archive as-is without compressing them. This is ideal when:
- Speed matters more than file size reduction
- The contents are already compressed (videos, images, zip files, etc.)
- You want to bundle files for transfer without the CPU cost of compression
---
## How the real-time progress works
7-Zip does not write progress on separate lines — instead it continuously overwrites the same terminal line using special control characters. The exact character it uses depends on the platform:
| Platform | Character used | Code |
|----------|---------------|------|
| Linux / macOS | Backspace | `\x08` |
| Windows | Carriage return | `\r` |
The script reads 7-Zip's output as a raw binary stream and splits on **both** characters, so progress is captured correctly on every platform. The percentage, file count, and current filename are extracted from each segment using a regex and rendered live into two reserved terminal lines that update in place.
---
## Output location
Each archive is created in the **same directory that contains the source folder**.
Example:
```
/home/user/projects/ ← scanned directory
archive/ ← source folder
archive.7z ← archive created here
builds/
builds.7z
```
If an archive with the same name already exists, 7-Zip will update it (adding/replacing files). Delete the existing `.7z` first if you want a clean archive.
---
## Interrupting a batch
Press `Ctrl+C` at any "Press Enter to continue" prompt to stop the batch early. Any jobs already completed will have their archives saved. A partial batch summary will be printed for the jobs that ran.
---
## Troubleshooting
**`7-Zip not found` error**
- Ensure 7-Zip is installed (see Requirements above)
- Confirm `7z` is on your PATH: run `which 7z` (Linux/macOS) or `where 7z` (Windows)
- On Windows, try re-installing 7-Zip and ticking the "Add to PATH" option, or place `7z.exe` in `C:\Program Files\7-Zip\` which the script checks automatically
**Progress bar stays at 0% / no stats shown**
- Make sure you are using the latest version of the script
- The root cause of this bug was that Windows 7-Zip uses `\r` to update progress lines while Linux/macOS uses `\x08` (backspace). The current version handles both
- If you still see 0% after updating, confirm your 7-Zip version is 15.06 or newer: run `7z i` and check the version line at the top
**No progress bar / garbled output**
- The live progress display requires a terminal that supports ANSI escape codes
- On older Windows CMD, switch to Windows Terminal or PowerShell
- Progress and stats are still printed even if color/ANSI is not supported
**`SyntaxError` on startup**
- Your Python version is below 3.10 — upgrade to Python 3.10+
**Permission denied on folder**
- Run the script with elevated permissions (`sudo` on Linux/macOS, Run as Administrator on Windows)
- Or select a folder you have read access to
---
## Examples
```bash
# Compress a single folder or all folders in the current directory
python compress_folder.py
# Compress a single folder or all folders inside a specific path
python compress_folder.py /mnt/data/backups
# Windows example
python compress_folder.py "C:\Users\Alice\Desktop"
```
---
## License
This script is provided as-is for personal and commercial use. No warranty is expressed or implied.
old_02/compress_folder.py
+428
View File
@@ -0,0 +1,428 @@
#!/usr/bin/env python3
"""
Folder Compressor using 7-Zip
- Select a single folder to compress, OR
- Compress all folders one by one automatically
Uses 7-Zip store mode (no compression) for maximum speed.
Real-time progress bar shown during each compression job.
"""
import os
import re
import sys
import shutil
import subprocess
import time
from pathlib import Path
from dataclasses import dataclass
# ── Terminal color helpers ────────────────────────────────────────────────────
SUPPORTS_COLOR = (
sys.stdout.isatty()
and (sys.platform != "win32" or os.environ.get("WT_SESSION") or os.environ.get("TERM"))
)
def _c(code: str, text: str) -> str:
return f"\033[{code}m{text}\033[0m" if SUPPORTS_COLOR else text
def green(t): return _c("32", t)
def yellow(t): return _c("33", t)
def cyan(t): return _c("36", t)
def bold(t): return _c("1", t)
def dim(t): return _c("2", t)
def red(t): return _c("31", t)
def magenta(t): return _c("35", t)
# ── Size / time formatters ────────────────────────────────────────────────────
def fmt_size(b: float) -> str:
for unit in ("B", "KB", "MB", "GB", "TB"):
if b < 1024:
return f"{b:.1f} {unit}"
b /= 1024
return f"{b:.1f} PB"
def fmt_time(seconds: float) -> str:
s = int(seconds)
if s < 60:
return f"{s}s"
m, s = divmod(s, 60)
if m < 60:
return f"{m}m {s:02d}s"
h, m = divmod(m, 60)
return f"{h}h {m:02d}m {s:02d}s"
# ── Folder size calculator ────────────────────────────────────────────────────
def folder_size(path: Path) -> int:
total = 0
for root, _, files in os.walk(path):
for f in files:
try:
total += os.path.getsize(os.path.join(root, f))
except OSError:
pass
return total
# ── 7-Zip locator ─────────────────────────────────────────────────────────────
def find_7zip() -> str | None:
for name in ("7z", "7za", "7zz", "7zip"):
path = shutil.which(name)
if path:
return path
if sys.platform == "win32":
for p in (
r"C:\Program Files\7-Zip\7z.exe",
r"C:\Program Files (x86)\7-Zip\7z.exe",
):
if os.path.isfile(p):
return p
return None
# ── Folder listing ────────────────────────────────────────────────────────────
def list_folders(base_dir: str) -> list[Path]:
base = Path(base_dir)
return sorted(
(e for e in base.iterdir() if e.is_dir()),
key=lambda p: p.name.lower(),
)
# ── Mode + folder selection menu ─────────────────────────────────────────────
def prompt_mode_and_selection(folders: list[Path]) -> list[Path]:
"""
Print the folder list then ask the user what to do:
A — compress ALL folders sequentially
1…N — compress a single specific folder
Returns the list of folders to compress (one or all).
"""
print("\nAvailable folders:\n")
for i, folder in enumerate(folders, start=1):
try:
sz = folder_size(folder)
size_label = dim(f" ({fmt_size(sz)})")
except PermissionError:
size_label = dim(" (no access)")
print(f" {dim(f'[{i:>3}]')} {folder.name}{size_label}")
print()
print(f" {dim('[ A]')} {bold('Compress ALL folders one by one')}")
print()
while True:
try:
raw = input("Enter a folder number or A to compress all: ").strip().upper()
if raw == "A":
print(f"\n {green('✔')} Mode: {bold('Compress all folders sequentially')}")
return list(folders)
idx = int(raw)
if 1 <= idx <= len(folders):
chosen = folders[idx - 1]
print(f"\n {green('✔')} Mode: {bold('Single folder')} → {chosen.name}")
return [chosen]
print(f" Please enter a number between 1 and {len(folders)}, or A.")
except ValueError:
print(" Invalid input — enter a number or A.")
except (EOFError, KeyboardInterrupt):
print("\nAborted.")
sys.exit(0)
# ── Progress bar renderer ─────────────────────────────────────────────────────
BAR_WIDTH = 36
_PROGRESS_RE = re.compile(r"(\d{1,3})%(?:\s+(\d+)\s*\+?\s*(.*))?")
# Split on backspaces (\x08, Linux/macOS) or carriage returns (\r, Windows)
_SPLIT_RE = re.compile(rb"[\x08\r]+")
def _move_up(n: int):
if SUPPORTS_COLOR:
sys.stdout.write(f"\033[{n}A")
def _clear_line():
if SUPPORTS_COLOR:
sys.stdout.write("\033[2K\r")
else:
sys.stdout.write("\r" + " " * 78 + "\r")
def _redraw(pct: int, elapsed: float, files_done: int,
current_file: str, speed_bps: float):
filled = int(BAR_WIDTH * pct / 100)
bar = "█" * filled + "░" * (BAR_WIDTH - filled)
color = green if pct == 100 else cyan
speed_s = f"{fmt_size(speed_bps)}/s" if speed_bps > 0 else "─"
_move_up(2)
_clear_line()
sys.stdout.write(
f" {color(bar)} {bold(f'{pct:>3}%')}"
f" {dim('elapsed')} {dim(fmt_time(elapsed))}"
f" {yellow(speed_s)}"
f" {dim(f'files: {files_done}')}\n"
)
_clear_line()
label = current_file.strip() or "starting…"
if len(label) > 60:
label = "…" + label[-59:]
sys.stdout.write(f" {dim('↳ ' + label)}\n")
sys.stdout.flush()
# ── Result record ─────────────────────────────────────────────────────────────
@dataclass
class JobResult:
folder: Path
archive: Path | None
src_size: int
arc_size: int
elapsed: float
avg_speed: float
success: bool
error: str = ""
# ── Single compression job ────────────────────────────────────────────────────
def compress_folder(seven_zip: str, folder: Path, output_dir: Path,
job_label: str = "") -> JobResult:
archive_path = output_dir / (folder.name + ".7z")
if job_label:
print(f"\n{job_label}")
print(f"\n {dim('Calculating source size…')} ", end="", flush=True)
src_size = folder_size(folder)
print(fmt_size(src_size))
cmd = [
seven_zip,
"a",
"-t7z",
"-mx=0",
"-ms=off",
"-bsp1",
str(archive_path),
str(folder),
]
print(f"\n {dim('Command: ' + ' '.join(cmd))}")
print()
print(" " + "─" * 64)
print()
print()
start_time = time.monotonic()
files_done = 0
current_file = ""
speed_bps = 0.0
last_bytes = 0.0
speed_ts = start_time
proc = subprocess.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
)
buf = b""
while True:
chunk = proc.stdout.read(256)
if not chunk:
break
buf += chunk
elapsed = time.monotonic() - start_time
segments = _SPLIT_RE.split(buf)
buf = segments[-1]
for seg in segments[:-1]:
text = seg.decode("utf-8", errors="replace").strip()
if not text:
continue
m = _PROGRESS_RE.search(text)
if m:
pct = min(int(m.group(1)), 100)
files_done = int(m.group(2)) if m.group(2) else files_done
fname = (m.group(3) or "").strip()
if fname:
current_file = fname
if src_size > 0 and pct > 0:
bytes_done = src_size * pct / 100
now = time.monotonic()
dt = now - speed_ts
if dt >= 0.4:
speed_bps = (bytes_done - last_bytes) / dt
last_bytes = bytes_done
speed_ts = now
_redraw(pct, elapsed, files_done, current_file, speed_bps)
proc.wait()
elapsed_total = time.monotonic() - start_time
if proc.returncode == 0:
_redraw(100, elapsed_total, files_done, current_file, speed_bps)
print()
print(" " + "─" * 64)
if proc.returncode == 0:
arc_size = archive_path.stat().st_size
avg_speed = src_size / elapsed_total if elapsed_total > 0 else 0
print(f"\n {green('✅ Archive created successfully!')}")
print(f" {bold('Path')} : {archive_path}")
print(f" {bold('Source')} : {fmt_size(src_size)}")
print(f" {bold('Archive')} : {fmt_size(arc_size)}")
print(f" {bold('Time')} : {fmt_time(elapsed_total)}")
print(f" {bold('Avg speed')}: {fmt_size(avg_speed)}/s")
return JobResult(
folder=folder, archive=archive_path,
src_size=src_size, arc_size=arc_size,
elapsed=elapsed_total, avg_speed=avg_speed,
success=True,
)
else:
msg = f"7-Zip exited with code {proc.returncode}"
print(f"\n {red(f'❌ {msg}')}")
return JobResult(
folder=folder, archive=None,
src_size=src_size, arc_size=0,
elapsed=elapsed_total, avg_speed=0,
success=False, error=msg,
)
# ── Batch summary ─────────────────────────────────────────────────────────────
def print_batch_summary(results: list[JobResult]):
succeeded = [r for r in results if r.success]
failed = [r for r in results if not r.success]
total_src = sum(r.src_size for r in results)
total_arc = sum(r.arc_size for r in results)
total_t = sum(r.elapsed for r in results)
width = 66
print()
print(" " + "═" * width)
print(f" {bold('BATCH SUMMARY')} — {len(results)} folder(s) processed")
print(" " + "═" * width)
for r in results:
icon = green("✅") if r.success else red("❌")
label = r.folder.name
if len(label) > 38:
label = label[:35] + "…"
if r.success:
detail = f"{fmt_size(r.src_size)} → {fmt_time(r.elapsed)} @ {fmt_size(r.avg_speed)}/s"
else:
detail = red(r.error)
print(f" {icon} {label:<38} {dim(detail)}")
print(" " + "─" * width)
print(f" {bold('Total source size')} : {fmt_size(total_src)}")
print(f" {bold('Total archive size')}: {fmt_size(total_arc)}")
print(f" {bold('Total time')} : {fmt_time(total_t)}")
if total_t > 0:
avg = total_src / total_t
print(f" {bold('Overall avg speed')} : {fmt_size(avg)}/s")
if failed:
print()
print(f" {red(f'⚠ {len(failed)} job(s) failed:')}")
for r in failed:
print(f" • {r.folder.name} — {r.error}")
print(" " + "═" * width)
print()
# ── Entry point ───────────────────────────────────────────────────────────────
def main():
scan_dir = os.path.abspath(sys.argv[1] if len(sys.argv) > 1 else os.getcwd())
if not os.path.isdir(scan_dir):
print(f"Error: '{scan_dir}' is not a valid directory.")
sys.exit(1)
print(f"\n{bold('📦 Folder Compressor')}")
print(f" Scanning: {cyan(scan_dir)}\n")
seven_zip = find_7zip()
if not seven_zip:
print(
f"\n{red('❌ 7-Zip not found.')}\n"
" Install it and make sure '7z' (or '7za') is on your PATH.\n"
" • Linux : sudo apt install p7zip-full\n"
" • macOS : brew install p7zip\n"
" • Windows: https://www.7-zip.org/download.html"
)
sys.exit(1)
print(f" {green('✔')} 7-Zip: {dim(seven_zip)}")
folders = list_folders(scan_dir)
if not folders:
print(f"\nNo sub-folders found in '{scan_dir}'.")
sys.exit(0)
targets = prompt_mode_and_selection(folders)
batch = len(targets) > 1
results: list[JobResult] = []
for i, folder in enumerate(targets, start=1):
label = ""
if batch:
label = (
f"\n {magenta(f'[{i}/{len(targets)}]')} "
f"{bold(folder.name)}"
f" {dim('─' * max(0, 44 - len(folder.name)))}"
)
result = compress_folder(seven_zip, folder, folder.parent, job_label=label)
results.append(result)
# In batch mode, pause briefly between jobs so the user can read each result
if batch and i < len(targets):
print()
try:
input(f" {dim('Press Enter to continue to the next folder…')}")
except (EOFError, KeyboardInterrupt):
print(f"\n {yellow('⚠ Batch interrupted by user.')}")
break
if batch:
print_batch_summary(results)
else:
print()
if __name__ == "__main__":
main()