UserList to tell apart user set empty list from undefined value

cylc/flow/parsec/validate.py

@@ -597,7 +597,7 @@ def strip_and_unquote_list(cls, keys, value):
             # allow trailing commas
             if values[-1] == '':
                 values = values[0:-1]
-        return values
+        return UserList(values)
 
     @classmethod
     def _unquoted_list_parse(cls, keys, value):
@@ -647,6 +647,11 @@ def __str__(self):
         return f'{self[0]} .. {self[1]}'
 
 
+class UserList(list):
+    # used to distinguish user defined, possibly empty list from automatic defaults
+    pass
+
+
 class CylcConfigValidator(ParsecValidator):
     """Type validator and coercer for Cylc configurations.
 

cylc/flow/workflow_events.py

@@ -24,6 +24,7 @@
 from cylc.flow.cfgspec.glbl_cfg import glbl_cfg
 from cylc.flow.hostuserutil import get_host, get_user
 from cylc.flow.log_diagnosis import run_reftest
+from cylc.flow.parsec.validate import UserList
 from cylc.flow.subprocctx import SubProcContext
 
 if TYPE_CHECKING:
@@ -235,7 +236,7 @@ def get_events_conf(
             glbl_cfg().get(['scheduler', 'mail'])
         ):
             value = getter.get(key)
-            if value is not None:
+            if value is not None and value != [] or isinstance(value, UserList):
                 return value
         return default
 

tests/unit/test_workflow_events.py

@@ -19,6 +19,7 @@
 
 import pytest
 
+from collections import UserList
 from types import SimpleNamespace
 
 from cylc.flow.workflow_events import (
@@ -32,11 +33,11 @@
     'key, workflow_cfg, glbl_cfg, expected',
     [
         ('handlers', True, True, ['stall']),
-        ('handlers', False, True, []),
-        ('handlers', False, False, []),
+        ('handlers', False, True, None),
+        ('handlers', False, False, None),
         ('mail events', True, True, []),
         ('mail events', False, True, ['abort']),
-        ('mail events', False, False, []),
+        ('mail events', False, False, None),
         ('from', True, True, 'docklands@railway'),
         ('from', False, True, 'highway@mixture'),
         ('from', False, False, None),
@@ -65,7 +66,7 @@ def test_get_events_handler(
     config = SimpleNamespace()
     config.cfg = {
         'scheduler': {
-            'events': {'handlers': ['stall'], 'mail events': []},
+            'events': {'handlers': ['stall'], 'mail events': UserList()},
             'mail': {'from': 'docklands@railway'},
         } if workflow_cfg else {'events': {}}
     }