LinuxCommandLibrary

dvc-unfreeze

Unlock tracked files for modifications

TLDR

Unfreeze one or more specified stages

$ dvc unfreeze [stage_name1 stage_name2 ...]
copy

SYNOPSIS

dvc unfreeze [-h] [-q | -v] [--glob] [--recursive] targets [...]

PARAMETERS

targets
    Paths to DVC-tracked files or directories to unfreeze. Can be a single file, multiple files, or a directory. If a directory is specified, all DVC-tracked files within that directory will be unfrozen.

-h, --help
    Show help message and exit.

-q, --quiet
    Suppress printing DVC progress and debug messages.

-v, --verbose
    Increase verbosity. Print debug messages.

--glob
    Treat targets as a glob pattern (see glob).

--recursive
    Unfreeze all DVC-tracked files in the subdirectories of the targets.

DESCRIPTION

The dvc-unfreeze command unlocks specified DVC-tracked files or directories. This means DVC will recalculate their checksums and update the dvc.lock file on the next dvc repro execution. Use this command to force DVC to re-evaluate dependencies after they have been unintentionally changed, or after the corresponding .dvc files have been frozen. It is the reverse operation to `dvc freeze`. This command is useful when you need to ensure DVC recognizes changes made to data dependencies, preventing DVC from skipping stages that should be executed based on these changes.
Unfreezing essentially tells DVC that a data dependency might have changed, regardless of the checksum in the `dvc.lock` file. This is different from simply modifying the data dependency directly, which would trigger DVC to update the checksums automatically during `dvc repro` if the dependency isn't frozen.

EXAMPLE

To unfreeze a file named `data.csv`: dvc unfreeze data.csv To unfreeze all files within a directory named `data`: dvc unfreeze data To unfreeze all `.csv` files in the `data` directory, treating `data/*.csv` as a glob: dvc unfreeze --glob data/*.csv

SEE ALSO

dvc freeze(1), dvc repro(1), dvc lock(5)

Copied to clipboard