6.2.11.1. Common Metric Options

Most metric rules have these options, so they are documented here for brevity.

base_view_name

base_view_name : str = 'Code Facts'

Name of the base view used to calculate/read the metric values.
 

excluded_node_types

excluded_node_types : set[str] = {'Namespace'}

Set of RFG node types for which metrics should not report violations.
 

hierarchy_edge_name

hierarchy_edge_name : str = 'Belongs_To'

Name of the edge used to traverse the hierarchy view.
 

hierarchy_view_name

hierarchy_view_name : str | None = None

Name of the hierarchy view used to propagate the metric values. If None, a view is chosen based on the base_view and the available views in the rfg.
 

macro_library_patterns

macro_library_patterns : set[bauhaus.analysis.config.GlobPattern] = set()

Globbing patterns for directory/file names for opaque macros in metrics. Requires opaque_macros = True to have an effect. If opaque_macros is set, but no macro_library_patterns are configured, all macro invocations are considered opaque.
 

opaque_macros

opaque_macros : bool = False

Ignore code from macro expansions when computing metrics.
 

propagate

propagate : bool = True

Propagate and aggregate the metric values (leaf values) up through the hierarchy view.
 

report_all_values

report_all_values : bool = False

If enabled, report all metric values, including those that do not violate the configured limits. If disabled, only violations will be reported. Note that the dashboard only ever displays metric violations, even if all metric values are reported and hence imported into the project database by using this option. This option is useful if you want to see non-violating metric values in other reports like CSV, JSON, or custom reports or visualizations.
 

report_propagated_values

report_propagated_values : ReportPropagatedMetricValues = 'root'

Report propagated metric values. 'no': Don't report (only store in RFG). 'root': Report value at hierarchy root node. 'all': Report all propagated values.
 

6.2.11.2. Option Types

These types are used by options listed above:

ReportPropagatedMetricValues

An enumeration.
 
  • no

  • root

  • all