pijul pull

Pull a patch from a remote repository

Usage

pijul pull [-h | --help] [-V | --version] [--repository <repository>] [--from-branch <from_branch>] [(-p | --port) <port>] [--to-branch <to_branch>] [--set-remote <set-remote>] [--set-default] [-a | --all] [remote]

Description

Pull patches from a remote repository to a branch of a local repository to a branch. Patch selection is either interactive, or includes all patches in the current branch if -a (or --all) is present.

If the <to_branch> does not exist in the local repository, it will be created. If the <from_branch> does not exist in the remote repository, this command does nothing.

This command can also save remote repositories, in two different ways:

  • If --set-default is specified, the remote destination becomes the default destination, and it is not necessary to give it a name. Subsequent pulls to the same address can be done by simply running pijul pull.

    It is not necessary to give a name (using --set-remote) to the default destination, although it is possible.

  • If --set-remote is specified, the remote destination is saved as <set-remote>, and can be reused in subsequent commands. For example, after calling pijul pull me@nest.pijul.com:example --set-remote nest, pulling from the same address (me@nest.pijul.com:example) again can be done by running pijul pull nest.

Saved remote repositories are written to ".pijul/meta.toml" (at the root of the repository).

Examples

pijul pull me@nest.pijul.com:example --set-remote nest
pijul pull nest -a

Options

  • -h, --help

    Print a help message and exit.

  • -V, --version

    Print the version of Pijul and exit.

  • --repository <repository>

    Don't run this command in the current directory, run it in <repository> instead.

  • --from-branch <from-branch>

    Pull patches from branch <from-branch> in the remote repository, instead of the default branch ("master").

  • -p <port>, --port <port>

    If the remote repository is accessed over SSH, the port of the remote SSH server, defaulting to 22 (the standard SSH port).

  • --to-branch <to-branch>

    Pull patches to branch <to-branch> in the local repository, instead of the current branch.

  • --set-remote <set-remote>

    Save this remote repository as <set-remote>. In subsequent commands, name <set-remote> can be used instead of this URI.

  • --set-default

    Make this remote repository the default. If subsequent commands involving remote repositories are called without a URI, the default remote repository will be used as the URI.

  • -a, --all

    Don't select patches to pull interactively, pull all patches instead.

  • [remote]

    Name or URI of the remote repository. A name can be for instance "nest", while a URI can be a HTTP or HTTPS URL, or an SSH address (such as "me@nest.pijul.com:repository"), or a local path.