Clarified docstrings for get_decoders/encoders in image/media/model m…

…odules.

pyglet/image/codecs/__init__.py

@@ -99,6 +99,11 @@ def decode_animation(self, file, filename):
         """
         raise ImageDecodeException('This decoder cannot decode animations.')
 
+    def __repr__(self):
+        return "{0}{1}".format(self.__class__.__name__,
+                               self.get_animation_file_extensions() +
+                               self.get_file_extensions())
+
 
 class ImageEncoder(object):
     def get_file_extensions(self):
@@ -113,10 +118,13 @@ def encode(self, image, file, filename):
         """
         raise NotImplementedError()
 
+    def __repr__(self):
+        return "{0}{1}".format(self.__class__.__name__, self.get_file_extensions())
+
 
 def get_encoders(filename=None):
-    """Get an ordered list of encoders to attempt.  filename can be used
-    as a hint for the filetype.
+    """Get an ordered list of all encoders. If a `filename` is provided,
+    encoders supporting that extension will be ordered first in the list.
     """
     encoders = []
     if filename:
@@ -127,8 +135,8 @@ def get_encoders(filename=None):
 
 
 def get_decoders(filename=None):
-    """Get an ordered list of decoders to attempt.  filename can be used
-     as a hint for the filetype.
+    """Get an ordered list of all decoders. If a `filename` is provided,
+    decoders supporting that extension will be ordered first in the list.
     """
     decoders = []
     if filename:
@@ -139,8 +147,8 @@ def get_decoders(filename=None):
 
 
 def get_animation_decoders(filename=None):
-    """Get an ordered list of decoders to attempt.  filename can be used
-     as a hint for the filetype.
+    """Get an ordered list of all decoders. If a `filename` is provided,
+    decoders supporting that extension will be ordered first in the list.
     """
     decoders = []
     if filename:

pyglet/media/codecs/__init__.py

@@ -68,7 +68,7 @@ def __eq__(self, other):
         return self.__class__.__name__ == other.__class__.__name__
 
     def __repr__(self):
-        return "{0}{1}".format(self.__class__.__name__, tuple(self.get_file_extensions()))
+        return "{0}{1}".format(self.__class__.__name__, self.get_file_extensions())
 
 
 class MediaEncoder(object):
@@ -93,12 +93,12 @@ def __eq__(self, other):
         return self.__class__.__name__ == other.__class__.__name__
 
     def __repr__(self):
-        return "{0}{1}".format(self.__class__.__name__, tuple(self.get_file_extensions()))
+        return "{0}{1}".format(self.__class__.__name__, self.get_file_extensions())
 
 
 def get_decoders(filename=None):
-    """Get an ordered list of decoders to attempt.  filename can be used
-     as a hint for the filetype.
+    """Get an ordered list of all decoders. If a `filename` is provided,
+    decoders supporting that extension will be ordered first in the list.
     """
     decoders = []
     if filename:
@@ -109,8 +109,8 @@ def get_decoders(filename=None):
 
 
 def get_encoders(filename=None):
-    """Get an ordered list of encoders to attempt.  filename can be used
-    as a hint for the filetype.
+    """Get an ordered list of all encoders. If a `filename` is provided,
+    encoders supporting that extension will be ordered first in the list.
     """
     encoders = []
     if filename:

pyglet/model/codecs/__init__.py

@@ -63,6 +63,9 @@ def decode(self, file, filename, batch):
         """
         raise NotImplementedError()
 
+    def __repr__(self):
+        return "{0}{1}".format(self.__class__.__name__, self.get_file_extensions())
+
 
 class ModelEncoder(object):
     def get_file_extensions(self):
@@ -79,10 +82,13 @@ def encode(self, model, file, filename):
         """
         raise NotImplementedError()
 
+    def __repr__(self):
+        return "{0}{1}".format(self.__class__.__name__, self.get_file_extensions())
+
 
 def get_encoders(filename=None):
-    """Get an ordered list of encoders to attempt.  filename can be used
-    as a hint for the filetype.
+    """Get an ordered list of all encoders. If a `filename` is provided,
+    encoders supporting that extension will be ordered first in the list.
     """
     encoders = []
     if filename:
@@ -93,8 +99,8 @@ def get_encoders(filename=None):
 
 
 def get_decoders(filename=None):
-    """Get an ordered list of decoders to attempt.  filename can be used
-     as a hint for the filetype.
+    """Get an ordered list of all decoders. If a `filename` is provided,
+    decoders supporting that extension will be ordered first in the list.
     """
     decoders = []
     if filename: