Vcspull

Patch branch: [`v1.12.x`](https://github.com/vcs-python/vcspull/tree/v1.12.x)

Breaking changes

- Config location uses `XDG_CONFIG_HOME` from [XDG Base Directory],
(367).

Old path: `~/.vcspull`

New path: `XDG_CONFIG_HOME`, usually `~/.config/vcspull`

[xdg base directory]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html

- Override config directory via `VCSPULL_CONFIGDIR` (367)
- Switch from `str` to `pathlib.Path` (364)
- Requires click 8+

Compatibility

- Allow click 8.1.x (372)
- vcspull learned `-h` for help (thanks HN 2022-04-11)
- Python 3.7 and 3.8 dropped (356)

Branch [`v1.11.x`](https://github.com/vcs-python/vcspull/tree/v1.11.x) opened for security / bug fixes.

- `--version` learned to show libvcs version
- `--version` learned to accept the `-V` flag
- `vcspull sync` accepts config file params via `--config`. Before it was only
`-c`. Assume myrepos.yaml in your path:

console
$ vcspull sync --config myrepos.yaml


Development

- Publish to PyPI via CI when git tags are pushed

Documentation

- Sidebar reorganized into sections
- Added documentation on fetching developmental releases of libvcs

Compatibility

- `vcspull sync` accepts config file params via `--config`. Before it was only
`-c`. Assume myrepos.yaml in your path:

console
$ vcspull sync --config myrepos.yaml


(backport from vcspull v1.12.0b22)

Compatibility

- Allow click 8.1.x (backport of 372)

Compatibility

- vcspull learned `-h` for help (thanks HN 2022-04-11)
- vcspull learned `-V` for version
- vcspull shows libvcs version with `-V` / `--version`

Fix

- Tab-completion for repository names and configurations (retracted in v1.15)

Security

- Update libvcs 0.11.0 -> 0.11.1 to patch [CVE-2022-21187](https://nvd.nist.gov/vuln/detail/CVE-2022-21187): mercurial URL injection
vulnerability with URLs arguments ([libvcs306](https://github.com/vcs-python/libvcs/pull/306))

Development

- Run pyupgrade formatting (353)
- Tests: Move from pytest `tmp_dir` (`py.path.local`) to `tmp_path`
(`pathlib.Path`)

Documentation

- Move to furo theme
- Root: `make start_docs`, `make design_docs`
- docs/: `make start`, `make design`