stig-gradle-plugin/com.stigway.gradle.dsl/StigElementExtension

StigElementExtension

open class StigElementExtension : OverridableElementDsl

Per-module element configuration. Set in each module's build.gradle.kts:

stig {
    val sourceRepo by repos
    val source_activities by groups

    element {
        group = source_activities

        nativeBuild {
            bazel {
                target = "//activities/foo:foo"
            }
        }

        softwareUnderAnalysis {
            include(sourceRepo / "foo.cpp", sourceRepo / "bar.cpp")
        }

        analyzerInput {
            interfacePoints {
                entryPoint = "app::lifecycle::Activity::Step()"
                topicsFile = sourceRepo / "activities/foo/foo_topics.json"
                interfacePointsAnnotationFile = repos["model_repository"] /
                    "models/interface-definitions/Foo.json"
            }
        }
    }
}

Name, projectPath and moduleDir are derived from the module's location. The remaining fields are optional overrides on top of project-wide stigProject { ... } defaults (set in root build.gradle.kts).

Constructors

StigElementExtension

constructor()

Types

Companion

object Companion

Properties

asil

var asil: ASIL?

The configured safety integrity level. Distinct from per-symbol interface point ASILs; this is the element-wide declared level.

elementType

var elementType: ElementType?

Override of the parent element type, if needed.

failAt

var failAt: ProblemSeverity?

Single severity threshold for pipeline problems.

group

var group: StigGroupRef?

Group reference. Use val source_activities by groups in the stig { } block.

var id: String?

Canonical Highway model element ID, i.e. MetamodelEntity.id for the context viewpoint element. For a top-level Kotlin declaration such as val fusion = Fusion(), this is the dot-separated package plus reference name, for example app.activities.example_activity.context.fusion.

implementationClassName

var implementationClassName: String?

Upstream implementation class name (e.g. the C++ class the element wraps, like "FusionActivity"). Used by source-code analysis tasks that need to match LLVM symbols against the implementation type.

implementationDir

var implementationDir: String?

Override of the upstream element directory path relative to the repo root. When non-null, analysis tasks (stigAnalysisP7CollectMetrics, stigAnalysisP7CollectDescriptions, etc.) use this path instead of the auto-derived Gradle module path.

implementationNamespace

var implementationNamespace: String?

Upstream namespace where implementationClassName lives (e.g. "app::aeb::fusion_activity").

importEnabled

var importEnabled: Boolean?

Whether STIG import/synchronization is enabled.

interfacePointLocation

var interfacePointLocation: StigRepoFile?

Optional directory containing interface definition files.

interfacePointMode

var interfacePointMode: InterfacePointMode?

Legacy/static interface-point import mode. Prefer P5 interfacePoints { mode } for analysis.