Зеркальная копия папки
Переносит файлы в зеркальную папку, не меняя источник, и показывает план до запуска.
Что делает скрипт
Скрипт обходит источник, сравнивает размеры и при необходимости SHA-256, затем копирует только отличия. По умолчанию работает как предпросмотр, запись включается флагом --apply. Вложенные источник и назначение запрещены.
- Копирование меняет только папку назначения.
Быстрый старт
python mirror_folder.py --source ./data --dest /mnt/backup/data --apply
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python mirror_folder.py --source ./data --dest /mnt/backup/datapython mirror_folder.py --source ./data --dest /mnt/backup/data --apply --verify
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
mirror_folder.py
#!/usr/bin/env python3
"""Одностороннее зеркалирование папки без изменения источника."""
from __future__ import annotations
import argparse
import hashlib
import os
import shutil
import sys
from pathlib import Path
def is_inside(child: Path, parent: Path) -> bool:
try:
child.relative_to(parent)
return True
except ValueError:
return False
def file_digest(path: Path, chunk_size: int = 1024 * 1024) -> str:
digest = hashlib.sha256()
with path.open("rb") as handle:
while block := handle.read(chunk_size):
digest.update(block)
return digest.hexdigest()
def iter_files(root: Path):
for current, dirs, files in os.walk(root):
dirs[:] = sorted(name for name in dirs if not Path(current, name).is_symlink())
for name in sorted(files):
path = Path(current, name)
if path.is_symlink():
continue
yield path
def main() -> int:
parser = argparse.ArgumentParser(description="Зеркальная копия папки")
parser.add_argument("--source", type=Path, required=True, help="Исходная папка")
parser.add_argument("--dest", type=Path, required=True, help="Папка назначения")
parser.add_argument("--apply", action="store_true", help="Выполнить копирование")
parser.add_argument("--verify", action="store_true", help="Сравнивать SHA-256")
args = parser.parse_args()
source = args.source.expanduser().resolve()
dest = args.dest.expanduser().resolve()
if not source.is_dir():
parser.error(f"Источник не найден: {source}")
if source == dest:
parser.error("Источник и назначение совпадают")
if is_inside(dest, source) or is_inside(source, dest):
parser.error("Источник и назначение не должны вкладываться друг в друга")
planned = 0
copied = 0
skipped = 0
errors = 0
for path in iter_files(source):
relative = path.relative_to(source)
target = dest / relative
planned += 1
same = False
if target.is_file():
try:
target_stat = target.stat()
source_stat = path.stat()
same = (
target_stat.st_size == source_stat.st_size
and target_stat.st_mtime_ns == source_stat.st_mtime_ns
)
if same and args.verify:
same = file_digest(target) == file_digest(path)
except OSError:
same = False
if same:
skipped += 1
continue
if not args.apply:
print(f"Будет скопировано: {relative}")
continue
try:
target.parent.mkdir(parents=True, exist_ok=True)
shutil.copy2(path, target)
copied += 1
except OSError as error:
errors += 1
print(f"Ошибка копирования {relative}: {error}")
print(f"Файлов: {planned}, скопировано: {copied}, без изменений: {skipped}, ошибок: {errors}")
if not args.apply:
print("Предпросмотр. Для копирования добавьте --apply.")
return 1 if errors else 0
if __name__ == "__main__":
sys.exit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.