Add removeable warnings indicating this is the last release (#2248)

Author: NicolasHug

torchtext/__init__.py

@@ -2,15 +2,25 @@
 
 from torch.hub import _get_torch_home
 
+_WARN = True
+_TORCHTEXT_DEPRECATION_MSG = (
+    "\n/!\ IMPORTANT WARNING ABOUT TORCHTEXT STATUS /!\ \n"
+    "Torchtext is deprecated and the last released version will be 0.18 (this one). "
+    "You can silence this warning by calling the following at the beginnign of your scripts: "
+    "`import torchtext; torchtext.disable_torchtext_deprecation_warning()`"
+)
+
+def disable_torchtext_deprecation_warning():
+    global _WARN
+    _WARN = False
+
 # the following import has to happen first in order to load the torchtext C++ library
 from torchtext import _extension  # noqa: F401
 
 _TEXT_BUCKET = "https://download.pytorch.org/models/text/"
 
 _CACHE_DIR = os.path.expanduser(os.path.join(_get_torch_home(), "text"))
 
-from . import data, datasets, prototype, functional, models, nn, transforms, utils, vocab, experimental
-
 try:
     from .version import __version__, git_version  # noqa: F401
 except ImportError:

torchtext/data/__init__.py

@@ -1,3 +1,9 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
+
 from .functional import (
     custom_replace,
     filter_wikipedia_xml,

torchtext/datasets/__init__.py

@@ -1,3 +1,9 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
+
 import importlib
 
 from .ag_news import AG_NEWS

torchtext/experimental/__init__.py

@@ -0,0 +1,4 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)

torchtext/functional.py

@@ -1,3 +1,8 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
 from typing import Any, List, Optional
 
 import torch

torchtext/models/__init__.py

@@ -1,2 +1,7 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
 from .roberta import *  # noqa: F401, F403
 from .t5 import *  # noqa: F401, F403

torchtext/nn/__init__.py

@@ -1 +1,6 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
 from .modules import *  # noqa: F401,F403

torchtext/prototype/__init__.py

@@ -1,3 +1,8 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
 from . import transforms
 
 __all__ = ["transforms"]

torchtext/transforms.py

@@ -1,3 +1,9 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
+
 import json
 import re
 from copy import deepcopy

torchtext/utils.py

@@ -1,3 +1,8 @@
+import warnings
+import torchtext
+if torchtext._WARN:
+    warnings.warn(torchtext._TORCHTEXT_DEPRECATION_MSG)
+
 import gzip
 import hashlib
 import logging