added docstring info about errors raised for About, Result, Score

Author: Chaim-Leib Halbert

tincan/about.py

@@ -45,7 +45,8 @@ def version(self):
         makes a 1-element list containing the string.
         :setter type: list | tuple | str | unicode | None
         :rtype: list
-
+        :raises ValueError if invalid version string provided
+        :raises TypeError if unsupported type is provided
         """
         return self._version
 

tincan/result.py

@@ -142,6 +142,8 @@ def duration(self):
 
         :setter type: :class:`datetime.timedelta` | unicode | str | int | float | dict | None
         :rtype: :class:`datetime.timedelta` | None
+        :raises ValueError if the provided data was a valid type, but could not be converted
+        :raises TypeError if unsupported type is provided
         """
         return self._duration
 
@@ -189,7 +191,7 @@ def response(self, value):
             e_type = ValueError if isinstance(value, (list, tuple)) else TypeError
             msg = (
                 "Property 'response' in a 'tincan.%s' object must be set with a "
-                "bytestring, string, unicode, list of ints 0-255, or None.\n\n" %
+                "string, unicode or None.\n\n" %
                 self.__class__.__name__,
             )
             msg += e.message
@@ -208,7 +210,7 @@ def extensions(self):
         this signifies the absence of this data.
         :setter type: :class:`tincan.extensions.Extensions` | dict | None
         :rtype: :class:`tincan.extensions.Extensions` | None
-
+        :raises TypeError if unsupported type is provided
         """
         return self._extensions
 
@@ -228,7 +230,7 @@ def extensions(self, value):
                     repr(value)
                 ))
             msg += e.message
-            e_type = TypeError if not isinstance(value, dict) else ValueError
+            e_type = ValueError if isinstance(value, dict) else TypeError
             raise e_type(msg)
 
     @extensions.deleter

tincan/score.py

@@ -48,7 +48,7 @@ def scaled(self):
         this signifies the absence of this data.
         :setter type: float | int | None
         :rtype: float | None
-
+        :raises TypeError if unsupported type is provided
         """
         return self._scaled
 
@@ -81,7 +81,7 @@ def raw(self):
         this signifies the absence of this data.
         :setter type: float | int | None
         :rtype: float | None
-
+        :raises TypeError if unsupported type is provided
         """
         return self._raw
 
@@ -114,7 +114,7 @@ def min(self):
         this signifies the absence of this data.
         :setter type: float | int | None
         :rtype: float | None
-
+        :raises TypeError if unsupported type is provided
         """
         return self._min
 
@@ -146,7 +146,7 @@ def max(self):
         this signifies the absence of this data.
         :setter type: float | int | None
         :rtype: float | None
-
+        :raises TypeError if unsupported type is provided
         """
         return self._max