Резервные копии

Зеркальная копия папки

Переносит файлы в зеркальную папку, не меняя источник, и показывает план до запуска.

Python Windows macOS Linux Средний
Скачать mirror_folder.py
Описание

Что делает скрипт

Скрипт обходит источник, сравнивает размеры и при необходимости 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/data
  • python mirror_folder.py --source ./data --dest /mnt/backup/data --apply --verify
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get backup-mirror-folder
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Резервные копии

Резервное копирование, синхронизация, проверка и восстановление данных.