fix: cryptic error message + feat: # indicates comment column

[degenaro]

Types of changes

• Hot fix (emergency fix and release)
• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Documentation (change which affects the documentation site)
• Breaking change (fix or feature that would cause existing functionality to change)
• Release (develop -> main)

Quality assurance (all should be covered).

• My code follows the code style of this project.
• Documentation for my change is up to date?
• My PR meets testing requirements.
• All new and existing tests passed.
• All commits are signed-off.

Summary

fix - improved error message when csv cell contains bad data
feat - ignore column when heading starts with #

Key links:

• Sonar coverage

Before you merge

• Ensure it is a 'squash commit' if not a release.
• Ensure CI is currently passing
• Check sonar. If you are working for a fork a maintainer will reach out, if required.

[degenaro]

Help information for csv-to-oscal-cd task.

Purpose: From csv produce OSCAL component_definition file.


Configuration flags sit under [task.csv-to-oscal-cd]:
  title                = (required) the component definition title.
  version              = (required) the component definition version.
  csv-file             = (required) the path of the csv file. [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]
  required columns:      $$Component_Title
                         $$Component_Description
                         $$Component_Type
                         $$Rule_Id
                         $$Rule_Description (see note 1)
                         $$Profile_Source (see note 1)
                         $$Profile_Description (see note 1)
                         $$Control_Id_List (see note 1)
                         $$Namespace
  optional columns:      $Parameter_Id (see note 1)
                         $Parameter_Description (see note 1)
                         $Parameter_Value_Alternatives (see note 1)
                         $Parameter_Value_Default (see note 1)
                         $Check_Id (see note 2)
                         $Check_Description (see note 2)
  comment columns:       #Informational (see note 3)
  output-dir           = (required) the path of the output directory for synthesized OSCAL .json files.
  component-definition = (optional) the path of the existing component-definition OSCAL .json file.
  class.column-name    = (optional) the class to associate with the specified column name, e.g. class.Rule_Id = scc_class
  output-overwrite     = (optional) true [default] or false; replace existing output when true.
  validate-controls    = (optional) on, warn, or off [default]; validate controls exist in resolved profile.

Notes: [1] column is ignored for validation component type
       [2] column is required for validation component type
       [3] column name starting with # causes column to be ignored

[vikas-agarwal76]

LGTM