hunterHearsPy 1.0.0__tar.gz → 1.0.1__tar.gz

{hunterhearspy-1.0.0 → hunterhearspy-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hunterHearsPy
-Version: 1.0.0
+Version: 1.0.1
 Summary: Audio processing.
 Keywords: 
 Author: Hunter Hogan
@@ -16,6 +16,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
+Requires-Dist: huntermakespy>=0.7.0
 Requires-Dist: numpy
 Requires-Dist: resampy
 Requires-Dist: scipy

{hunterhearspy-1.0.0 → hunterhearspy-1.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hunterHearsPy"
-version = "1.0.0"
+version = "1.0.1"
 description = "Audio processing."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -20,7 +20,14 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
   "Typing :: Typed",
 ]
-dependencies = ["numpy", "resampy", "scipy", "soundfile", "tqdm"]
+dependencies = [
+    "hunterMakesPy>=0.7.0",
+    "numpy",
+    "resampy",
+    "scipy",
+    "soundfile",
+    "tqdm",
+]
 optional-dependencies = { torch = ["torch"] }
 
 [project.urls]
@@ -32,7 +39,12 @@ Issues = "https://github.com/hunterhogan/hunterHearsPy/issues"
 Repository = "https://github.com/hunterhogan/hunterHearsPy.git"
 
 [dependency-groups]
-dev = ["astToolkit", "pytest-cov", "scipy-stubs", "types-resampy"]
+dev = [
+  "astToolkit",
+  "pytest-cov",
+  "scipy-stubs",
+  "types-resampy",
+]
 pytorch = ["torch==2.10.0", "torchaudio==2.10.0"]
 testing = ["pytest", "pytest-mock", "pytest-xdist", "torch"]
 

{hunterhearspy-1.0.0 → hunterhearspy-1.0.1}/src/hunterHearsPy/__init__.py

@@ -3,17 +3,19 @@ from __future__ import annotations
 
 from hunterHearsPy.theTypes import (
 	ArraySpectrograms as ArraySpectrograms, ArrayType as ArrayType, ArrayWaveforms as ArrayWaveforms,
-	NormalizationReverter as NormalizationReverter, ParametersShortTimeFFT as ParametersShortTimeFFT, ParametersSTFT as ParametersSTFT,
-	ParametersUniversal as ParametersUniversal, Spectrogram as Spectrogram, SpectrogramDtype as SpectrogramDtype, Waveform as Waveform,
-	WaveformDtype as WaveformDtype, WaveformMetadata as WaveformMetadata, WindowingFunction as WindowingFunction,
-	WindowingFunctionDtype as WindowingFunctionDtype, 个 as 个)
+	callableReturnsNDArray as callableReturnsNDArray, NormalizationReverter as NormalizationReverter,
+	ParametersShortTimeFFT as ParametersShortTimeFFT, ParametersSTFT as ParametersSTFT, ParametersUniversal as ParametersUniversal,
+	Spectrogram as Spectrogram, SpectrogramDtype as SpectrogramDtype, Waveform as Waveform, WaveformDtype as WaveformDtype,
+	WaveformMetadata as WaveformMetadata, WindowingFunction as WindowingFunction, WindowingFunctionDtype as WindowingFunctionDtype)
 
 # isort: split
 from hunterHearsPy.amplitude import normalizeArrayWaveforms as normalizeArrayWaveforms, normalizeWaveform as normalizeWaveform
-from hunterHearsPy.autoRevert import moveToAxisOfOperation as moveToAxisOfOperation
 from hunterHearsPy.clippingArrays import applyHardLimit as applyHardLimit, applyHardLimitComplexValued as applyHardLimitComplexValued
 from hunterHearsPy.windowingFunctions import cosineWings as cosineWings, equalPower as equalPower, halfsine as halfsine, tukey as tukey
 
+# isort: split
+from hunterHearsPy.autoRevert import moveToAxisOfOperation as moveToAxisOfOperation
+
 # isort: split
 from hunterHearsPy.ioAudio import (
 	getWaveformMetadata as getWaveformMetadata, lengthWindowingFunctionDEFAULT as lengthWindowingFunctionDEFAULT,
@@ -30,5 +32,5 @@ from contextlib import suppress
 
 with suppress(ModuleNotFoundError):  # noqa: RUF067
 	from hunterHearsPy.windowingFunctionsTensor import (
-		callableReturnsNDArray as callableReturnsNDArray, cosineWingsTensor as cosineWingsTensor, equalPowerTensor as equalPowerTensor,
-		halfsineTensor as halfsineTensor, tukeyTensor as tukeyTensor)
+		cosineWingsTensor as cosineWingsTensor, equalPowerTensor as equalPowerTensor, halfsineTensor as halfsineTensor,
+		tukeyTensor as tukeyTensor)

{hunterhearspy-1.0.0 → hunterhearspy-1.0.1}/src/hunterHearsPy/ioAudio.py

@@ -34,6 +34,7 @@ from __future__ import annotations
 from hunterHearsPy import (
 	ArraySpectrograms, ArrayWaveforms, halfsine, ParametersShortTimeFFT, ParametersSTFT, ParametersUniversal, Spectrogram, Waveform,
 	WaveformMetadata, WindowingFunction)
+from hunterMakesPy.filesystemToolkit import makeDirectorySafely
 from math import ceil as ceiling, log2 as log_base2
 from multiprocessing import set_start_method as multiprocessing_set_start_method
 from numpy import complex64, dtype, float32, floating, ndarray
@@ -48,7 +49,6 @@ if TYPE_CHECKING:
 	from collections.abc import Callable, Sequence
 	from os import PathLike
 
-# When to use multiprocessing.set_start_method https://github.com/hunterhogan/mapFolding/issues/6
 if __name__ == '__main__':
 	multiprocessing_set_start_method('spawn')
 
@@ -342,7 +342,7 @@ def writeWAV(pathFilename: str | PathLike[Any] | BinaryIO, waveform: Waveform, s
 	"""
 	if sampleRate is None:
 		sampleRate = parametersUniversal['sampleRate']
-	# makeDirsSafely(pathFilename)
+	makeDirectorySafely(pathFilename)
 	soundfile.write(file=pathFilename, data=waveform.T, samplerate=int(sampleRate), subtype='FLOAT', format='WAV')
 
 @overload  # stft 1 ndarray

{hunterhearspy-1.0.0 → hunterhearspy-1.0.1}/src/hunterHearsPy/theTypes.py

@@ -16,10 +16,10 @@ from typing import Any, TYPE_CHECKING, TypeAlias, TypedDict, TypeVar
 if TYPE_CHECKING:
 	from scipy.signal._short_time_fft import _FFTMode, _PadType, _ScaleTo
 
-个 = TypeVar('个', covariant=True)
 ArrayType = TypeVar('ArrayType', bound=ndarray[tuple[Any, ...], dtype[Any]], covariant=True)
 WindowingFunctionDtype: TypeAlias = floating[Any]
 WindowingFunction: TypeAlias = ndarray[tuple[int], dtype[WindowingFunctionDtype]]
+callableReturnsNDArray = TypeVar('callableReturnsNDArray', bound=Callable[..., WindowingFunction])
 WaveformDtype: TypeAlias = floating[Any]
 Waveform: TypeAlias = ndarray[tuple[int, int], dtype[WaveformDtype]]
 """Two-axes NumPy `ndarray` representing audio waveforms.

{hunterhearspy-1.0.0 → hunterhearspy-1.0.1}/src/hunterHearsPy/windowingFunctionsTensor.py

@@ -1,13 +1,12 @@
 """Create PyTorch tensor windowing functions."""
 from __future__ import annotations
 
-from collections.abc import Callable
-from hunterHearsPy import cosineWings, equalPower, halfsine, tukey, WindowingFunction
-from torch.types import Device
-from typing import Any, TypeVar
+from hunterHearsPy import callableReturnsNDArray, cosineWings, equalPower, halfsine, tukey
+from typing import Any, TYPE_CHECKING
 import torch
 
-callableReturnsNDArray = TypeVar('callableReturnsNDArray', bound=Callable[..., WindowingFunction])
+if TYPE_CHECKING:
+    from torch.types import Device
 
 def _convertToTensor(*arguments: Any, callableTarget: callableReturnsNDArray, device: Device, **keywordArguments: Any) -> torch.Tensor:
     arrayTarget = callableTarget(*arguments, **keywordArguments)
@@ -29,7 +28,7 @@ def cosineWingsTensor(lengthWindow: int, ratioTaper: float | None=None, device:
         Ratio of taper length to windowing-function length. The value must be between 0 and 1,
         inclusive.
     device : Device = torch.device(device='cpu')
-        PyTorch device for tensor allocation.
+        PyTorch device for `Tensor`.
 
     Returns
     -------
@@ -70,7 +69,7 @@ def equalPowerTensor(lengthWindow: int, ratioTaper: float | None=None, device: D
         Ratio of taper length to windowing-function length. The value must be between 0 and 1,
         inclusive.
     device : Device = torch.device(device='cpu')
-        PyTorch device for tensor allocation.
+        PyTorch device for `Tensor`.
 
     Returns
     -------
@@ -107,7 +106,7 @@ def halfsineTensor(lengthWindow: int, device: Device | None=None) -> torch.Tenso
     lengthWindow : int
         Total length of the windowing function.
     device : Device = torch.device(device='cpu')
-        PyTorch device for tensor allocation.
+        PyTorch device for `Tensor`.
 
     Returns
     -------
@@ -150,7 +149,7 @@ def tukeyTensor(lengthWindow: int, ratioTaper: float | None=None, device: Device
         Additional keyword arguments. `alpha` overrides `ratioTaper` when provided, matching SciPy's
         API.
     device : Device = torch.device(device='cpu')
-        PyTorch device for tensor allocation.
+        PyTorch device for `Tensor`.
 
     Returns
     -------