Loader

pelican.loader.load_migrations

load_migrations(migrations_dir='db/migrations')

Load and register all migration files from the specified directory.

Source code in pelican/loader.py

def load_migrations(migrations_dir: str | Path = "db/migrations") -> None:
    """Load and register all migration files from the specified directory."""
    from pelican import registry

    migrations_path = Path(migrations_dir)
    registry.clear()

    for file_path in discover_migration_files(migrations_path):
        load_migration_file(migrations_path / file_path)

pelican.loader.load_migration_file

load_migration_file(file_path)

Load a single migration file into the system.

Source code in pelican/loader.py

def load_migration_file(file_path: Path) -> None:
    """Load a single migration file into the system."""
    module_name = file_path.stem

    if spec := importlib.util.spec_from_file_location(module_name, file_path):
        module = importlib.util.module_from_spec(spec)
        sys.modules[module_name] = module

        if spec.loader:
            spec.loader.exec_module(module)

pelican.loader.discover_migration_files

discover_migration_files(migrations_dir)

Return a sorted list of migration files in the specified directory.

Source code in pelican/loader.py

def discover_migration_files(migrations_dir: Path) -> list[Path]:
    """Return a sorted list of migration files in the specified directory."""
    if not migrations_dir.exists():
        raise FileNotFoundError(f"Migrations directory not found: {migrations_dir}")

    migrations = [Path(f) for f in os.listdir(migrations_dir) if f.endswith(".py")]
    migrations.sort(reverse=True)

    return migrations