qbzr - Qt dialogs for many Bazaar commands

Version 0.20.0
Branch lp:qbzr
Home page http://bazaar-vcs.org/QBzr
Owner qbzr-dev
GNU/Linux Yes
Windows Yes
Mac OS X Yes

QBzr - Qt-based frontend for Bazaar

QBzr is a cross platform, Qt-based front-end for Bazaar, providing GUI applications for many core bzr commands. In addition, it provides several special dialogs and helper commands. Equivalents for core bzr commands have the same names as CLI commands but with a prefix of “q”. QBzr requires Qt/PyQt 4.4.x or later to be installed.

Basic q-commands:

  • qadd - GUI for adding files or directories.
  • qannotate - Show the origin of each line in a file.
  • qbind - Convert the current branch into a checkout of the supplied branch.
  • qbranch - Create a new copy of a branch.
  • qcat - View the contents of a file as of a given revision.
  • qcommit - GUI for committing revisions.
  • qconflicts - Show conflicts.
  • qdiff - Show differences in working tree in a GUI window.
  • qexport - Export current or past revision to a destination directory or archive.
  • qinfo - Shows information about the current location.
  • qinit - Initializes a new branch or shared repository.
  • qlog - Show log of a repository, branch, file, or directory in a Qt window.
  • qmerge - Perform a three-way merge.
  • qplugins - Display information about installed plugins.
  • qpull - Turn this branch into a mirror of another branch.
  • qpush - Update a mirror of this branch.
  • qrevert - Revert changes files.
  • qsend - Mail or create a merge-directive for submitting changes.
  • qswitch - Set the branch of a checkout and update.
  • qtag - Edit tags.
  • qunbind - Convert the current checkout into a regular branch.
  • quncommit - Move the tip of a branch to an earlier revision.
  • qupdate - Update working tree with latest changes in the branch.
  • qversion - Show version/system information.

Hybrid dialogs:

  • qgetnew - Creates a new working tree (either a checkout or full branch).
  • qgetupdates - Fetches external changes into the working tree.

Additional commands:

  • qbrowse - Show inventory or working tree.
  • qconfig - Configure Bazaar and QBzr.
  • qrun - Run arbitrary bzr command.
  • qviewer - Simple file viewer.

Miscellaneous:

  • bug-url - print full URL to a specific bug, or open it in your browser.

bug-url

Purpose

Print full URL to a specific bug, or open it in your browser.

Usage

bzr bug-url BUG_ID

Options

--usage Show usage message and options.
--open Open the URL in a web browser.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qadd

Purpose

GUI for adding files or directories.

Usage

bzr qadd [SELECTED...]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qannotate

Purpose

Show the origin of each line in a file.

Usage

bzr qannotate FILENAME

Options

-v, --verbose Display more information.
--encoding=ARG Encoding of files content (default: utf-8).
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
--no-graph Shows the log with no graph.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-r ARG, --revision=ARG
 See “help revisionspec” for details.

Aliases

qann, qblame

qbind

Purpose

Convert the current branch into a checkout of the supplied branch.

Usage

bzr qbind [LOCATION]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Description

LOCATION is the branch where you want to bind your current branch.

qbranch

Purpose

Create a new copy of a branch.

Usage

bzr qbranch [FROM_LOCATION] [TO_LOCATION]

Options

-v, --verbose Display more information.
--bind Bind new branch to from location.
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-r ARG, --revision=ARG
 See “help revisionspec” for details.

qbrowse

Purpose

Show inventory or working tree.

Usage

bzr qbrowse [LOCATION]

Options

--usage Show usage message and options.
-r ARG, --revision=ARG
 See “help revisionspec” for details.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Aliases

qbw

qcat

Purpose

View the contents of a file as of a given revision.

Usage

bzr qcat FILENAME

Options

-v, --verbose Display more information.
--encoding=ARG Encoding of files content (default: utf-8).
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
--usage Show usage message and options.
--native Show file with native application.
-r ARG, --revision=ARG
 See “help revisionspec” for details.

Description

If no revision is nominated, the last revision is used.

qcommit

Purpose

GUI for committing revisions.

Usage

bzr qcommit [SELECTED...]

Options

-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-F MSGFILE, --file=MSGFILE
 Take commit message from this file.
--ui-mode Causes dialogs to wait after the operation is complete.
--usage Show usage message and options.
--file-encoding=ARG
 Encoding of commit message file content.
-m ARG, --message=ARG
 Description of the new revision.
--local Perform a local commit in a bound branch. Local commits are not pushed to the master branch until a normal commit is performed.
-h, --help Show help message.

Aliases

qci

qconfig

Purpose

Configure Bazaar and QBzr.

Usage

bzr qconfig

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Aliases

qconfigure

qconflicts

Purpose

Show conflicts.

Usage

bzr qconflicts

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Aliases

qresolve

qdiff

Purpose

Show differences in working tree in a GUI window.

Usage

bzr qdiff [FILE...]

Options

-A, --added Show diff for added files.
--old=ARG Branch/tree to compare from.
-v, --verbose Display more information.
--encoding=ARG Encoding of files content (default: utf-8).
-K, --deleted Show diff for deleted files.
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
-M, --modified Show diff for modified files.
-R, --renamed Show diff for renamed files.
--complete Show complete files.
--usage Show usage message and options.
--new=ARG Branch/tree to compare to.
-c ARG, --change=ARG
 Select changes introduced by the specified revision. See also “help revisionspec”.
-r ARG, --revision=ARG
 See “help revisionspec” for details.

Aliases

qdi

qexport

Purpose

Export current or past revision to a destination directory or archive.

Usage

bzr qexport [DEST] [BRANCH_OR_SUBDIR]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Description

DEST is the destination file or dir where the branch will be exported. If BRANCH_OR_SUBDIR is omitted then the branch containing the current working directory will be used.

qgetnew

Purpose

Creates a new working tree (either a checkout or full branch).

Usage

bzr qgetnew [LOCATION]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Aliases

qgetn

qgetupdates

Purpose

Fetches external changes into the working tree.

Usage

bzr qgetupdates [LOCATION]

Options

-e, --execute Causes dialogs to start the underlying action immediately without waiting for user input.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-h, --help Show help message.

Aliases

qgetu, qgetup

qinfo

Purpose

Shows information about the current location.

Usage

bzr qinfo [LOCATION]

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qinit

Purpose

Initializes a new branch or shared repository.

Usage

bzr qinit [LOCATION]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qlog

Purpose

Show log of a repository, branch, file, or directory in a Qt window.

Usage

bzr qlog [LOCATIONS...]

Options

-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
--no-graph Shows the log with no graph.
--show-trees Show working trees that have changes as nodes in the graph
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-h, --help Show help message.

Description

By default show the log of the branch containing the working directory.

If multiple files are speciffied, they must be from the same branch.

Examples

Log the current branch:

bzr qlog

Log of files:

bzr qlog foo.c bar.c

Log from different branches:

bzr qlog ~/branch1 ~/branch2

qmerge

Purpose

Perform a three-way merge.

Usage

bzr qmerge [LOCATION]

Options

--force Merge even if the destination tree has uncommitted changes.
-v, --verbose Display more information.
--remember Remember the specified location as a default.
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
-d ARG, --directory=ARG
 Branch to merge into, rather than the one containing the working directory.
--uncommitted Apply uncommitted changes from a working copy, instead of branch changes.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-r ARG, --revision=ARG
 See “help revisionspec” for details.

qplugins

Purpose

Show information about installed plugins.

Usage

bzr qplugins

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qpull

Purpose

Turn this branch into a mirror of another branch.

Usage

bzr qpull [LOCATION]

Options

--remember Remember the specified location as a default.
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
-d ARG, --directory=ARG
 Branch to pull into, rather than the one containing the working directory.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-r ARG, --revision=ARG
 See “help revisionspec” for details.
--overwrite Ignore differences between branches and overwrite unconditionally.
-v, --verbose Display more information.

qpush

Purpose

Update a mirror of this branch.

Usage

bzr qpush [LOCATION]

Options

--remember Remember the specified location as a default.
--create-prefix
 Create the path leading up to the branch if it does not already exist.
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
-d ARG, --directory=ARG
 Branch to push from, rather than the one containing the working directory.
--use-existing-dir
 By default push will fail if the target directory exists, but does not already have a control directory. This flag will allow push to proceed.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
--overwrite Ignore differences between branches and overwrite unconditionally.
-v, --verbose Display more information.

qrevert

Purpose

Revert changes files.

Usage

bzr qrevert [SELECTED...]

Options

-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
--no-backup Do not save backups of reverted files.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-h, --help Show help message.

qrun

Purpose

Run arbitrary bzr command.

Usage

bzr qrun [COMMAND] [PARAMETERS...]

Options

--category=ARG Initial category selection.
-e, --execute Causes dialogs to start the underlying action immediately without waiting for user input.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-d ARG, --directory=ARG
 Working directory.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-h, --help Show help message.

Description

If you wish to pass options to COMMAND, use -- beforehand so that the options aren’t treated as options to the qrun command itself. For example:

bzr qrun shelve -- --list

NOTE: you should use only canonical name of the COMMAND, not the alias.

Aliases

qcmd

qsend

Purpose

Mail or create a merge-directive for submitting changes.

Usage

bzr qsend [SUBMIT_BRANCH] [PUBLIC_BRANCH]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qswitch

Purpose

Set the branch of a checkout and update.

Usage

bzr qswitch [LOCATION]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qtag

Purpose

Edit tags.

Usage

bzr qtag [TAG_NAME]

Options

--force Replace existing tags.
-v, --verbose Display more information.
-h, --help Show help message.
-q, --quiet Only display errors and warnings.
-d ARG, --directory=ARG
 Branch in which to place the tag.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-r ARG, --revision=ARG
 See “help revisionspec” for details.
--delete Delete this tag rather than placing it.

qunbind

Purpose

Convert the current checkout into a regular branch.

Usage

bzr qunbind

Options

-e, --execute Causes dialogs to start the underlying action immediately without waiting for user input.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-h, --help Show help message.

quncommit

Purpose

Move the tip of a branch to an earlier revision.

Usage

bzr quncommit [LOCATION]

Options

--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qupdate

Purpose

Update working tree with latest changes in the branch.

Usage

bzr qupdate [DIRECTORY]

Options

-e, --execute Causes dialogs to start the underlying action immediately without waiting for user input.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
--usage Show usage message and options.
--ui-mode Causes dialogs to wait after the operation is complete.
-h, --help Show help message.

Aliases

qup

qversion

Purpose

Show version/system information.

Usage

bzr qversion

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

qviewer

Purpose

Simple file viewer.

Usage

bzr qviewer FILENAME

Options

--usage Show usage message and options.
--encoding=ARG Encoding of file content (default: utf-8).
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

See also

qcat