Document exceptions in docstrings (#765)

pynamodb/models.py

@@ -356,6 +356,8 @@ def __repr__(self):
     def delete(self, condition=None):
         """
         Deletes this object from dynamodb
+
+        :raises pynamodb.exceptions.DeleteError: If the record can not be deleted
         """
         args, kwargs = self._get_save_args(attributes=False, null_check=False)
         version_condition = self._handle_version_attribute(kwargs)
@@ -371,6 +373,8 @@ def update(self, actions, condition=None):
 
         :param actions: a list of Action updates to apply
         :param condition: an optional Condition on which to update
+        :raises ModelInstance.DoesNotExist: if the object to be updated does not exist
+        :raises pynamodb.exceptions.UpdateError: if the `condition` is not met
         """
         if not isinstance(actions, list) or len(actions) == 0:
             raise TypeError("the value of `actions` is expected to be a non-empty list")
@@ -411,6 +415,7 @@ def refresh(self, consistent_read=False):
         Retrieves this object's data from dynamodb and syncs this local object
 
         :param consistent_read: If True, then a consistent read is performed.
+        :raises ModelInstance.DoesNotExist: if the object to be updated does not exist
         """
         args, kwargs = self._get_save_args(attributes=False)
         kwargs.setdefault('consistent_read', consistent_read)
@@ -473,6 +478,7 @@ def get(cls,
         :param range_key: The range key of the desired item, only used when appropriate.
         :param consistent_read
         :param attributes_to_get
+        :raises ModelInstance.DoesNotExist: if the object to be updated does not exist
         """
         hash_key, range_key = cls._serialize_keys(hash_key, range_key)