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

Modules

import_legacy_filesystem_data

Module generated by the crate::migration! macro.

Functions

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 🔒

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.