update

Author: Guanheng Zhang

torchtext/data/batch.py

@@ -20,7 +20,7 @@ class Batch(object):
 
     def __init__(self, data=None, dataset=None, device=None):
         """Create a Batch from a list of examples."""
-        warnings.warn('Batch class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Batch class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the replacement.', UserWarning)
         if data is not None:
             self.batch_size = len(data)
             self.dataset = dataset

torchtext/data/example.py

@@ -10,7 +10,7 @@ class Example(object):
     """
     @classmethod
     def fromJSON(cls, data, fields):
-        warnings.warn('Example class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Example class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         ex = cls()
         obj = json.loads(data)
 
@@ -49,7 +49,7 @@ def reducer(obj, key):
 
     @classmethod
     def fromdict(cls, data, fields):
-        warnings.warn('Example class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Example class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         ex = cls()
         for key, vals in fields.items():
             if key not in data:
@@ -65,7 +65,7 @@ def fromdict(cls, data, fields):
 
     @classmethod
     def fromCSV(cls, data, fields, field_to_index=None):
-        warnings.warn('Example class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Example class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         if field_to_index is None:
             return cls.fromlist(data, fields)
         else:
@@ -75,7 +75,7 @@ def fromCSV(cls, data, fields, field_to_index=None):
 
     @classmethod
     def fromlist(cls, data, fields):
-        warnings.warn('Example class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Example class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         ex = cls()
         for (name, field), val in zip(fields, data):
             if field is not None:
@@ -91,7 +91,7 @@ def fromlist(cls, data, fields):
 
     @classmethod
     def fromtree(cls, data, fields, subtrees=False):
-        warnings.warn('Example class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Example class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         try:
             from nltk.tree import Tree
         except ImportError:

torchtext/data/field.py

@@ -33,7 +33,7 @@ class RawField(object):
     """
 
     def __init__(self, preprocessing=None, postprocessing=None, is_target=False):
-        warnings.warn('Field class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Field class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         self.preprocessing = preprocessing
         self.postprocessing = postprocessing
         self.is_target = is_target
@@ -147,7 +147,7 @@ def __init__(self, sequential=True, use_vocab=True, init_token=None,
                  batch_first=False, pad_token="<pad>", unk_token="<unk>",
                  pad_first=False, truncate_first=False, stop_words=None,
                  is_target=False):
-        warnings.warn('Field class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Field class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         self.sequential = sequential
         self.use_vocab = use_vocab
         self.init_token = init_token
@@ -367,7 +367,7 @@ def numericalize(self, arr, device=None):
 
 class ReversibleField(Field):
     def __init__(self, **kwargs):
-        warnings.warn('Field class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Field class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         if kwargs.get('tokenize') is list:
             self.use_revtok = False
         else:
@@ -414,7 +414,7 @@ class SubwordField(ReversibleField):
     vocab_cls = SubwordVocab
 
     def __init__(self, **kwargs):
-        warnings.warn('Field class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Field class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         kwargs['tokenize'] = 'subword'
         if 'unk_token' not in kwargs:
             kwargs['unk_token'] = '�'
@@ -495,7 +495,7 @@ def __init__(self, nesting_field, use_vocab=True, init_token=None, eos_token=Non
                  postprocessing=None, tokenize=None, tokenizer_language='en',
                  include_lengths=False, pad_token='<pad>',
                  pad_first=False, truncate_first=False):
-        warnings.warn('Field class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Field class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         if isinstance(nesting_field, NestedField):
             raise ValueError('nesting field must not be another NestedField')
         if nesting_field.include_lengths:

torchtext/data/iterator.py

@@ -45,7 +45,7 @@ def __init__(self, dataset, batch_size, sort_key=None, device=None,
                  batch_size_fn=None, train=True,
                  repeat=False, shuffle=None, sort=None,
                  sort_within_batch=None):
-        warnings.warn('Iterator class will retire in 0.8.0 release', RuntimeWarning)
+        warnings.warn('Iterator class will retire in 0.8.0 release and stay in torchtext.legacy. See 0.7.0 release note for the repl    acement.', UserWarning)
         self.batch_size, self.train, self.dataset = batch_size, train, dataset
         self.batch_size_fn = batch_size_fn
         self.iterations = 0