6.1.4.8. Mercurial

Integration with Mercurial

Support for Mercurial.

VCSIntegration Mercurial supports line-by-line blame information.

Options

The following places define options that affect this rule: VCSIntegration, Project-GlobalOptions

binary

binary : str = 'hg'

Name of the VCS command-line binary.

 

blame_mode

blame_mode : BlameMode = 'all_authors'

If set to last_author_only, issues for code regions are only attributed to the author of the latest changes in that region. Otherwise, all authors of that code region are considered responsible.

 

encoding

encoding : str = 'utf-8'

Encoding of files in the repository.

 

rootpath

rootpath : bauhaus.analysis.config.ProjectRelativePath = '.'

Repository root for this VCS instance. If more than one VCS rule is activated, all their rootpath options have to be set differently. The value of rootpath must not be outside of /Project/directory for source code to be visible in the dashboard and for local_mode to work correctly.

 

skip_blame

skip_blame : bool = False

Does not run blame operations with this VCS if this option is set to true.

 

sourceserver_hgdir

sourceserver_hgdir : str | None = None

Additional Mercurial "bare" repository available to the dashboard sourcecode server (specify the directory containing the .hg subdirectory). Can be reflected from workspace.

If this option is unset, then the basename of the (explicitly configured or reflected) option sourceserver_remote_url is being used.

Any relative path (which is recommended) will be interpreted relative to the dashboard's configuration subfolder repositories.

Any absolute path will stay absolute unless you set ForceRelativeRepositoryPath to true inside dashboard2.config in which case absolute paths are also forced to be interpreted relative to the dashboard's configuration subfolder repositories.

In case you want to create the clone manually, it should be done with the command hg clone --noupdate.

ATTENTION: Do not configure your project directory here as otherwise you will lose your working copy.

 

sourceserver_remote_url

sourceserver_remote_url : str | None = None

Remote mercurial repository for the sourceserver to initially clone from. Can be reflected from workspace.

 

Option Types

These types are used by options listed above:

BlameMode

Enumeration of possible blame approaches for code regions.

 

all_authors

All authors of a code region are considered responsible.

last_author_only

Attribute issues only to the author of the latest change in the code region.