Remove kaldi io module (#4054)

Author: samanklesaria

CONTRIBUTING.md

@@ -61,7 +61,6 @@ Optional packages to install if you want to run related tests:
 - `librosa`
 - `requests`
 - `soundfile`
-- `kaldi_io`
 - `transformers`
 - `fairseq` (it has to be newer than `0.10.2`, so you will need to install from
   source. Commit `e6eddd80` is known to work.)

docs/source/index.rst

@@ -83,9 +83,6 @@ Optional Dependencies
 
   Required for performing text-to-speech with :ref:`Tacotron2`.
 
-* `kaldi_io <https://pypi.org/project/kaldi-io/>`__
-
-  Required to use :py:mod:`torchaudio.kaldi_io` module.
 
 
 Compatibility Matrix

docs/source/installation.rst

@@ -0,0 +1,23 @@
+.. py:module:: torchaudio.utils
+
+torchaudio.utils
+================
+
+``torchaudio.utils`` module contains utility functions to configure the global state of third party libraries.
+
+.. warning::
+    Starting with version 2.8, we are refactoring TorchAudio to transition it
+    into a maintenance phase. As a result:
+    - ``sox_utils`` are deprecated in 2.8 and will be removed in 2.9.
+    - The decoding and encoding capabilities of PyTorch for both audio and video
+      are being consolidated into TorchCodec.
+    Please see https://github.com/pytorch/audio/issues/3902 for more information.
+
+.. currentmodule:: torchaudio.utils
+
+.. autosummary::
+   :toctree: generated
+   :nosignatures:
+   :template: autosummary/utils.rst
+
+   sox_utils

docs/source/kaldi_io.rst

@@ -52,7 +52,6 @@ test:
     - torchaudio
     - torchaudio.io
     - torchaudio.datasets
-    - torchaudio.kaldi_io
     - torchaudio.sox_effects
     - torchaudio.transforms
 

docs/source/utils.rst

@@ -2,7 +2,6 @@
 torch
 
 # Optional runtime dependencies
-kaldi_io
 SoundFile
 
 # For build and test-time dependencies please refer to CONTRIBUTING.md