Add IO warning for functionality moved to TorchCodec (#3950)

Author: samanklesaria

src/torchaudio/__init__.py

@@ -1,4 +1,4 @@
-from torchaudio._internal.module_utils import dropping_support
+from torchaudio._internal.module_utils import dropping_io_support
 
 # Initialize extension and backend first
 from . import _extension  # noqa  # usort: skip
@@ -12,13 +12,13 @@
     set_audio_backend as _set_audio_backend,
 )
 
-AudioMetaData.__init__ = dropping_support(AudioMetaData.__init__)
-get_audio_backend = dropping_support(_get_audio_backend)
-info = dropping_support(_info)
-list_audio_backends = dropping_support(_list_audio_backends)
-load = dropping_support(_load)
-save = dropping_support(_save)
-set_audio_backend = dropping_support(_set_audio_backend)
+AudioMetaData.__init__ = dropping_io_support(AudioMetaData.__init__)
+get_audio_backend = dropping_io_support(_get_audio_backend)
+info = dropping_io_support(_info)
+list_audio_backends = dropping_io_support(_list_audio_backends)
+load = dropping_io_support(_load)
+save = dropping_io_support(_save)
+set_audio_backend = dropping_io_support(_set_audio_backend)
 
 from . import (  # noqa: F401
     compliance,

src/torchaudio/_internal/module_utils.py

@@ -100,6 +100,10 @@ def wrapped(*args, **kwargs):
     "As TorchAudio is no longer being actively developed, this function can no longer be supported."
     "See https://github.com/pytorch/audio/issues/3902 for more details.", version="2.9", remove=True)
 
+dropping_io_support = deprecated(
+    "This functionality has been superseded by `AudioDecoder` from the TorchCodec library."
+    "See https://github.com/pytorch/audio/issues/3902 for more details.", version="2.9", remove=True)
+
 def fail_with_message(message):
     """Generate decorator to give users message about missing TorchAudio extension."""
 

src/torchaudio/io/__init__.py

@@ -1,14 +1,14 @@
 from torio.io import CodecConfig, StreamingMediaDecoder as StreamReader, StreamingMediaEncoder as StreamWriter
-from torchaudio._internal.module_utils import dropping_support
+from torchaudio._internal.module_utils import dropping_io_support, dropping_support
 
 from ._effector import AudioEffector
 from ._playback import play_audio as _play_audio
 
-CodecConfig.__init__ = dropping_support(CodecConfig.__init__)
-StreamReader.__init__ = dropping_support(StreamReader.__init__)
-StreamWriter.__init__ = dropping_support(StreamWriter.__init__)
+CodecConfig.__init__ = dropping_io_support(CodecConfig.__init__)
+StreamReader.__init__ = dropping_io_support(StreamReader.__init__)
+StreamWriter.__init__ = dropping_io_support(StreamWriter.__init__)
 AudioEffector.__init__ = dropping_support(AudioEffector.__init__)
-play_audio = dropping_support(_play_audio)
+play_audio = dropping_io_support(_play_audio)
 
 
 __all__ = [