Open Source / Python Automation / Daily Build

Backup Manifest

View source ↗Scroll to explore ↓
Backup Manifest project cover
/ Overview

A dependency-free Python CLI that records a portable SHA-256 backup inventory and verifies missing, changed or unexpected files later.

NameBackup Manifest

ClientPersonal open-source project

IndustriesDeveloper and operations tooling

Date2026

/ Challenge

A copied backup can look complete in a file browser even when a file is missing, altered or unexpectedly added, and checking every item manually does not scale.

/ Provided services

Clear thinking.
Practical delivery.

01

Product definition

Scoped the one-day build around one operational question: does this backup still contain exactly the files and bytes that were recorded?

02

Integrity design

Combined stable relative paths, byte sizes and streaming SHA-256 checksums with explicit difference categories.

03

Python engineering

Implemented deterministic directory walking, safe manifest handling, text and JSON reports, and automation-friendly exit codes using only the standard library.

Backup Manifest feature visual
/ Solution

I built a standard-library Python CLI that walks a backup directory, streams SHA-256 hashes into a portable JSON manifest and later compares the directory with that recorded state.

/ Impact

Portable JSON inventory

Missing, changed and unexpected-file detection

Human-readable and JSON verification

Eleven passing standard-library tests

/ Tech stack

Python

Pathlib, hashlib, dataclasses and type hints create deterministic records while hashing files in chunks.

CLI & JSON

Argparse exposes create and verify commands with portable manifests, readable reports and machine-readable output.

Unittest

Eleven tests cover deterministic records, changed content, missing and unexpected files, symlink handling, manifest exclusion, JSON output and error codes.

Next project

Shipment SaaS System

View case study ↗