allow any string for rcParams['savefig.format'], leave validity check until runtime

mspacek · mspacek · commit bec0a4a794d1 · 2012-06-02T18:53:55.000-07:00
add docstring
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -1901,6 +1901,10 @@ def get_supported_filetypes(self):
         return self.filetypes
 
     def get_supported_filetypes_grouped(self):
+        """Return a dict of savefig file formats supported by this backend,
+        where the keys are a file type name, such as 'Joint Photographic
+        Experts Group', and the values are a list of filename extensions used
+        for that filetype, such as ['jpg', 'jpeg']."""
         groupings = {}
         for ext, name in self.filetypes.iteritems():
             groupings.setdefault(name, []).append(ext)
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
@@ -254,10 +254,6 @@ def validate_font_properties(s):
 def deprecate_savefig_extension(value):
     warnings.warn("savefig.extension is deprecated.  Use savefig.format instead.")
 
-validate_savefig_format = ValidateInStrings('savefig_format',
-                                            ['png', 'ps', 'pdf', 'svg'],
-                                            ignorecase=True)
-
 validate_ps_papersize = ValidateInStrings('ps_papersize',[
     'auto', 'letter', 'legal', 'ledger',
     'a0', 'a1', 'a2','a3', 'a4', 'a5', 'a6', 'a7', 'a8', 'a9', 'a10',
@@ -550,7 +546,7 @@ def __call__(self, s):
     'savefig.edgecolor'   : ['w', validate_color],  # edgecolor; white
     'savefig.orientation' : ['portrait', validate_orientation],  # edgecolor; white
     'savefig.extension'   : ['png', deprecate_savefig_extension], # what to add to extensionless filenames
-    'savefig.format'      : ['png', validate_savefig_format],
+    'savefig.format'      : ['png', str], # value checked by backend at runtime
 
     'tk.window_focus'    : [False, validate_bool],  # Maintain shell focus for TkAgg
     'tk.pythoninspect'   : [False, validate_tkpythoninspect],  # obsolete
