Implement filename property; prep to get_/set_filename

Author: Ben Cipollini

nibabel/filebasedimages.py

@@ -229,12 +229,10 @@ def get_header(self):
                       DeprecationWarning, stacklevel=2)
         return self.header
 
-    def get_filename(self):
-        ''' Fetch the image filename
+    @property
+    def filename(self):
 
-        Parameters
-        ----------
-        None
+        ''' Fetch the image filename
 
         Returns
         -------
@@ -251,7 +249,8 @@ def get_filename(self):
         characteristic_type = self.files_types[0][0]
         return self.file_map[characteristic_type].filename
 
-    def set_filename(self, filename):
+    @filename.setter
+    def filename(self, filename):
         ''' Sets the files in the object from a given filename
 
         The different image formats may check whether the filename has
@@ -268,6 +267,23 @@ def set_filename(self, filename):
         '''
         self.file_map = self.__class__.filespec_to_file_map(filename)
 
+    def get_filename(self):
+        """ Get filename from image
+
+        Please use the `filename` property instead of `get_filename`; we will
+        deprecate this method in future versions of nibabel.
+        """
+        return self.filename
+
+    def set_filename(self, filename):
+        """ Set the image filename
+
+        Please use the `filename` property instead of `set_filename`; we will
+        deprecate this method in future versions of nibabel.
+        return self.filename
+        """
+        self.filename = filename
+
     @classmethod
     def from_filename(klass, filename):
         file_map = klass.filespec_to_file_map(filename)