6.1.4.5. Fossil

Integration with Fossil SCM

Support for Fossil SCM 2.x.

VCSIntegration Fossil supports line-by-line blame information.

Options

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

binary

binary : str = 'fossil'

Fossil command-line binary to use. The fossil binary is expected to be accessible via PATH or otherwise you have to specify an appropriate absolute path here which works for both, CI and Dashboard.

 

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.

 

branch

branch : str = 'trunk'

The fossil branch to track.

 

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_remote_url

sourceserver_remote_url : str | None = None

Remote fossil repository for the sourceserver to initially clone from (leave empty if you do not want to automatically clone the repository initially, e.g. if the dashboard runs on the same machine that holds the original fossil repository).

 

sourceserver_repository

sourceserver_repository : str = 'None (value must be set)'

Fossil repository clone (*.fossil file), accessible from the dashboard sourcecode server.

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.

 

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.