Skip to content

Commit 39103b2

Browse files
committed
docs(MIGRATION): Back v1.13.0 behavioral notes
1 parent ccb2e81 commit 39103b2

1 file changed

Lines changed: 53 additions & 1 deletion

File tree

MIGRATION

Lines changed: 53 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ _Notes on the upcoming release will be added here_
2727

2828
## vcspull 1.15.0 (2022-10-09)
2929

30-
**Completions have changed** (#400)
30+
### Completions have changed (#400)
3131

3232
Completions now use a different tool: [shtab]. See the [completions page] for more information.
3333

@@ -36,6 +36,58 @@ If you were using earlier versions of vcspull (earlier than 1.15.0), you may nee
3636
[completions page]: https://vcspull.git-pull.com/cli/completion.html
3737
[shtab]: https://docs.iterative.ai/shtab/
3838

39+
## vcspull v1.13.0 (2022-09-25)
40+
41+
### Pulling all repositories
42+
43+
Empty command will now show help output
44+
45+
```console
46+
$ vcspull sync
47+
Usage: vcspull sync [OPTIONS] [REPO_TERMS]...
48+
49+
Options:
50+
-c, --config PATH Specify config
51+
-x, --exit-on-error Exit immediately when encountering an error syncing
52+
multiple repos
53+
-h, --help Show this message and exit.
54+
```
55+
56+
To achieve the equivalent behavior of syncing all repos, pass `'*'`:
57+
58+
```console
59+
$ vcspull sync '*'
60+
```
61+
62+
Depending on how shell escaping works in your shell setup with [wild card / asterisk], you may not need to quote `*`.
63+
64+
[wild card / asterisk]: https://tldp.org/LDP/abs/html/special-chars.html#:~:text=wild%20card%20%5Basterisk%5D.
65+
66+
### Terms with no match in config will show a notice
67+
68+
> No repo found in config(s) for "non_existent_repo"
69+
70+
- Syncing will now skip to the next repos if an error is encountered
71+
72+
- Learned `--exit-on-error` / `-x`
73+
74+
Usage:
75+
76+
```console
77+
$ vcspull sync --exit-on-error grako django
78+
```
79+
80+
Print traceback for errored repos:
81+
82+
```console
83+
$ vcspull --log-level DEBUG sync --exit-on-error grako django
84+
```
85+
86+
### Untracked files
87+
88+
Syncing in git repositories with untracked files has been improved (via libvcs
89+
0.17, https://github.com/vcs-python/libvcs/pull/425)
90+
3991
<!---
4092
# vim: set filetype=markdown:
4193
-->

0 commit comments

Comments
 (0)