Module migrations 

Runtime migrations for the library subsystem.

Each migration is registered automatically at startup via the crate::migration! macro and tracked in the _cadmus_migrations table.

Registered migrations

Module	Migration ID
import_legacy_filesystem_data::MIGRATION_ID	v1_import_legacy_filesystem_data
rehash_fingerprints::MIGRATION_ID	v2_rehash_fingerprints

Modules

import_legacy_filesystem_data

Module generated by the crate::migration! macro.

rehash_fingerprints

Module generated by the crate::migration! macro.

Functions

canonicalize_legacy_fingerprints 🔒

delete_thumbnail_previews 🔒

Removes .thumbnail-previews/ from the library directory.

ensure_library 🔒

Ensures the library row exists and returns its id.

ensure_stub_book 🔒

Inserts a stub books row and a library_books association for fp if they do not already exist.

import_legacy_filesystem_data 🔒

Imports book metadata from .metadata.json and reading progress from .reading-states/<fingerprint>.json into SQLite for every library path listed in Settings.toml. Covers both legacy library modes:

import_library 🔒

Imports all books and reading states from a single library directory.

import_metadata_entries 🔒

Imports all entries from a .metadata.json file into the database.

import_orphan_reading_states 🔒

Imports reading states from .reading-states/ that are not in already_imported.

insert_book 🔒

insert_reading_state 🔒

insert_rekeyed_book 🔒

insert_toc_entries 🔒

load_metadata 🔒

mark_library_imported 🔒

Renames .metadata.json and .reading-states/ to their .imported suffixed equivalents so that subsequent runs of the migration skip this library.

merge_book_authors 🔒

merge_book_categories 🔒

merge_duplicate_book_data 🔒

merge_library_books 🔒

merge_reading_states 🔒

merge_thumbnails 🔒

merge_toc_entries 🔒

move_rekeyed_book_data 🔒

rehash_fingerprints 🔒

Re-fingerprints every book in all libraries using BLAKE3 content hashing.

rekey_book 🔒

Re-keys a single book row from old_fp to new_fp, preserving all associated data (reading state, thumbnails, TOC, authors, categories).