Silver-Platter makes it possible to contribute automatable changes to source code in a version control system.

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 pull request.

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.

To log in to a code-hosting site, use svp login:

svp login https://github.com/

The simplest way to create a change as a merge proposal is to run something like:

svp run --mode propose https://github.com/jelmer/dulwich ./some-script.sh

where some-script.sh makes some modifications to a working copy and prints the body for the pull request to standard out. For example:

#!/bin/sh
sed -i 's/framwork/framework/' README.rst
echo "Fix common typo: framwork => framework"

At the moment, the following code hosters are supported:

• GitHub
• Launchpad
• GitLab instances, such as Debian's Salsa

Several common operations for Debian packages have dedicated subcommands under the debian-svp command. These will also automatically look up packaging repository location for any Debian package names that are specified.

Subcommands that are available include:

• lintian-brush: Run the lintian-brush command on the branch.
• upload-pending: Build and upload a package and push/propose the changelog updates.
• new-upstream: Merge in a new upstream release or snapshot.

debian-svp run takes package name arguments that will be resolved to repository locations from the Vcs-Git field in the package.

See debian-svp COMMAND --help for more details.

Examples running debian-svp:

debian-svp lintian-brush samba
debian-svp lintian-brush --mode=propose samba
debian-svp lintian-brush --mode=push samba

debian-svp upload-pending tdb

debian-svp new-upstream --no-build-verify tdb

The svp hosters subcommand can be used to display the hosting sites that silver-platter is aware of:

svp hosters

And to log into a new hosting site, simply run svp login BASE-URL, e.g.:

svp login https://launchpad.net/