Remove prototype files

[samanklesaria]

This PR removes the prototype directory from src along with prototype references in docs. It currently depends on, and should be merged after, the CUTC wrapper removal PR, because sphinx now breaks on our deprecation-wrapped classes. Specifically, we get the docs build error:

Traceback (most recent call last):
  File "/home/samanklesaria/world/.pixi/envs/default/lib/python3.12/site-packages/sphinx/util/inspect.py", line 461, in safe_getattr
    return getattr(obj, name, *defargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/samanklesaria/world/.pixi/envs/default/lib/python3.12/site-packages/torchaudio/models/decoder/__init__.py", line 42, in __getattr__
    item = dropping_support(orig_item)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/samanklesaria/world/.pixi/envs/default/lib/python3.12/site-packages/torchaudio/_internal/module_utils.py", line 84, in decorator
    wrapped = wrap_deprecated(func, f"{func.__module__}.{func.__name__}", direction, version=version, remove=remove)
TypeError: __type_params__ must be set to a tuple

This suggests that if we just merged the CUTC PR first, this error would go away. Note that this error does not show up in the CI: the CI logs for sphinx only show the exit code and suppress all other output.

[pytorch-bot]

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/audio/4048

• 📄 Preview Python docs built from this PR

Note: Links to docs will display an error until the docs builds have been completed.

❌ 8 New Failures

As of commit 370ad64 with merge base a645da6 ():

NEW FAILURES - The following jobs have failed:

• .github/workflows/bandit.yml (gh)
• .github/workflows/integration-test.yml (gh)
• .github/workflows/lint.yml (gh)
• .github/workflows/pr-labels.yml (gh)
• .github/workflows/unittest-macos-cpu.yml (gh)
• .github/workflows/unittest-windows-cpu.yml (gh)
• .github/workflows/unittest-windows-gpu.yml (gh)
• Build documentation / build / Build doc (gh)
  RuntimeError: Command docker exec -t 75ba5963b09d22c991c142e255f2d6343433531cad86395d23c981b21a472016 /exec failed with exit code 2

This comment was automatically generated by Dr. CI and updates every 15 minutes.

[NicolasHug]

let's not touch the examples folder for now. It would require more work. For example this pipeline_demo.py file is mentioned in the README, so removing it would mean updating the readme. We'll do that as follow-ups

[samanklesaria]

This example used functionality from the prototype files, which is why I included it here. If you like, I can do a separate PR for the examples first, before merging this one?

[samanklesaria]

Or should I just update the readme for this single demo first?

[NicolasHug]

approving to unblock but please see other comments

[samanklesaria]

As written elsewhere in the PR, I changed the target to be the no_wrap_ctc_decoder branch because sphinx recently became unable to handle the wrapped CUTC decoder. Unfortunately, this isn't quite sufficient for docs building to work yet. Now we're getting a large number of errors like libtorio.stream_writer.rst:40: ERROR: Unknown directive type "doxygenfunction". Of course, we're eventually going to delete these anyway. But my PR for removing libtorio is currently set up to depend on this one! What a mess! So here's an intermediate solution: I'll make a separate PR based on the no_wrap_cyc_decoder branch just to delete the documentation for libtorio rather than all of libtorio. This shouldn't break anything. This PR will depend on that one. And then the final libtorio removal PR will depend on this one.