Hotfix 0.3.3 (#5)

- Fixed properties in audio source classes
- Fixed the lack of context manager methods for `URLAudioSource`
- Fixed missing `close` method for `URLAudioSource`
- Updated attributes of the 'AudioSourceBase`

Author: peachboy0

seaplayer_audio/_types.py

@@ -74,23 +74,6 @@ def __str__(self) -> str:
     def __repr__(self) -> str:
         return self.__str__()
 
-"""
-class URLOpenRetFile:
-    url: str
-    code: int
-    status: int
-    closed: bool
-    chunked: bool
-    will_close: bool
-    length: Optional[int]
-    def read(self, n: int=-1) -> bytes: ...
-    def read1(self, n: int=-1) -> bytes: ...
-    def readinto(self, b) -> int: ...
-    def readinto1(self, b) -> int: ...
-    def isclosed(self) -> bool: ...
-    def close(self) -> None: ...
-"""
-
 # ! URL Open Types
 
 class URLOpenRetType:

seaplayer_audio/audiosources/fileaudiosource.py

@@ -16,6 +16,7 @@
 # ^ File Audio Source (sync)
 
 class FileAudioSource(AudioSourceBase):
+    """A class for reading an audio stream in array format from a file."""
     __repr_attrs__ = ('name', ('metadata', True), 'samplerate', 'channels', 'subtype', 'endian', 'format', 'bitrate')
 
     def __init__(
@@ -55,31 +56,41 @@ def __del__(self) -> None:
 
     @property
     def samplerate(self) -> AudioSamplerate:
+        """The sampling rate of the audio source."""
         return self.sfio.samplerate
 
     @property
     def channels(self) -> AudioChannels:
+        """The number of channels of the audio source."""
         return self.sfio.channels
 
     @property
     def subtype(self) -> AudioSubType:
+        """The type of audio stream packaging."""
         return self.sfio.subtype
 
     @property
     def endian(self) -> AudioEndians:
+        """The type of byte sequence."""
         return self.sfio.endian
 
     @property
     def format(self) -> AudioFormat:
+        """Audio format for storing an audio stream."""
         return self.sfio.format
 
     @property
     def bitrate(self) -> Optional[int]:
-        try:    return self.minfo.info.bitrate
-        except: return None
+        """The speed of the audio stream in the format of bits per second."""
+        try:
+            if self.minfo.info.bitrate is not None:
+                return self.minfo.info.bitrate
+        except:
+            pass
 
     @property
     def closed(self) -> bool:
+        """Whether the IO will be closed after the context manager is closed."""
         return self.sfio.closed
 
     # ^ IO Methods Tests

seaplayer_audio/audiosources/urlaudiosource.py

@@ -1,13 +1,14 @@
 from numpy import ndarray
 from soundfile import SoundFile
-from typing_extensions import Optional
+from typing_extensions import Optional, Self
 from .._types import AudioSamplerate, AudioChannels, AudioSubType, AudioFormat, AudioEndians, AudioDType
 from ..base import AudioSourceBase
 from ..functions import get_mutagen_info, get_audio_metadata
 from .urlio import URLIO
 
 # ! URL Audio Source Class
 class URLAudioSource(AudioSourceBase):
+    """A class for reading an audio stream in array format by direct/indirect reference."""
     __repr_attrs__ = ('name', ('metadata', True), 'samplerate', 'channels', 'subtype', 'endian', 'format', 'bitrate')
 
     def __init__(
@@ -26,36 +27,60 @@ def __init__(
         self.sfio = SoundFile(self.urlio, 'r', samplerate, channels, subtype, endian, format, closefd=closefd)
         self.minfo = get_mutagen_info(self.name)
         self.metadata = get_audio_metadata(self.sfio, self.minfo)
+        self.closefd = closefd
+    
+    # ^ Dander Methods
+    
+    def __del__(self) -> None:
+        if self.closefd and (not self.closed):
+            self.close()
+    
+    def __enter__(self) -> Self:
+        return self
+    
+    def __exit__(self, *args: object) -> None:
+        if self.closefd and (not self.closed):
+            self.close()
 
     # ^ Propertyes
 
     @property
     def samplerate(self) -> AudioSamplerate:
+        """The sampling rate of the audio source."""
         return self.sfio.samplerate
 
     @property
     def channels(self) -> AudioChannels:
+        """The number of channels of the audio source."""
         return self.sfio.channels
 
     @property
     def subtype(self) -> AudioSubType:
+        """The type of audio stream packaging."""
         return self.sfio.subtype
 
     @property
     def endian(self) -> AudioEndians:
+        """The type of byte sequence."""
         return self.sfio.endian
 
     @property
     def format(self) -> AudioFormat:
+        """Audio format for storing an audio stream."""
         return self.sfio.format
 
     @property
     def bitrate(self) -> Optional[int]:
-        try:    return self.minfo.info.bitrate
-        except: return None
+        """The speed of the audio stream in the format of bits per second."""
+        try:
+            if self.minfo.info.bitrate is not None:
+                return self.minfo.info.bitrate
+        except:
+            pass
 
     @property
     def closed(self) -> bool:
+        """Whether the IO will be closed after the context manager is closed."""
         return self.sfio.closed
 
     # ^ IO Check Methods
@@ -126,4 +151,5 @@ def tell(self) -> int:
 
     def close(self) -> None:
         """Close the file. Can be called multiple times."""
-        return self.sfio.close()
+        self.urlio.close()
+        self.sfio.close()

seaplayer_audio/audiosources/urlio.py

@@ -107,7 +107,7 @@ def __next__(self) -> NoReturn:
     def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, *args) -> None:
+    def __exit__(self, *args: object) -> None:
         if self.closefd and (not self.closed):
             self.close()
 

seaplayer_audio/base/audiosource.py

@@ -3,7 +3,10 @@
 from io import IOBase
 from dataclasses import dataclass
 from typing_extensions import Any, Iterable, Optional, NoReturn, deprecated
-from .._types import Reprable
+from .._types import (
+    AudioSamplerate, AudioChannels, AudioSubType, AudioEndians, AudioFormat,
+    Reprable
+)
 
 # ! Audio Source Types
 
@@ -24,6 +27,18 @@ class AudioSourceMetadata:
 class AudioSourceBase(IOBase, Reprable):
     """Base class for working with audio sources (sync)."""
 
+    __slots__ = ('samplerate', 'channels', 'subtype', 'endian', 'format')
+    
+    # ^ Variables
+    
+    samplerate: AudioSamplerate
+    channels: AudioChannels
+    subtype: AudioSubType
+    endian: AudioEndians
+    format: AudioFormat
+    
+    # ^ Methods
+    
     @deprecated('!!! NOT IMPLEMENTED !!!')
     def __iter__(self) -> NoReturn:
         """!!! NOT IMPLEMENTED !!!"""