mirror of
https://github.com/Stone-Red-Code/dvc.git
synced 2026-11-05 23:09:32 +01:00
Jorge OrpinelandRuslan Kuprieiev
ce83231128
* Document dvc.scm.git::Git::_get_diff_trees and shorten commit hashes in dvc.scm.git::Git::get_diff_trees * diff: Changes to dvc.scm.git so `dvc diff` outputs short SHAs - Docstring for Git class constructor - Renames self.git for self.repo throughout module (involves several test changes) - Better doc and logical refactor in Git._get_diff_trees - `dvc diff` now outputs short SHA strings (Git._get_diff_trees) - hard coded to 7 length str (involves some test changes in tests/func/test_diff.py) For #1902 * Undoes "Renames self.git for self.repo throughout module" introduced in 3d2dc83. * autocomplete: Brings scripts/completion/dvc.zsh up-to-date - Reorganizes commands in alphabetical order; - Updates the command dscriptions according to their current usage (-h) output; - Adds comments for MISSING command entries * Update scripts/completion/dvc.zsh Co-Authored-By: Ruslan Kuprieiev <[email protected]> * Update scripts/completion/dvc.zsh Co-Authored-By: Ruslan Kuprieiev <[email protected]> * Update scripts/completion/dvc.zsh Co-Authored-By: Ruslan Kuprieiev <[email protected]> * Update scripts/completion/dvc.zsh Co-Authored-By: Ruslan Kuprieiev <[email protected]> * autocomplete: Adds missing commands to Zsh script * cache: updates slow link type warning message (and test) in accordance with https://github.com/iterative/dvc.org/pull/331 * Fixes accidental docstring rewrap per https://github.com/iterative/dvc/pull/2003#discussion_r286206870 * Actually fixes accidental docstring rewrap... per https://github.com/iterative/dvc/pull/2003#pullrequestreview-240994592 * Really fixes accidental docstring rewrap this time...
271 lines
11 KiB
Bash
271 lines
11 KiB
Bash
#compdef dvc
|
|
|
|
#----------------------------------------------------------
|
|
# Repository: https://github.com/iterative/dvc
|
|
#
|
|
# References:
|
|
# - https://github.com/zsh-users/zsh-completions
|
|
# - http://zsh.sourceforge.net/Doc/Release/Completion-System.html
|
|
# - https://mads-hartmann.com/2017/08/06/writing-zsh-completion-scripts.html
|
|
# - http://www.linux-mag.com/id/1106/
|
|
#----------------------------------------------------------
|
|
|
|
_dvc_commands() {
|
|
local _commands=(
|
|
"add:Take data files or directories under DVC control."
|
|
"cache:Manage cache settings."
|
|
"checkout:Checkout data files from cache."
|
|
"commit:Save changed data to cache and update DVC files."
|
|
"config:Get or set config settings."
|
|
"destroy:Remove DVC files, local DVC config and data cache."
|
|
"diff:Show a diff of a DVC controlled data file or a directory."
|
|
"fetch:Fetch data files from a DVC remote storage."
|
|
"gc:Collect unused data from DVC cache or a remote storage."
|
|
"import:Download or copy files from URL and take under DVC control."
|
|
"init:Initialize DVC in the current directory."
|
|
"install:Install DVC git hooks into the repository."
|
|
"lock:Lock DVC file."
|
|
"metrics:Commands to add, manage, collect and display metrics."
|
|
"move:Rename or move a DVC controlled data file or a directory."
|
|
"pipeline:Manage pipelines."
|
|
"pull:Pull data files from a DVC remote storage."
|
|
"push:Push data files to a DVC remote storage."
|
|
"remote:Manage remote storage configuration."
|
|
"remove:Remove outputs of DVC file."
|
|
"repro:Check for changes and reproduce DVC file and dependencies."
|
|
"root:Relative path to project's directory."
|
|
"run:Generate a stage file from a command and execute the command."
|
|
"status:Show changed stages, compare local cache and a remote storage."
|
|
"unlock:Unlock DVC file."
|
|
"unprotect:Unprotect data file/directory."
|
|
"version:Show DVC version and system/environment informaion."
|
|
)
|
|
|
|
_describe 'dvc commands' _commands
|
|
}
|
|
|
|
_dvc_global_options=(
|
|
"(-)"{-h,--help}"[Show help message related to the command]"
|
|
"(-)"{-q,--quiet}"[Be quiet.]"
|
|
"(-)"{-V,--verbose}"[Be verbose.]"
|
|
)
|
|
|
|
_dvc_options=(
|
|
"(-)"{-h,--help}"[Show this help message and exit]"
|
|
"(-)"{-v,--version}"[Show program's version]"
|
|
)
|
|
|
|
_dvc_add=(
|
|
{-R,--recursive}"[Recursively add each file under the directory.]"
|
|
{-f,--file}"[Specify name of the stage file.]:File:_files"
|
|
"--no-commit[Don't put files/directories into cache.]"
|
|
"1:File:_files"
|
|
)
|
|
|
|
_dvc_cache=(
|
|
"1:Sub command:(dir)"
|
|
)
|
|
|
|
_dvc_checkout=(
|
|
{-f,--force}"[Do not prompt when removing working directory files.]"
|
|
{-d,--with-deps}"[Checkout all dependencies of the specified target.]"
|
|
"1:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
)
|
|
|
|
_dvc_commit=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
{-d,--with-deps}"[Commit all dependencies of the specified target.]"
|
|
{-f,--force}"[Commit even if checksums for dependencies/outputs changed.]"
|
|
{-R,--recursive}"[Commit cache for subdirectories of the specified directory.]"
|
|
)
|
|
|
|
_dvc_config=(
|
|
{-u,--unset}"[Unset option.]"
|
|
"--local[Unset option.]"
|
|
"--system[Use system config.]"
|
|
"--global[Use global config.]"
|
|
)
|
|
|
|
_dvc_destroy=(
|
|
{-f,--force}"[Overwrite '.dvc' if it exists. Will remove all local cache.]"
|
|
)
|
|
|
|
_dvc_diff=(
|
|
{-t,--target}"[Source path to a data file or directory.]:Target file(s):"
|
|
)
|
|
|
|
_dvc_fetch=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
"--show-checksums[Show checksums instead of file names]"
|
|
{-j,--jobs}"[Number of jobs to run simultaneously]:Number of jobs:"
|
|
{-r,--remote}"[Remote repository to pull from]:Remote repository:"
|
|
{-a,--all-branches}"[Fetch cache for all branches]"
|
|
{-T,--all-tags}"[Fetch cache for all tags]"
|
|
{-d,--with-deps}"[Fetch cache for all dependencies of the specified target]"
|
|
{-R,--recursive}"[Fetch cache for subdirectories of the specified directory.]"
|
|
)
|
|
|
|
_dvc_gc=(
|
|
{-a,--all-branches}"[Collect garbage for all branches]"
|
|
{-T,--all-tags}"[Collect garbage for all tags]"
|
|
{-c,--cloud}"[Collect garbage in remote repository]"
|
|
{-r,--remote}"[Remote repository to collect garbage in]:Remote repository:"
|
|
{-f,--force}"[Force garbage collection - automatically agree to all prompts.]"
|
|
|
|
{-p,--projects}"[Keep data files required by these projects in addition to the current one. Useful if you share a single cache across repos.]:Repos:_files"
|
|
)
|
|
|
|
_dvc_import=(
|
|
"--resume[Resume previously started download.]"
|
|
"1:URL:"
|
|
"2:Output:"
|
|
)
|
|
|
|
_dvc_init=(
|
|
"--no-scm[Initiate dvc in directory that is not tracket by any scm tool]"
|
|
{-f,--force}"[Overwrite '.dvc' if it exists. Will remove all local cache.]"
|
|
)
|
|
|
|
_dvc_install=()
|
|
|
|
_dvc_lock=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
)
|
|
|
|
_dvc_metrics=(
|
|
"1:Sub command:(show add modify remove)"
|
|
)
|
|
|
|
_dvc_move=(
|
|
"1:Source:_files"
|
|
"2:Destination:"
|
|
)
|
|
|
|
_dvc_pipeline=(
|
|
"1:Sub command:(show,list)"
|
|
)
|
|
|
|
_dvc_pull=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
"--show-checksums[Show checksums instead of file names]"
|
|
{-j,--jobs}"[Number of jobs to run simultaneously]:Number of jobs:"
|
|
{-r,--remote}"[Remote repository to pull from]:Remote repository:"
|
|
{-a,--all-branches}"[Fetch cache for all branches]"
|
|
{-T,--all-tags}"[Fetch cache for all tags]"
|
|
{-d,--with-deps}"[Fetch cache for all dependencies of the specified target]"
|
|
{-f,--force}"[Do not prompt when removing working directory files.]"
|
|
{-R,--recursive}"[Pull cache for subdirectories of the specified directory.]"
|
|
)
|
|
|
|
_dvc_push=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
"--show-checksums[Show checksums instead of file names]"
|
|
{-j,--jobs}"[Number of jobs to run simultaneously]:Number of jobs:"
|
|
{-r,--remote}"[Remote repository to pull from]:Remote repository:"
|
|
{-a,--all-branches}"[Fetch cache for all branches]"
|
|
{-T,--all-tags}"[Fetch cache for all tags]"
|
|
{-d,--with-deps}"[Fetch cache for all dependencies of the specified target]"
|
|
{-R,--recursive}"[Push cache for subdirectories of the specified directory.]"
|
|
)
|
|
|
|
_dvc_remote=(
|
|
"1:Sub command:(add default remove modify list)"
|
|
)
|
|
|
|
_dvc_remove=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
"--dry[Only print the commands that would be executed without actually executing]"
|
|
{-o,--outs}"[Only remove DVC file outputs.(default)]"
|
|
{-p,--purge}"[Remove DVC file and all its outputs]"
|
|
{-f,--force}"[Force purge.]"
|
|
)
|
|
|
|
_dvc_repro=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
"--dry[Only print the commands that would be executed without actually executing]"
|
|
"--ignore-build-cache[Reproduce all descendants of a changed stage even if their direct dependencies didn't change.]"
|
|
"--no-commit[Don't put files/directories into cache.]"
|
|
{-f,--force}"[Reproduce even if dependencies were not changed.]"
|
|
{-s,--single-item}"[Reproduce only single data item without recursive dependencies check.]"
|
|
{-m,--metrics}"[Show metrics after reproduction.]"
|
|
{-i,--interactive}"[Ask for confirmation before reproducing each stage.]"
|
|
{-p,--pipeline}"[Reproduce the whole pipeline that the specified stage file belongs to.]"
|
|
{-P,--all-pipelines}"[Reproduce all pipelines in the project.]"
|
|
{-d,--downstream}"[Reproduce the pipeline starting from the specified stage.]"
|
|
)
|
|
|
|
_dvc_root=()
|
|
|
|
_dvc_run=(
|
|
"--no-exec[Only create stage file without actually running it.]"
|
|
"--overwrite-dvcfile[Overwrite existing dvc file without asking for confirmation.]"
|
|
"--ignore-build-cache[Run this stage even if it has been already ran with the same command/dependencies/outputs/etc before.]"
|
|
"--no-commit[Don't put files/directories into cache.]"
|
|
{-f,--file}"[Specify name of the stage file.]:File:_files"
|
|
{-c,--cwd}"[Deprecated, use -w and -f instead.]:CWD:_files -/"
|
|
{-w,--wdir}"[Directory to run your command and place state file in.]:WDIR:_files -/"
|
|
"*"{-d,--deps}"[Declare dependencies for reproducible cmd.]:Dependency:_files"
|
|
"*"{-o,--outs}"[Declare output data file or data directory.]:Output data:_files"
|
|
"*"{-O,--outs-no-cache}"[Declare output regular file or directory.]:Output regular:_files"
|
|
"*"{-M,--metrics-no-cache}"[Declare output metric file or directory (do not put into DVC cache)]:Metrics (no cache):_files"
|
|
"*"{-m,--metrics}"[Declare output metric file or directory]:Metrics:_files"
|
|
{-y,--yes}"[Automatic 'yes' answer to all prompts.]"
|
|
)
|
|
|
|
_dvc_status=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
"--show-checksums[Show checksums instead of file names]"
|
|
{-j,--jobs}"[Number of jobs to run simultaneously]:Number of jobs:"
|
|
{-r,--remote}"[Remote repository to pull from]:Remote repository:"
|
|
{-a,--all-branches}"[Fetch cache for all branches]"
|
|
{-T,--all-tags}"[Fetch cache for all tags]"
|
|
{-d,--with-deps}"[Fetch cache for all dependencies of the specified target]"
|
|
{-c,--cloud}"[Show status of a local cache compared to a remote repository]"
|
|
{-q,--quiet}"[Suppresses all output. Exit with 0 if pipeline is up]"
|
|
)
|
|
|
|
_dvc_unlock=(
|
|
"*:Stages:_files -g '(*.dvc|Dvcfile)'"
|
|
)
|
|
|
|
_dvc_unprotect=(
|
|
"*:Data files:_files"
|
|
)
|
|
|
|
typeset -A opt_args
|
|
local context state line curcontext="$curcontext"
|
|
|
|
_arguments \
|
|
$_dvc_options \
|
|
'1: :_dvc_commands' \
|
|
'*::args:->args'
|
|
|
|
case $words[1] in
|
|
add) _arguments $_dvc_global_options $_dvc_add ;;
|
|
cache) _arguments $_dvc_global_options $_dvc_cache ;;
|
|
checkout) _arguments $_dvc_global_options $_dvc_checkout ;;
|
|
commit) _arguments $_dvc_global_options $_dvc_commit ;;
|
|
config) _arguments $_dvc_global_options $_dvc_config ;;
|
|
destroy) _arguments $_dvc_global_options $_dvc_destroy ;;
|
|
diff) _arguments $_dvc_global_options $_dvc_diff ;;
|
|
fetch) _arguments $_dvc_global_options $_dvc_fetch ;;
|
|
gc) _arguments $_dvc_global_options $_dvc_gc ;;
|
|
import) _arguments $_dvc_global_options $_dvc_import ;;
|
|
init) _arguments $_dvc_global_options $_dvc_init ;;
|
|
install) _arguments $_dvc_global_options $_dvc_install ;;
|
|
lock) _arguments $_dvc_global_options $_dvc_lock ;;
|
|
metrics) _arguments $_dvc_global_options $_dvc_metrics ;;
|
|
move) _arguments $_dvc_global_options $_dvc_move ;;
|
|
pipeline) _arguments $_dvc_global_options $_dvc_pipeline ;;
|
|
pull) _arguments $_dvc_global_options $_dvc_pull ;;
|
|
push) _arguments $_dvc_global_options $_dvc_push ;;
|
|
remote) _arguments $_dvc_global_options $_dvc_remote ;;
|
|
remove) _arguments $_dvc_global_options $_dvc_remove ;;
|
|
repro) _arguments $_dvc_global_options $_dvc_repro ;;
|
|
root) _arguments $_dvc_global_options $_dvc_root ;;
|
|
run) _arguments $_dvc_global_options $_dvc_run ;;
|
|
status) _arguments $_dvc_global_options $_dvc_status ;;
|
|
unlock) _arguments $_dvc_global_options $_dvc_unlock ;;
|
|
unprotect) _arguments $_dvc_global_options $_dvc_unprotect ;;
|
|
esac
|