Skip to content

yggdrasil.io.delta._names

_names

Filename helpers for the Delta _delta_log directory.

Every file under _delta_log is named after a 20-zero-padded version number plus a suffix that identifies its kind:

  • 00000000000000000007.json — version 7 commit.
  • 00000000000000000010.checkpoint.parquet — V1 single-file checkpoint for version 10.
  • 00000000000000000010.checkpoint.0000000001.0000000003.parquet — V1 multi-part checkpoint (rare; parts indexed against size).
  • 00000000000000000010.checkpoint.<uuid>.json — V2 manifest.
  • <uuid>.parquet — V2 sidecar (lives under _delta_log/_sidecars/).
  • _last_checkpoint — JSON pointer at the most recent checkpoint.

This module owns the parsing + formatting of those names. Keeping the regex and the format helpers in one place means the writer, the log reader, and the checkpoint writer never disagree on padding or suffix shape.