docs: detailed fallback comments for NixOS/Python<3.9 compatibility

Author: rohandhar6824-debug

emulator/brainflow_emulator/cyton_windows.py

@@ -22,6 +22,9 @@ def get_isntaller():
         resource = files(__name__).joinpath('com0com').joinpath('setup_com0com_W7_x64_signed.exe')
         return str(resource)
     except (TypeError, AttributeError):
+        # Fallback for:
+        # 1. Python < 3.9 (importlib.resources.files not available)
+        # 2. NixOS/packaging edge cases where importlib.resources may not work
         import pkg_resources
         return pkg_resources.resource_filename(__name__, os.path.join('com0com', 'setup_com0com_W7_x64_signed.exe'))
 

emulator/brainflow_emulator/freeeeg32_windows.py

@@ -23,6 +23,9 @@ def get_isntaller():
         resource = files(__name__).joinpath('com0com').joinpath('setup_com0com_W7_x64_signed.exe')
         return str(resource)
     except (TypeError, AttributeError):
+        # Fallback for:
+        # 1. Python < 3.9 (importlib.resources.files not available)
+        # 2. NixOS/packaging edge cases where importlib.resources may not work
         import pkg_resources
         return pkg_resources.resource_filename(__name__, os.path.join('com0com', 'setup_com0com_W7_x64_signed.exe'))
 

emulator/brainflow_emulator/knightboard_windows.py

@@ -23,6 +23,9 @@ def get_isntaller():
         resource = files(__name__).joinpath('com0com').joinpath('setup_com0com_W7_x64_signed.exe')
         return str(resource)
     except (TypeError, AttributeError):
+        # Fallback for:
+        # 1. Python < 3.9 (importlib.resources.files not available)
+        # 2. NixOS/packaging edge cases where importlib.resources may not work
         import pkg_resources
         return pkg_resources.resource_filename(__name__, os.path.join('com0com', 'setup_com0com_W7_x64_signed.exe'))
 

python_package/brainflow/board_shim.py

@@ -21,7 +21,7 @@ class BoardIds(enum.IntEnum):
     STREAMING_BOARD = -2  #:
     SYNTHETIC_BOARD = -1  #:
     CYTON_BOARD = 0  #:
-    GANGLION_BOARD = 1  #:
+    GANGLION_BOARD = 1  #: 
     CYTON_DAISY_BOARD = 2  #:
     GALEA_BOARD = 3  #:
     GANGLION_WIFI_BOARD = 4  #:
@@ -177,6 +177,9 @@ def __init__(self):
             resource = files(__name__).joinpath(dll_path)
             full_path = str(resource)
         except (TypeError, AttributeError):
+            # Fallback for:
+            # 1. Python < 3.9 (importlib.resources.files not available)
+            # 2. NixOS/packaging edge cases where importlib.resources may not work
             import pkg_resources
             full_path = pkg_resources.resource_filename(__name__, dll_path)
         if os.path.isfile(full_path):

python_package/brainflow/data_filter.py

@@ -157,6 +157,9 @@ def __init__(self):
             resource = files(__name__).joinpath(dll_path)
             full_path = str(resource)
         except (TypeError, AttributeError):
+            # Fallback for:
+           # 1. Python < 3.9 (importlib.resources.files not available)
+           # 2. NixOS/packaging edge cases where importlib.resources may not work
             import pkg_resources
             full_path = pkg_resources.resource_filename(__name__, dll_path)
         if os.path.isfile(full_path):

python_package/brainflow/ml_model.py

@@ -82,6 +82,9 @@ def __init__(self):
             resource = files(__name__).joinpath(dll_path)
             full_path = str(resource)
         except (TypeError, AttributeError):
+            # Fallback for:
+           # 1. Python < 3.9 (importlib.resources.files not available)
+           # 2. NixOS/packaging edge cases where importlib.resources may not work
             import pkg_resources
             full_path = pkg_resources.resource_filename(__name__, dll_path)
         if os.path.isfile(full_path):