SVP(1)

📦 version 0.5.44, in debian bookworm, debian trixie, ubuntu jammy, ubuntu questing

💖 SVP(1) — User Commands 💖

okay bestie, listen up, this is the svp page from the User Commands section and it's genuinely so useful, i'm obsessed ✨

✨ NAME ✨

svp — create and manage changes to VCS repositories 🦋

🌸 SYNOPSIS 🌸

svp [-h] [--version] {run,hosters,login,proposals} ...

💅 DESCRIPTION 💅

Silver-Platter makes it possible to contribute automatable changes to source code in a version control system. no cap. that's the whole vibe.

it automatically creates a local checkout of a remote repository, makes user-specified changes, publishes those changes on the remote hosting site, and then creates a pull request. the way it just… does all of that for you 😭 iconic behaviour honestly.

in addition to that, it can also perform basic maintenance on branches that have been proposed for merging — such as restarting them if they have conflicts due to upstream changes. lowkey the most useful part, fr fr.

🎀 COMMAND OVERVIEW 🎀

  • svp run [--refresh] [--label LABEL] [--name NAME] [--mode {push,attempt-push,propose}] [--commit-pending {auto,yes,no}] [--dry-run] url script — make a change by running a script. URL should be the URL of a repository to make changes to. script will be run in a checkout of the URL, with the opportunity to make changes. depending on the specified mode, the changes will be committed and pushed back to the repository at the original URL or proposed as a change to the repository at the original URL. svp will exit 0 if no changes have been made, 1 if at least one repository has been changed, and 2 in case of trouble. ⚠️ yes those exit codes matter, remember them.
  • svp hosters — display known hosting sites. 🌈
  • svp login BASE-URL — log into a new hosting site. 🫶
  • svp proposals [--status {open,merged,closed}] — print URLs of all proposals of a specified status that are owned by the current user. 👑

🌟 optional arguments: 🌟

  • -h, --help — show this help message and exit. the classic. the icon. 💅
  • --version — show program's version number and exit. 🎀

🦋 SUPPORTED HOSTERS 🦋

at the moment GitHub, Launchpad and any instances of GitLab are supported. slay.

⭐ EXAMPLES ⭐

  • svp login https://github.com/ — log in to GitHub. go off, get yourself authenticated bestie.
  • svp hosters — list all known hosting sites. 🍓
  • svp proposals --status merged — list all merged proposals owned by the current user. look at you, so productive.
  • svp run --mode=attempt-push git://github.com/dulwich/dulwich ./fix-typo.py — run the script ./fix-typo.py in a checkout of the Dulwich repository. any changes the script makes will be pushed back to the main repository if the current user has the right permissions, and otherwise they will be proposed as a pull request. literally the whole point of this tool and it's giving main character energy.

🔥 SEE ALSO 🔥

debian-svp(1), git(1), brz(1)

iykyk. go read those too.

📜 LICENSE 📜

GNU General Public License, version 2 or later. periodt.

💜 AUTHORS 💜

Jelmer Vernooij <jelmer@jelmer.uk> — thank you for your service king 🫡

okay that's the whole page!! this is svp version 0.0.1, dated February 2019, and yes it's an oldie but she's still serving 💖 bye bestie, go make some pull requests ✨🎀

📦 where this page comes from