Update version to v0.4.0

Author: William McLendon

CHANGELOG.md

@@ -17,7 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 #### Todo (for Unreleased)
 -->
 
-## [0.4.0] <!-- YYYY-MM-DD --> [Unreleased]
+## [0.4.0] 2021-11-23
 #### Added
 #### Changed
 - Changes to `opt-set-cmake-var` behaviour:
@@ -33,10 +33,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - **bash** generated options that have a TYPE and `PARENT_SCOPE` are processed
     to generate the same _list_ string that would be generated by the matching
     `set()` operation (with the warning). (TRILFRAME-128)
-  - For **bash** generation, trigger a WARNING and DO NOT generate the `-D` CLI option 
-    if `opt-set-cmake-var` without `FORCE` is called on a CMake Cache variable that has 
+  - For **bash** generation, trigger a WARNING and DO NOT generate the `-D` CLI option
+    if `opt-set-cmake-var` without `FORCE` is called on a CMake Cache variable that has
     already been set. (TRILFRAME-120).
-  - For **bash** generation, trigger a WARNING and DO NOT generate the `-D` CLI option 
+  - For **bash** generation, trigger a WARNING and DO NOT generate the `-D` CLI option
     if `opt-set-cmake-var` is called on a non-cache CMake variable. (TRILFRAME-136)
   - For **bash** generation, always add a _TYPE_ to the `-D` CLI option. (TRILFRAME-136)
 - Revert(ish) the modifications from MR12 which removed the error when generating

SetProgramOptions.wpr

@@ -90,7 +90,7 @@ proj.launch-config = {loc('../../coding/pyExampleLib/configparser/configparser-e
         'ustom',
         (u'',
          'launch-5Gyw4cvA0PytPLLy'))}
-proj.main-file = loc('exec-example-SetProgramOptions.py')
+proj.main-file = loc('examples/example-01.py')
 testing.auto-test-file-specs = (('regex',
-                                 'unittests\\\\test_.*\\.py'),)
+                                 'src\\\\unittests\\\\test_.*\\.py'),)
 testing.test-framework = {None: ':internal pytest'}

src/setprogramoptions/SetProgramOptionsCMake.py

@@ -54,7 +54,7 @@
 #from textwrap import dedent
 
 # For type-hinting
-from typing import List, Set, Dict, Tuple, Optional, Iterable
+# from typing import List, Set, Dict, Tuple, Optional, Iterable
 
 try:                         # pragma: no cover
                              # @final decorator, requires Python 3.8.x
@@ -67,6 +67,7 @@
 import shlex
 
 from configparserenhanced import *
+from configparserenhanced import TypedProperty
 
 from .SetProgramOptions import SetProgramOptions
 from .SetProgramOptions import ExpandVarsInText
@@ -80,12 +81,20 @@
 # ===============================
 
 
-
 class ExpandVarsInTextCMake(ExpandVarsInText):
     """
     Extends ``ExpandVarsInText`` class to add in support for a ``CMAKE`` generator.
     """
 
+    # Typed Property `_bashgen_unhandled_cmake_var_eventtype`:
+    # sets the exception_control_event level for when an unresolved
+    # `CMake` var is encountered by the BASH generator.
+    _bashgen_unhandled_cmake_var_eventtype = \
+        TypedProperty.typed_property("_bashgen_unhandled_cmake_var_eventtype",
+                                     expected_type=str,
+                                     default="MINOR",
+                                     internal_type=str)
+
     def __init__(self):
         self.exception_control_level = 3
 
@@ -112,9 +121,10 @@ def _fieldhandler_BASH_CMAKE(self, field):
         else:
             # If self.exception_control_level is >= 4 then we'll raise the error
             # instead of sending a warning.
-            msg = f"Unhandled variable expansion for `{field.varname}` in a BASH file."
+            # Change this to `CATASTROPHIC` to always throw the error.
+            msg = f"Unresolved variable expansion for `{field.varname}` in a BASH file."
             msg += " CMake variables are only valid in a CMake fragment file."
-            self.exception_control_event("MINOR", ValueError, msg)
+            self.exception_control_event(self._bashgen_unhandled_cmake_var_eventtype, ValueError, msg)
             output = ""
         return output
 
@@ -331,7 +341,7 @@ def handler_initialize(self, section_name: str, handler_parameters) -> int:
     # ---------------------------------------------------------------
 
     @ConfigParserEnhanced.operation_handler
-    def _handler_opt_set_cmake_var(self, section_name, handler_parameters) -> int:
+    def _handler_opt_set_cmake_var(self, section_name: str, handler_parameters) -> int:
         """Handler for ``opt-set-cmake-var``
 
         Called By: ``configparserenhanced.ConfigParserEnhanced`` parser.