Migration notes¶
Migration and deprecation notes for vcspull are here, see Changelog as well.
Welcome on board! 👋
📌 For safety, always pin the package
📖 Check the migration notes (You are here)
📣 If you feel something got deprecated and it interrupted you - past, present, or future - voice your opinion on the tracker.
We want to make vcspull fun, reliable, and useful for users.
API changes can be painful.
If we can do something to draw the sting, we’ll do it. We’re taking a balanced approach. That’s why these notes are here!
(Please pin the package. 🙏)
Next release¶
Notes on the upcoming release will be added here
vcspull 1.15.4 (2022-10-16)¶
Completions for -c / --config files¶
After updating, you can re-run shtab’s setup (see completions page) completion of:
$ vcspull sync -c [tab]
$ vcspull sync --config [tab]
vcspull 1.15.0 (2022-10-09)¶
Completions have changed¶
Completions now use a different tool: shtab. See the completions page for more information.
If you were using earlier versions of vcspull (earlier than 1.15.0), you may need to uninstall the old completions, first.
vcspull v1.13.0 (2022-09-25)¶
Pulling all repositories¶
Empty command will now show help output
$ vcspull sync
Usage: vcspull sync [OPTIONS] [REPO_TERMS]...
Options:
-c, --config PATH Specify config
-x, --exit-on-error Exit immediately when encountering an error syncing
multiple repos
-h, --help Show this message and exit.
To achieve the equivalent behavior of syncing all repos, pass '*':
$ vcspull sync '*'
Depending on how shell escaping works in your shell setup with wild card / asterisk, you may not need to quote *.
Terms with no match in config will show a notice¶
No repo found in config(s) for “non_existent_repo”
Syncing will now skip to the next repos if an error is encountered
Learned
--exit-on-error/-x
Usage:
$ vcspull sync --exit-on-error grako django
Print traceback for errored repos:
$ vcspull --log-level DEBUG sync --exit-on-error grako django
Untracked files¶
via https://github.com/vcs-python/libvcs/pull/425
Syncing in git repositories with untracked files has been improved (via libvcs 0.17)