git town propose
git town propose [-b <text> | --body <text>] [-f <path> | --body-file <path>] [-t <text> | --title <text>] [-d | --detached] [--dry-run] [-v | --verbose]
The propose command helps create a new pull request (also known as merge request) for the current feature branch. It opens your forge’s website to create a new proposal in your browser and pre-populates information like branch and source/target repository. It also syncs the branch to merge before opening the pull request in detached mode.
Proposing prototype and parked branches makes them feature branches.
You can create pull requests for repositories hosted on:
On non-Windows systems, Git Town will first read the BROWSER
environment
variable to determine the browser command. If it isn’t set, Git Town will try
various common commands like open
, xdg-open
, or x-www-browser
.
Options
-b <text>
--body <text>
Pre-populate the body of the pull request with the given text.
-f <path>
--body-file <path>
When called with the --body-file
aka -f
flag, it pre-populates the body of
the pull request with the content of the given file. The filename -
reads the
body text from STDIN.
-t <text>
--title <text>
When called with the --title <title>
aka -t
flag, the propose command
pre-populate the title of the pull request to the given text.
-s
--stack
The --stack
aka -s
parameter makes Git Town propose all branches in the
stack that the current branch belongs to.
--dry-run
Use the --dry-run
flag to test-drive this command. It prints the Git commands
that would be run but doesn’t execute them.
-v
--verbose
The --verbose
aka -v
flag prints all Git commands run under the hood to
determine the repository state.
Configuration
You can configure the forge type with the hosting-platform setting.
When using SSH identities, this command uses the hostname in the hosting-origin-hostname setting.