IS-Matrix-Forge 1.0.0.dev1__py3-none-any.whl

is_matrix_forge/__init__.py

@@ -0,0 +1,8 @@
+"""
+Author: Taylor B. tayjaybabee@gmail.com
+Date: 2025-04-15 09:15:25
+LastEditors: Taylor B. tayjaybabee@gmail.com
+LastEditTime: 2025-04-15 09:24:40
+FilePath: is_matrix_forge/__init__.py
+Description: 这是默认设置,可以在设置》工具》File Description中进行配置
+"""

is_matrix_forge/assets/__init__.py

@@ -0,0 +1,8 @@
+"""
+Author: Taylor B. tayjaybabee@gmail.com
+Date: 2025-04-15 09:15:37
+LastEditors: Taylor B. tayjaybabee@gmail.com
+LastEditTime: 2025-04-15 09:24:40
+FilePath: is_matrix_forge/assets/__init__.py
+Description: 这是默认设置,可以在设置》工具》File Description中进行配置
+"""

is_matrix_forge/assets/audio/__init__.py

@@ -0,0 +1,36 @@
+from chime import play_wav
+from .files import AUDIO_MAP as PLUG_ALERT_MAP
+from is_matrix_forge.log_engine import ROOT_LOGGER as PARENT_LOGGER
+
+
+MOD_LOGGER = PARENT_LOGGER.get_child('assets.audio')
+
+
+def alert(alert_type: str):
+    """
+    Plays an alert sound.
+
+    Parameters:
+        alert_type (str):
+            The type of alert sound to play.
+    """
+    log = MOD_LOGGER.get_child('alert')
+
+    if not isinstance(alert_type, str):
+        log.error(f'"alert_type" must be a string, not {type(alert_type)}')
+        raise TypeError(f'alert_type must be a string, not {type(alert_type)}')
+
+    alert_type = alert_type.lower().strip()
+    log.debug(f'Checking if alert_type is valid: {alert_type} ({type(alert_type)})')
+    if alert_type not in PLUG_ALERT_MAP:
+        log.error(f'Invalid alert_type: {alert_type}')
+        raise ValueError(f'alert_type must be one of {", ".join(PLUG_ALERT_MAP.keys())}')
+
+    log.debug(f'Playing alert sound: {alert_type}')
+    play_wav(PLUG_ALERT_MAP[alert_type])
+
+
+__all__ = [
+    'alert'
+]
+

is_matrix_forge/assets/audio/files/__init__.py

@@ -0,0 +1,53 @@
+from pathlib import Path
+from is_matrix_forge.log_engine import ROOT_LOGGER as PARENT_LOGGER
+
+
+MOD_LOGGER = PARENT_LOGGER.get_child('assets.audio.files')
+
+
+CUR_DIR = Path(__file__).parent.expanduser().resolve().absolute()
+MOD_LOGGER.debug(f'Audio files directory: {CUR_DIR}')
+
+AUDIO_MAP = {
+    'plugged': CUR_DIR / 'plugged.wav',
+    'unplugged': CUR_DIR / 'unplugged.wav'
+}
+
+
+def integrity_check():
+    """
+    Checks the integrity of the audio files.
+
+    Raises:
+        FileNotFoundError:
+            If any of the audio files are not found.
+
+    Returns:
+        None
+    """
+    log = MOD_LOGGER.get_child('integrity_check')
+    log.debug('Checking audio files...')
+    for file in AUDIO_MAP.values():
+        log.debug(f'Checking file: {file}')
+        if not file.exists():
+            log.error(f'File not found: {file}')
+            raise FileNotFoundError(f'Audio file not found: {file}')
+
+        if not file.is_file():
+            log.error(f'File is not a file: {file}')
+            raise FileNotFoundError(f'Audio file not found: {file}')
+
+    log.debug('Audio files are valid.')
+    return True
+
+
+MOD_LOGGER.debug('Performing integrity check...')
+
+if not integrity_check():
+    MOD_LOGGER.error('Audio files are invalid.')
+    raise FileNotFoundError('Audio files are invalid.')
+
+
+__all__ = [
+    'AUDIO_MAP',
+]