Scroll to navigation

GIT-PHAB(1)   GIT-PHAB(1)

NAME

git-phab - Git subcommand to integrate with phabricator.

SYNOPSIS

git phab attach [-h] [--reviewers <username1,#project2,...>]


                [--cc <username1,#project2,...>] [--message <message>]


                [--task <T123>] [--remote <remote>] [--assume-yes]


                [--projects <project1,project2,...>]


                [<revision range>]
git phab log [-h] [<revision range>]
git phab fetch [-h] [<T123>]
git phab apply [-h] [<(T|D)123>] [-n] [-o <directory>]
git phab browse [-h] [objects [objects ...]]
git phab clean [-h]
git phab land [-h] [--no-push]

DESCRIPTION

Provides integration for projects using Phabricator.

The current repository must contain a valid .arcconfig file and a remote location to push submitted branches must be defined using:

git config phab.remote <remote>

COMMANDS

attach

Creates a new differential for each commit in the provided <revision_range>. Commit messages will be rewritten to include the URL of the newly created Differential (no other information will be added to the message). If a commit message already contains the URL of a Differential it will be updated instead of creating a new one.

<revision_range> can be either a range of commits or a single commit, as understood by git rev-parse. If omitted, the default range is from the remote current branch’s remote tracking commit to HEAD.

With --task option, or if current branch is in the form Txxx-description, it will also push the current HEAD into wip/phab/Txxx-description on the configured remote repository. If the phabricator instance supports the std:maniphest:git:uri-branch extention, the remote branch URI will be linked on the Maniphest.

If not task is defined, it will prompt if a new one should be created.

If a task is defined but the current branch is not in the form Txxx-description, it will prompt if a new branch must be created using current branch’s name prefixed with Txxx-.

log

Prints all commits in the provided <revision_range>. For each commit it displays the Differential ID and its current status. See the attach command for details on how <revision_range> is formed.

fetch

Fetch the branch linked to a Maniphest task. With no argument the task will be defined from the current branch name, if it is in the form Txxx-description.

This only fetch and print the commit id, it won’t create or checkout a branch. A new branch can then be created using, for example:

git checkout -b my-branch FETCH_HEAD

With --checkout (or -c), fetch and checkout in a branch.

apply

Apply a revision and its dependencies.

With --no-dependencies (or -n), revision’s dependencies will not be applied.

With --output-directory (or -o), patches aren’t applied to the repository, but exported to a directory instead.

browse

Open related URIs in a web browser using xdg-open.

With no argument, if the current branch is in the form Txxx-description, opens that Maniphest task.

If objects is in the form Dxxx/Txxx it will open the corresponding Differential/Maniphest. Otherwise it is assumed that object is a commit as understood by git rev-parse and if that commit contains a link to a Differential it will be open.

clean

For all local and remote references, if they are in the form Txxx-description and the corresponding task has been closed, prompt if that branch should be removed.

land

Same as git push but for each commit that would be pushed, query who approved its differential and add corresponding Reviewed-by: line. Note that the email address is guessed by looking the reviewer’s fullname into git shortlog. If the fullname cannot be found it will be asked then stored into ~/.config/git/phab so it won’t be prompted again.

For each related tasks, also prompt if it should be closed.

EXAMPLES

Attach all commits since origin/master

$ git phab attach

Attach only the top commit

$ git phab attach HEAD

Attach all commits since origin/master, excluding top commit

$ git phab attach origin/master..HEAD^

Attach top 3 patches, link them to a task, and set reviewers

$ git phab attach --reviewers xclaesse,smcv --task T123 HEAD~3..

Push current branch to origin/wip/phab/T123

$ git config phab.remote origin
$ git phab attach --task T123

Fetch a branch associated with the task T123

$ git phab fetch T123
05/31/2017