stig-gradle-plugin/com.stigway.gradle.settings/RepoDsl

RepoDsl

open class RepoDsl(repoName: String)

DSL for configuring a repo (source repository location).

Constructors

RepoDsl

constructor(repoName: String)

Properties

codeBrowser

var codeBrowser: CodeBrowser

Source-browser URL dialect. AUTO recognizes standard GitHub/GitLab hosts.

commit

var commit: String?

Explicit commit SHA for generated source-browse links, overriding the one read from the checkout's HEAD. Use when the local HEAD has not been pushed to the remote — e.g. after a local stig analysis branch commit. Set this to a commit (or branch/tag) that exists on the remote so that generated GitHub links resolve. Example: commit = "main" or a full SHA.

commitRef

var commitRef: CommitRef?

Strategy for choosing the commit used in source-browse links. When set, takes priority over commit:

editRef

var editRef: String?

Optional remote branch override for edit links. Normally inferred from the selected remote branch.

gitOwnership

var gitOwnership: GitOwnership

Git history used for provenance and source links, independently of root. CHECKOUT uses the nearest actual Git checkout: the enclosing monorepo for folders and git-subrepo imports, or the project's own repository for standalone clones and initialized submodules. SUBREPO_UPSTREAM explicitly uses the upstream and imported commit recorded in .gitrepo.

interfacePointLocation

var interfacePointLocation: String?

interfacePointMode

var interfacePointMode: InterfacePointMode?

remotePath

var remotePath: String?

Optional path inside remoteUrl that corresponds to this configured root. Set this when the local STIG repo root is a subdirectory of the remote repository, e.g. remotePath = "models/stig-project".

remoteUrl

var remoteUrl: String?

Explicit source-browse base URL for this repo, overriding the one derived from the checkout's git origin remote. Accepts the SSH (git@host:org/repo.git) or HTTPS form; it is normalized to https://host/org/repo. Set this when origin is absent, points elsewhere, or there are multiple remotes — e.g. remoteUrl = "git@example.com:source/source-repo.git". The commit still comes from the checkout's HEAD unless commit is set.

root

var root: String?

Path to the root of this repo, relative to settings.gradle.kts. Example: root = "../../../sourceRepo"

Functions

bazel

fun bazel(configure: BazelBuildDsl.() -> Unit)

Repo-level Bazel defaults inherited by groups and elements that use this repo. Put workspace-wide options here when every element from the repo should use the same Bazel workspace, startup flags, or action-input tracking policy.