RF: Rename serialize to to_bytes, add from_bytes

Author: effigies

nibabel/filebasedimages.py

@@ -260,6 +260,21 @@ def from_filename(klass, filename):
         file_map = klass.filespec_to_file_map(filename)
         return klass.from_file_map(file_map)
 
+    @classmethod
+    def from_bytes(klass, bstring):
+        """ Construct image from a byte string
+
+        Class method
+
+        Parameters
+        ----------
+        bstring : bytes
+            Byte string containing the on-disk representation of an image
+        """
+        bio = io.BytesIO(bstring)
+        file_map = self.make_file_map({'image': bio, 'header': bio})
+        return klass.from_file_map(file_map)
+
     @classmethod
     def from_file_map(klass, file_map):
         raise NotImplementedError
@@ -334,6 +349,24 @@ def to_filename(self, filename):
         self.file_map = self.filespec_to_file_map(filename)
         self.to_file_map()
 
+    def to_bytes(self):
+        """ Return a ``bytes`` object with the contents of the file that would
+        be written if the image were saved.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        bytes
+            Serialized image
+        """
+        bio = io.BytesIO()
+        file_map = self.make_file_map({'image': bio, 'header': bio})
+        self.to_file_map(file_map)
+        return bio.getvalue()
+
     @deprecate_with_version('to_filespec method is deprecated.\n'
                             'Please use the "to_filename" method instead.',
                             '1.0', '3.0')
@@ -512,21 +545,3 @@ def path_maybe_image(klass, filename, sniff=None, sniff_max=1024):
         if sniff is None or len(sniff[0]) < klass._meta_sniff_len:
             return False, sniff
         return klass.header_class.may_contain_header(sniff[0]), sniff
-
-    def serialize(self):
-        """ Return a ``bytes`` object with the contents of the file that would
-        be written if the image were saved.
-
-        Parameters
-        ----------
-        None
-
-        Returns
-        -------
-        bytes
-            Serialized image
-        """
-        bio = io.BytesIO()
-        file_map = self.make_file_map({'image': bio, 'header': bio})
-        self.to_file_map(file_map)
-        return bio.getvalue()