allow StringHTMLProperty in MultilinkHTMLProperty test to work

[roundup.git] / roundup / instance.py

diff --git a/roundup/instance.py b/roundup/instance.py
index d81b938841154d347418321ebcf22e28d2151eaf..b87334065a9589cf2a5cc1ea4235b3e752010c0c 100644 (file)
--- a/roundup/instance.py
+++ b/roundup/instance.py
@@ -1,24 +1,71 @@
-# $Id: instance.py,v 1.1 2001-08-05 07:43:52 richard Exp $
+#
+# Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/)
+# This module is free software, and you may redistribute it and/or modify
+# under the same terms as Python, so long as this copyright message and
+# disclaimer are retained in their original form.
+#
+# IN NO EVENT SHALL BIZAR SOFTWARE PTY LTD BE LIABLE TO ANY PARTY FOR
+# DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING
+# OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# BIZAR SOFTWARE PTY LTD SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
+# BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE.  THE CODE PROVIDED HEREUNDER IS ON AN "AS IS"
+# BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
+# SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
+# 
+# $Id: instance.py,v 1.9 2002-09-20 01:20:31 richard Exp $
+
+__doc__ = '''
+Tracker handling (open tracker).
 
-''' Currently this module provides one function: open. This function opens
-an instance.
+Currently this module provides one function: open. This function opens
+a tracker. Note that trackers used to be called instances.
 '''
 
-import imp
+import imp, os
+
+class TrackerError(Exception):
+    pass
 
 class Opener:
     def __init__(self):
         self.number = 0
-        self.instances = {}
+        self.trackers = {}
+
+    def open(self, tracker_home):
+        ''' Open the tracker.
+
+            Raise ValueError if the tracker home doesn't exist.
+        '''
+        # sanity check existence of tracker home
+        if not os.path.exists(tracker_home):
+            raise ValueError, 'no such directory: "%s"'%tracker_home
 
-    def open(self, instance_home):
-        if self.instances.has_key(instance_home):
-            return imp.load_package(self.instances[instance_home],
-                instance_home)
+        # sanity check tracker home contents
+        for reqd in 'config dbinit select_db interfaces'.split():
+            if not os.path.exists(os.path.join(tracker_home, '%s.py'%reqd)):
+                raise TrackerError, 'File "%s.py" missing from tracker '\
+                    'home "%s"'%(reqd, tracker_home)
+
+        if self.trackers.has_key(tracker_home):
+            return imp.load_package(self.trackers[tracker_home],
+                tracker_home)
         self.number = self.number + 1
-        modname = '_roundup_instance_%s'%self.number
-        self.instances[instance_home] = modname
-        return imp.load_package(modname, instance_home)
+        modname = '_roundup_tracker_%s'%self.number
+        self.trackers[tracker_home] = modname
+
+        # load the tracker
+        tracker = imp.load_package(modname, tracker_home)
+
+        # ensure the tracker has all the required bits
+        for required in 'config open init Client MailGW'.split():
+            if not hasattr(tracker, required):
+                raise TrackerError, \
+                    'Required tracker attribute "%s" missing'%required
+
+        return tracker
 
 opener = Opener()
 open = opener.open
@@ -27,8 +74,4 @@ del Opener
 del opener
 
 
-#
-# $Log: not supported by cvs2svn $
-#
-#
 # vim: set filetype=python ts=4 sw=4 et si