modusa 0.4.24__py3-none-any.whl → 0.4.26__py3-none-any.whl

README.md

@@ -0,0 +1,64 @@
+# modusa
+
+[**modusa**](https://meluron-toolbox.github.io/modusa/) is a library with utility tools especially for audio signals.
+
+---
+
+## Installation
+
+> modusa is under active development. You can install the latest version via:
+
+```
+pip install modusa
+```
+
+---
+
+## Tests
+
+```
+pytest tests/
+```
+
+---
+
+## Status
+
+modusa is in **early alpha**. Expect rapid iteration, breaking changes, and big ideas.  
+If you like the direction, consider ⭐ starring the repo and opening issues or ideas.
+
+---
+
+## Few useful command
+
+To push doc changes
+```
+ghp-import -n -p -f docs/build/html
+```
+
+To create a dist
+```
+pdm build
+```
+
+To upload on pypi
+```
+twine upload dist/*
+```
+
+## About
+
+**modusa** is developed and maintained by [meluron](https://www.github.com/meluron),
+
+---
+
+## License
+
+MIT License. See `LICENSE` for details.
+
+---
+
+## Contributions
+
+Pull requests, ideas, and discussions are welcome!  
+No matter which domain you are in, if you work with any signal, we'd love your input.

modusa/__init__.py

@@ -8,4 +8,4 @@ from modusa.tools import play, convert, record, save
 from modusa.tools import download
 from modusa.tools import load, load_ann
 
-__version__ = "0.4.24"
+__version__ = "0.4.26"

modusa/tools/audio_loader.py

@@ -99,12 +99,19 @@ def load(path, sr=None, trim=None, ch=None):
 		File name stem.
 	"""
 	path = Path(path)
-	ffmpeg_exe = ffmpeg.get_ffmpeg_exe()
-	
-	yt = False # Is the path a youtube URL
 	
+	# If the path is a YouTube URL, turn on the yt flag
+	yt = False # By default, set to false
 	if ".youtube" in str(path):
 		yt = True
+	
+	# For local files, check if the audio exists
+	elif not path.exists():
+		raise FileExistsError(f"{path} does not exist")
+	
+	ffmpeg_exe = ffmpeg.get_ffmpeg_exe()
+	
+	if yt:
 		try:
 			path: Path = _load_audio_from_youtube(url=str(path))
 		except Exception as e:

modusa/tools/plotter.py

@@ -31,7 +31,7 @@ def _load_devanagari_font():
 	hindi_font = fm.FontProperties(fname=str(font_path))
 	
 	# Set as default rcParam
-	mpl.rcParams['font.family'] = hindi_font.get_name()
+	mpl.rcParams['font.family'] = [hindi_font.get_name(), 'DejaVu Sans'] # Fallback to DejaVu Sans
 
 #==============
 

{modusa-0.4.24.dist-info → modusa-0.4.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: modusa
-Version: 0.4.24
+Version: 0.4.26
 Summary: A modular signal analysis python library.
 Author-Email: Ankit Anand <ankit0.anand0@gmail.com>
 License: MIT

{modusa-0.4.24.dist-info → modusa-0.4.26.dist-info}/RECORD

@@ -1,9 +1,10 @@
-modusa-0.4.24.dist-info/METADATA,sha256=qrwiiHUmslIt8fc1mkR5DAE-EuzbZoUw420xOiSUH-4,1442
-modusa-0.4.24.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-modusa-0.4.24.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
-modusa-0.4.24.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
-modusa/.DS_Store,sha256=hHecruWmea5u7ITMSdq62sVVdvT2I5lTN20gTfD3Btk,8196
-modusa/__init__.py,sha256=vTF7-Nw0lF2RpE4WHCLtsb82szBayp4-ap9xAlJbTfQ,324
+LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
+README.md,sha256=Ybe2rcDecfSCiUpec2n7btQvgyi4R9JG0bfdwSWijWk,981
+modusa-0.4.26.dist-info/METADATA,sha256=ERGMu1mqdrLHK4UUTGRzAKO0iV4Ng-bPKXFhIef40U8,1442
+modusa-0.4.26.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
+modusa-0.4.26.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
+modusa-0.4.26.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
+modusa/__init__.py,sha256=kN-TMK9l5A0M6XHLRUBzQHaxFQXEncJBlUnWPcRFxE4,324
 modusa/config.py,sha256=bTqK4t00FZqERVITrxW_q284aDDJAa9aMSfFknfR-oU,280
 modusa/decorators.py,sha256=8zeNX_wE37O6Vp0ysR4-WCZaEL8mq8dyCF_I5DHOzks,5905
 modusa/devtools/generate_docs_source.py,sha256=UDflHsk-Yh9-3YJTVBzKL32y8hcxiRgAlFEBTMiDqwM,3301
@@ -45,13 +46,13 @@ modusa/tools/__init__.py,sha256=S7P1uYckyUdkha2UX9uj4P7mqpF6cc5SHqiW6NEupgs,342
 modusa/tools/_plotter_old.py,sha256=KGow7mihA2H1WNq7s5bpivhCgGo2qVIeDaO6iabpsrg,19294
 modusa/tools/ann_loader.py,sha256=m6Qu6jXnQ8LfUhKItoHSaHlGxUyzUJlGEyu4_50qJ8w,3099
 modusa/tools/audio_converter.py,sha256=415qBoPm2sBIuBSI7m1XBKm0AbmVmPydIPPr-uO8D3c,1778
-modusa/tools/audio_loader.py,sha256=nQl-E8xM1wdoYzZ3yGw25FJY8EogbqIZzPSMFt4Fv1E,3899
+modusa/tools/audio_loader.py,sha256=xmeodrJqJV5j9-lrUPk3W9-bdEA4-6RvTAn8pIErUN0,4084
 modusa/tools/audio_player.py,sha256=kyBUnodkOE9Ox-hKHkfPeGAQ1RPTddbZYXO1ezz6-9w,2494
 modusa/tools/audio_recorder.py,sha256=K_LGqsPdjTdf3figEZTSQLmgMzYWgz18HTO8C1j5fE4,2788
 modusa/tools/audio_saver.py,sha256=ldzfr_AydsHTnKbxmBLJblN-hLzTmOlppOm306xI4Ug,510
 modusa/tools/base.py,sha256=C0ESJ0mIfjjRlAkRbSetNtMoOfS6IrHBjexRp3l_Mh4,1293
 modusa/tools/math_ops.py,sha256=ZZ7U4DgqT7cOeE7_Lzi_Qq-48WYfwR9_osbZwTmE9eg,8690
-modusa/tools/plotter.py,sha256=RrELZYgnyUVhGzcNfpTvyZvVTmZ6dvQmN9YSQoUjmaM,30860
+modusa/tools/plotter.py,sha256=xXHibXf3cnFjgf_Hc_PM22yjC8W1s3160TjD7OTutcc,30903
 modusa/tools/youtube_downloader.py,sha256=hB_X8-7nOHXOlxg6vv3wyhBLoAsWyomrULP6_uCQL7s,1698
 modusa/utils/__init__.py,sha256=1oLL20yLB1GL9IbFiZD8OReDqiCpFr-yetIR6x1cNkI,23
 modusa/utils/config.py,sha256=cuGbqbovx5WDQq5rw3hIKcv3CnE5NttjacSOWnP1yu4,576
@@ -59,4 +60,5 @@ modusa/utils/excp.py,sha256=L9vhaGjKpv9viJYdmC9n5ndmk2GVbUBuFyZyhAQZmWY,906
 modusa/utils/logger.py,sha256=K0rsnObeNKCxlNeSnVnJeRhgfmob6riB2uyU7h3dDmA,571
 modusa/utils/np_func_cat.py,sha256=TyIFgRc6bARRMDnZxlVURO5Z0I-GWhxRONYyIv-Vwxs,1007
 modusa/utils/plot.py,sha256=s_vNdxvKfwxEngvJPgrF1PcmxZNnNaaXPViHWjyjJ-c,5335
-modusa-0.4.24.dist-info/RECORD,,
+pyproject.toml,sha256=nwae_IgI7Uw_mvCI9FDA6lwLWR9JldruIlD63x_XZio,1413
+modusa-0.4.26.dist-info/RECORD,,

modusa-0.4.26.dist-info/licenses/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 [Ankit Anand @meluron]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pyproject.toml

@@ -0,0 +1,85 @@
+[project]
+name = "modusa"
+dynamic = []
+description = "A modular signal analysis python library."
+authors = [
+    { name = "Ankit Anand", email = "ankit0.anand0@gmail.com" },
+]
+dependencies = [
+    "numpy>=2.2.6",
+    "matplotlib>=3.10.3",
+    "yt-dlp==2025.9.23",
+    "IPython>=9.5.0",
+    "sounddevice>=0.5.2",
+    "ipywidgets>=8.1.7",
+    "imageio-ffmpeg>=0.6.0",
+]
+requires-python = ">=3.11"
+readme = "README.md"
+version = "0.4.26"
+
+[project.license]
+text = "MIT"
+
+[project.scripts]
+modusa-dev = "modusa.devtools.main:main"
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.version]
+source = "file"
+path = "src/modusa/__init__.py"
+
+[tool.pdm.dev-dependencies]
+upload = [
+    "twine>=6.1.0",
+]
+test = [
+    "pytest>=8.4.0",
+]
+docs = [
+    "jupyter>=1.1.1",
+    "sphinx==8.1.2",
+    "sphinx-autodoc-typehints==2.1.0",
+    "sphinx-copybutton>=0.5.2",
+    "furo>=2024.8.6",
+    "nbsphinx==0.9.7",
+    "ghp-import>=2.1.0",
+]
+profiling = [
+    "snakeviz>=2.2.2",
+    "line-profiler>=4.2.0",
+]
+misc = [
+    "pandas>=2.3.0",
+    "rich>=14.0.0",
+    "questionary>=2.1.0",
+]
+
+[tool.pdm.package-dir]
+"" = "src"
+
+[tool.pdm.build]
+includes = [
+    "src",
+    "README.md",
+    "LICENSE.md",
+    "pyproject.toml",
+]
+excludes = [
+    "tests/**",
+    "**/.DS_Store",
+    "__pycache__/**",
+    "*.pyc",
+    "dist",
+    "build",
+    ".venv",
+    ".git",
+]
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"