Add by-hash support

[dak.git] / daklib / dak_exceptions.py

diff --git a/daklib/dak_exceptions.py b/daklib/dak_exceptions.py
old mode 100755 (executable)
new mode 100644 (file)
index 2fe87a0..e111afd
--- a/daklib/dak_exceptions.py
+++ b/daklib/dak_exceptions.py
@@ -1,10 +1,12 @@
 #!/usr/bin/env python
 
-""" Exception classes used in dak """
+"""
+Exception classes used in dak
 
-# Copyright (C) 2008  Mark Hymers <mhy@debian.org>
-
-################################################################################
+@contact: Debian FTP Master <ftpmaster@debian.org>
+@copyright: 2008  Mark Hymers <mhy@debian.org>
+@license: GNU General Public License version 2 or later
+"""
 
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -20,17 +22,19 @@
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
-################################################################################
 
 class DakError(Exception):
-    """Base class for all simple errors in this module.
-
-    Attributes:
+    """
+    Base class for all simple errors in this module.
 
-       message -- explanation of the error
     """
 
     def __init__(self, message=""):
+        """
+        @type message: string
+        @param message: explanation of the error
+
+        """
         Exception.__init__(self)
         self.args = str(message)
         self.message = str(message)
@@ -40,6 +44,7 @@ class DakError(Exception):
 
 __all__ = ['DakError']
 
+# If you want to have a new exception in dak, add it here.
 dakerrors = {
     "ParseMaintError":     """Exception raised for errors in parsing a maintainer field.""",
     "ParseChangesError":   """Exception raised for errors in parsing a changes file.""",
@@ -52,8 +57,13 @@ dakerrors = {
     "SendmailFailedError": """Exception raised when Sendmail invocation failed.""",
     "NoFreeFilenameError": """Exception raised when no alternate filename was found.""",
     "TransitionsError":    """Exception raised when transitions file can't be parsed.""",
-    "NoSourceFieldError":  """Exception raised - we cant find the source - wtf?"""
-}
+    "NoSourceFieldError":  """Exception raised - we cant find the source - wtf?""",
+    "MissingContents":     """Exception raised - we could not determine contents for this deb""",
+    "DBUpdateError":       """Exception raised - could not update the database""",
+    "ChangesUnicodeError": """Exception raised - changes file not properly utf-8 encoded""",
+    "AlreadyLockedError":  """Exception raised - package already locked by someone else""",
+    "CantGetLockError":    """Exception raised - lockfile already in use""",
+} #: All dak exceptions
 
 def construct_dak_exception(name, description):
     class Er(DakError):