Add rule category to rule meta data

The category information enables evaluation time computation of the
effective category of a rule. The effective category is determined by
the rule's category and a possible recategorization through a Guideline
Recategorization Plan.

The effective category will be used to determine how to handle a deviation applied to a query implementing the
rule.

Author: rvermeulen

cpp/common/src/codingstandards/cpp/exclusions/RuleMetadata.qll

@@ -8,13 +8,18 @@ newtype TQuery =
 
 class Query extends TQuery {
   string getQueryId() {
-    CPPRuleMetadata::isQueryMetadata(this, result, _) or
-    CRuleMetadata::isQueryMetadata(this, result, _)
+    CPPRuleMetadata::isQueryMetadata(this, result, _, _) or
+    CRuleMetadata::isQueryMetadata(this, result, _, _)
   }
 
   string getRuleId() {
-    CPPRuleMetadata::isQueryMetadata(this, _, result) or
-    CRuleMetadata::isQueryMetadata(this, _, result)
+    CPPRuleMetadata::isQueryMetadata(this, _, result, _) or
+    CRuleMetadata::isQueryMetadata(this, _, result, _)
+  }
+
+  string getCategory() {
+    CPPRuleMetadata::isQueryMetadata(this, _, _, result) or
+    CRuleMetadata::isQueryMetadata(this, _, _, result)
   }
 
   string toString() { result = getQueryId() }

cpp/common/src/codingstandards/cpp/exclusions/c/Banned.qll

@@ -24,158 +24,177 @@ newtype BannedQuery =
   TOctalConstantsUsedQuery() or
   TRestrictTypeQualifierUsedQuery()
 
-predicate isBannedQueryMetadata(Query query, string queryId, string ruleId) {
+predicate isBannedQueryMetadata(Query query, string queryId, string ruleId, string category) {
   query =
     // `Query` instance for the `doNotCallSystem` query
     BannedPackage::doNotCallSystemQuery() and
   queryId =
     // `@id` for the `doNotCallSystem` query
     "c/cert/do-not-call-system" and
-  ruleId = "ENV33-C"
+  ruleId = "ENV33-C" and
+  category = "rule"
   or
   query =
     // `Query` instance for the `commaOperatorShouldNotBeUsed` query
     BannedPackage::commaOperatorShouldNotBeUsedQuery() and
   queryId =
     // `@id` for the `commaOperatorShouldNotBeUsed` query
     "c/misra/comma-operator-should-not-be-used" and
-  ruleId = "RULE-12-3"
+  ruleId = "RULE-12-3" and
+  category = "advisory"
   or
   query =
     // `Query` instance for the `featuresOfStdarghUsed` query
     BannedPackage::featuresOfStdarghUsedQuery() and
   queryId =
     // `@id` for the `featuresOfStdarghUsed` query
     "c/misra/features-of-stdargh-used" and
-  ruleId = "RULE-17-1"
+  ruleId = "RULE-17-1" and
+  category = "required"
   or
   query =
     // `Query` instance for the `unionKeywordShouldNotBeUsed` query
     BannedPackage::unionKeywordShouldNotBeUsedQuery() and
   queryId =
     // `@id` for the `unionKeywordShouldNotBeUsed` query
     "c/misra/union-keyword-should-not-be-used" and
-  ruleId = "RULE-19-2"
+  ruleId = "RULE-19-2" and
+  category = "advisory"
   or
   query =
     // `Query` instance for the `standardLibraryTimeAndDateFunctionsUsed` query
     BannedPackage::standardLibraryTimeAndDateFunctionsUsedQuery() and
   queryId =
     // `@id` for the `standardLibraryTimeAndDateFunctionsUsed` query
     "c/misra/standard-library-time-and-date-functions-used" and
-  ruleId = "RULE-21-10"
+  ruleId = "RULE-21-10" and
+  category = "required"
   or
   query =
     // `Query` instance for the `standardHeaderFileTgmathhUsed` query
     BannedPackage::standardHeaderFileTgmathhUsedQuery() and
   queryId =
     // `@id` for the `standardHeaderFileTgmathhUsed` query
     "c/misra/standard-header-file-tgmathh-used" and
-  ruleId = "RULE-21-11"
+  ruleId = "RULE-21-11" and
+  category = "required"
   or
   query =
     // `Query` instance for the `exceptionHandlingFeaturesOfFenvhUsed` query
     BannedPackage::exceptionHandlingFeaturesOfFenvhUsedQuery() and
   queryId =
     // `@id` for the `exceptionHandlingFeaturesOfFenvhUsed` query
     "c/misra/exception-handling-features-of-fenvh-used" and
-  ruleId = "RULE-21-12"
+  ruleId = "RULE-21-12" and
+  category = "advisory"
   or
   query =
     // `Query` instance for the `systemOfStdlibhUsed` query
     BannedPackage::systemOfStdlibhUsedQuery() and
   queryId =
     // `@id` for the `systemOfStdlibhUsed` query
     "c/misra/system-of-stdlibh-used" and
-  ruleId = "RULE-21-21"
+  ruleId = "RULE-21-21" and
+  category = "required"
   or
   query =
     // `Query` instance for the `memoryAllocDeallocFunctionsOfStdlibhUsed` query
     BannedPackage::memoryAllocDeallocFunctionsOfStdlibhUsedQuery() and
   queryId =
     // `@id` for the `memoryAllocDeallocFunctionsOfStdlibhUsed` query
     "c/misra/memory-alloc-dealloc-functions-of-stdlibh-used" and
-  ruleId = "RULE-21-3"
+  ruleId = "RULE-21-3" and
+  category = "required"
   or
   query =
     // `Query` instance for the `standardHeaderFileUsedSetjmph` query
     BannedPackage::standardHeaderFileUsedSetjmphQuery() and
   queryId =
     // `@id` for the `standardHeaderFileUsedSetjmph` query
     "c/misra/standard-header-file-used-setjmph" and
-  ruleId = "RULE-21-4"
+  ruleId = "RULE-21-4" and
+  category = "required"
   or
   query =
     // `Query` instance for the `standardHeaderFileUsedSignalh` query
     BannedPackage::standardHeaderFileUsedSignalhQuery() and
   queryId =
     // `@id` for the `standardHeaderFileUsedSignalh` query
     "c/misra/standard-header-file-used-signalh" and
-  ruleId = "RULE-21-5"
+  ruleId = "RULE-21-5" and
+  category = "required"
   or
   query =
     // `Query` instance for the `standardLibraryInputoutputFunctionsUsed` query
     BannedPackage::standardLibraryInputoutputFunctionsUsedQuery() and
   queryId =
     // `@id` for the `standardLibraryInputoutputFunctionsUsed` query
     "c/misra/standard-library-inputoutput-functions-used" and
-  ruleId = "RULE-21-6"
+  ruleId = "RULE-21-6" and
+  category = "required"
   or
   query =
     // `Query` instance for the `atofAtoiAtolAndAtollOfStdlibhUsed` query
     BannedPackage::atofAtoiAtolAndAtollOfStdlibhUsedQuery() and
   queryId =
     // `@id` for the `atofAtoiAtolAndAtollOfStdlibhUsed` query
     "c/misra/atof-atoi-atol-and-atoll-of-stdlibh-used" and
-  ruleId = "RULE-21-7"
+  ruleId = "RULE-21-7" and
+  category = "required"
   or
   query =
     // `Query` instance for the `terminationFunctionsOfStdlibhUsed` query
     BannedPackage::terminationFunctionsOfStdlibhUsedQuery() and
   queryId =
     // `@id` for the `terminationFunctionsOfStdlibhUsed` query
     "c/misra/termination-functions-of-stdlibh-used" and
-  ruleId = "RULE-21-8"
+  ruleId = "RULE-21-8" and
+  category = "required"
   or
   query =
     // `Query` instance for the `terminationMacrosOfStdlibhUsed` query
     BannedPackage::terminationMacrosOfStdlibhUsedQuery() and
   queryId =
     // `@id` for the `terminationMacrosOfStdlibhUsed` query
     "c/misra/termination-macros-of-stdlibh-used" and
-  ruleId = "RULE-21-8"
+  ruleId = "RULE-21-8" and
+  category = "required"
   or
   query =
     // `Query` instance for the `bsearchAndQsortOfStdlibhUsed` query
     BannedPackage::bsearchAndQsortOfStdlibhUsedQuery() and
   queryId =
     // `@id` for the `bsearchAndQsortOfStdlibhUsed` query
     "c/misra/bsearch-and-qsort-of-stdlibh-used" and
-  ruleId = "RULE-21-9"
+  ruleId = "RULE-21-9" and
+  category = "required"
   or
   query =
     // `Query` instance for the `stdLibDynamicMemoryAllocationUsed` query
     BannedPackage::stdLibDynamicMemoryAllocationUsedQuery() and
   queryId =
     // `@id` for the `stdLibDynamicMemoryAllocationUsed` query
     "c/misra/std-lib-dynamic-memory-allocation-used" and
-  ruleId = "DIR-4-12"
+  ruleId = "DIR-4-12" and
+  category = "required"
   or
   query =
     // `Query` instance for the `octalConstantsUsed` query
     BannedPackage::octalConstantsUsedQuery() and
   queryId =
     // `@id` for the `octalConstantsUsed` query
     "c/misra/octal-constants-used" and
-  ruleId = "RULE-7-1"
+  ruleId = "RULE-7-1" and
+  category = "required"
   or
   query =
     // `Query` instance for the `restrictTypeQualifierUsed` query
     BannedPackage::restrictTypeQualifierUsedQuery() and
   queryId =
     // `@id` for the `restrictTypeQualifierUsed` query
     "c/misra/restrict-type-qualifier-used" and
-  ruleId = "RULE-8-14"
+  ruleId = "RULE-8-14" and
+  category = "required"
 }
 
 module BannedPackage {