Meridian — быстрый старт

Meridian создаёт проверяемые снимки каталогов и компактные офлайн-патчи .mrd. Патч содержит только новые блоки данных, а при применении проверяет, что каталог-получатель точно соответствует базовой версии.

Установка

В архив уже включён готовый wheel, поэтому установка не требует сборки:

python -m venv .venv

Linux/macOS:

source .venv/bin/activate
python -m pip install dist/meridian_sync-1.0.0-py3-none-any.whl

Windows PowerShell:

.venv\Scripts\Activate.ps1
python -m pip install dist\meridian_sync-1.0.0-py3-none-any.whl

Проверка:

meridian --version

Рабочий сценарий

mkdir my-data
cd my-data
meridian init

Добавьте файлы и создайте базовый снимок:

meridian snapshot -m v1

После изменений:

meridian snapshot -m v2
meridian diff v1 v2
meridian bundle v1 v2 -o ../v1-to-v2.mrd

Создать тестовую копию базовой версии:

meridian restore v1 ../replica

Применить патч:

meridian inspect ../v1-to-v2.mrd
meridian apply ../v1-to-v2.mrd ../replica

Самодостаточный пакет

Обычный патч использует неизменённые блоки из базового каталога. Для переноса целой версии на пустую или постороннюю машину создайте полный пакет:

meridian bundle v1 v2 -o ../v2-full.mrd --full
meridian apply ../v2-full.mrd ../destination --allow-unrelated

Проверка и восстановление

meridian verify v2
meridian snapshots
meridian restore v2 ../restored
meridian gc

Запуск тестов из исходников

PYTHONPATH=src python -m unittest discover -s tests -v

На Windows PowerShell:

$env:PYTHONPATH = "src"
python -m unittest discover -s tests -v

Исходник