From ad9481fc1d7fe59500c265facf96bf41c68c5b7f Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:10:54 +0330 Subject: [PATCH 01/10] fix : rename __play_winmm to _play_winmm --- nava/functions.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index cf438be..2fa2b5c 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -69,7 +69,7 @@ def quoter(sound_path: str, *args: List[Any], **kwargs: Dict[str, Any]) -> Calla return quoter -def __play_winmm(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: +def _play_winmm(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: """ Play sound using the winmm MCI interface. @@ -356,7 +356,7 @@ def play(sound_path: str, async_mode: bool = False, loop: bool = False, engine: elif engine == Engine.WINSOUND: return __play_winsound(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.WINMM: - return __play_winmm(sound_path=sound_path, async_mode=async_mode, loop=loop) + return _play_winmm(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.AFPLAY: return __play_afplay(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.ALSA: From aebd2ff2cc954f8e94e6deed80b6d8f37eeeabff Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:11:42 +0330 Subject: [PATCH 02/10] fix : rename __play_winmm_flags to _play_winmm_flags --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 2fa2b5c..6ee6f37 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -81,7 +81,7 @@ def _play_winmm(sound_path: str, async_mode: bool = False, loop: bool = False) - sound_thread = NavaThread( loop, engine=Engine.WINMM, - target=__play_winmm_flags, + target=_play_winmm_flags, args=(sound_path, async_mode, loop), daemon=True ) @@ -90,10 +90,10 @@ def _play_winmm(sound_path: str, async_mode: bool = False, loop: bool = False) - params._play_threads_map[sound_id] = sound_thread return sound_id else: - __play_winmm_flags(sound_path, async_mode, loop) + _play_winmm_flags(sound_path, async_mode, loop) -def __play_winmm_flags(sound_path: str, async_mode: bool = False, loop: bool = False) -> None: +def _play_winmm_flags(sound_path: str, async_mode: bool = False, loop: bool = False) -> None: """ Play a sound using winmm with optional looping. From deef2454a23f6b01f2bd35f1cb513e1cf3a13878 Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:12:39 +0330 Subject: [PATCH 03/10] fix : rename __play_winsound to _play_winsound --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 6ee6f37..3f25c3c 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -155,7 +155,7 @@ def get_sound_status(alias: str) -> str: stop_sound(alias) -def __play_winsound(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: +def _play_winsound(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: """ Play sound using the winsound library. @@ -329,7 +329,7 @@ def __play_auto(sound_path: str, async_mode: bool = False, loop: bool = False) - sys_platform = sys.platform if sys_platform == "win32": - return __play_winsound(sound_path, async_mode, loop) + return _play_winsound(sound_path, async_mode, loop) elif sys_platform == "darwin": return __play_afplay(sound_path, async_mode, loop) else: @@ -354,7 +354,7 @@ def play(sound_path: str, async_mode: bool = False, loop: bool = False, engine: if engine == Engine.AUTO: return __play_auto(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.WINSOUND: - return __play_winsound(sound_path=sound_path, async_mode=async_mode, loop=loop) + return _play_winsound(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.WINMM: return _play_winmm(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.AFPLAY: From a049b20e36ce699439743476efbdd42d67cfdfd1 Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:13:21 +0330 Subject: [PATCH 04/10] fix : rename __play_winsound_flags to _play_winsound_flags --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 3f25c3c..8b070b5 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -173,7 +173,7 @@ def _play_winsound(sound_path: str, async_mode: bool = False, loop: bool = False if async_mode: sound_thread = NavaThread(loop, engine=Engine.WINSOUND, - target=__play_winsound_flags, + target=_play_winsound_flags, args=(sound_path, play_flags), daemon=True) sound_thread.start() @@ -181,10 +181,10 @@ def _play_winsound(sound_path: str, async_mode: bool = False, loop: bool = False params._play_threads_map[sound_id] = sound_thread return sound_id else: - __play_winsound_flags(sound_path, play_flags) + _play_winsound_flags(sound_path, play_flags) -def __play_winsound_flags(sound_path: str, flags: int) -> None: +def _play_winsound_flags(sound_path: str, flags: int) -> None: """ Play sound in winsound using different flags. From 294d0947139d96472827ae37ef3998cae4e5c248 Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:14:18 +0330 Subject: [PATCH 05/10] fix : rename __play_google_colab to _play_google_colab --- nava/functions.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 8b070b5..35a0b48 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -195,7 +195,7 @@ def _play_winsound_flags(sound_path: str, flags: int) -> None: winsound.PlaySound(sound_path, flags) -def __play_google_colab(sound_path: str) -> None: +def _play_google_colab(sound_path: str) -> None: """ Play sound in Google Colab Notebook. @@ -324,7 +324,7 @@ def __play_auto(sound_path: str, async_mode: bool = False, loop: bool = False) - """ env = detect_environment() if env == PythonEnvironment.COLAB: - return __play_google_colab(sound_path) + return _play_google_colab(sound_path) # we will add other notebook environment handlers in the future sys_platform = sys.platform From 5c47e4dc57d97b78cdad18577b6c68b3e3c6dd50 Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:15:06 +0330 Subject: [PATCH 06/10] fix : rename __play_alsa to _play_alsa --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 35a0b48..dc68305 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -207,7 +207,7 @@ def _play_google_colab(sound_path: str) -> None: @quote -def __play_alsa(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: +def _play_alsa(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: """ Play sound using ALSA. @@ -333,7 +333,7 @@ def __play_auto(sound_path: str, async_mode: bool = False, loop: bool = False) - elif sys_platform == "darwin": return __play_afplay(sound_path, async_mode, loop) else: - return __play_alsa(sound_path, async_mode, loop) + return _play_alsa(sound_path, async_mode, loop) @path_check @@ -360,7 +360,7 @@ def play(sound_path: str, async_mode: bool = False, loop: bool = False, engine: elif engine == Engine.AFPLAY: return __play_afplay(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.ALSA: - return __play_alsa(sound_path=sound_path, async_mode=async_mode, loop=loop) + return _play_alsa(sound_path=sound_path, async_mode=async_mode, loop=loop) except Exception: raise NavaBaseError(SOUND_FILE_PLAY_ERROR) From 7fa337eb8d4059667fa4f0ef7ee927b9883e86bf Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:16:05 +0330 Subject: [PATCH 07/10] fix : rename __play_proc_alsa to _play_proc_alsa --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index dc68305..d1f3e71 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -218,7 +218,7 @@ def _play_alsa(sound_path: str, async_mode: bool = False, loop: bool = False) -> if async_mode: sound_thread = NavaThread(loop, engine=Engine.ALSA, - target=__play_proc_alsa, + target=_play_proc_alsa, args=(sound_path,), daemon=True) sound_thread.start() @@ -227,13 +227,13 @@ def _play_alsa(sound_path: str, async_mode: bool = False, loop: bool = False) -> return sound_id else: while True: - proc = __play_proc_alsa(sound_path) + proc = _play_proc_alsa(sound_path) proc.wait() if not loop: break -def __play_proc_alsa(sound_path: str) -> subprocess.Popen: +def _play_proc_alsa(sound_path: str) -> subprocess.Popen: """ Create sound playing process using ALSA. From b16e283febb3006ebfa605f666ec8f0b3f55161d Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:16:45 +0330 Subject: [PATCH 08/10] fix : rename __play_afplay to _play_afplay --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index d1f3e71..93dcf16 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -249,7 +249,7 @@ def _play_proc_alsa(sound_path: str) -> subprocess.Popen: @quote -def __play_afplay(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: +def _play_afplay(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: """ Play sound using afplay. @@ -331,7 +331,7 @@ def __play_auto(sound_path: str, async_mode: bool = False, loop: bool = False) - if sys_platform == "win32": return _play_winsound(sound_path, async_mode, loop) elif sys_platform == "darwin": - return __play_afplay(sound_path, async_mode, loop) + return _play_afplay(sound_path, async_mode, loop) else: return _play_alsa(sound_path, async_mode, loop) @@ -358,7 +358,7 @@ def play(sound_path: str, async_mode: bool = False, loop: bool = False, engine: elif engine == Engine.WINMM: return _play_winmm(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.AFPLAY: - return __play_afplay(sound_path=sound_path, async_mode=async_mode, loop=loop) + return _play_afplay(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.ALSA: return _play_alsa(sound_path=sound_path, async_mode=async_mode, loop=loop) except Exception: From 7ba27027e0d8fd86027e2332aff4ea31cbe1f3c3 Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:17:26 +0330 Subject: [PATCH 09/10] fix : rename __play_proc_afplay to _play_proc_afplay --- nava/functions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 93dcf16..43d96ae 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -260,7 +260,7 @@ def _play_afplay(sound_path: str, async_mode: bool = False, loop: bool = False) if async_mode: sound_thread = NavaThread(loop, engine=Engine.AFPLAY, - target=__play_proc_afplay, + target=_play_proc_afplay, args=(sound_path,), daemon=True) sound_thread.start() @@ -269,13 +269,13 @@ def _play_afplay(sound_path: str, async_mode: bool = False, loop: bool = False) return sound_id else: while True: - proc = __play_proc_afplay(sound_path) + proc = _play_proc_afplay(sound_path) proc.wait() if not loop: break -def __play_proc_afplay(sound_path: str) -> subprocess.Popen: +def _play_proc_afplay(sound_path: str) -> subprocess.Popen: """ Create sound playing process using afplay. From 5c014f29ea5363dd08bff804cca73e3ecc313db9 Mon Sep 17 00:00:00 2001 From: sepandhaghighi Date: Sat, 1 Aug 2026 01:18:08 +0330 Subject: [PATCH 10/10] fix : rename __play_auto to _play_auto --- nava/functions.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/nava/functions.py b/nava/functions.py index 43d96ae..8c9f383 100644 --- a/nava/functions.py +++ b/nava/functions.py @@ -314,7 +314,7 @@ def path_checker(sound_path: str, *args: List[Any], **kwargs: Dict[str, Any]) -> return path_checker -def __play_auto(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: +def _play_auto(sound_path: str, async_mode: bool = False, loop: bool = False) -> Optional[int]: """ Play sound in automatic mode. @@ -352,7 +352,7 @@ def play(sound_path: str, async_mode: bool = False, loop: bool = False, engine: raise NavaBaseError(LOOP_ASYNC_ERROR) try: if engine == Engine.AUTO: - return __play_auto(sound_path=sound_path, async_mode=async_mode, loop=loop) + return _play_auto(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.WINSOUND: return _play_winsound(sound_path=sound_path, async_mode=async_mode, loop=loop) elif engine == Engine.WINMM: