roundup/roundupdb.py

   1 #
   2 # Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/)
   3 # This module is free software, and you may redistribute it and/or modify
   4 # under the same terms as Python, so long as this copyright message and
   5 # disclaimer are retained in their original form.
   6 #
   7 # IN NO EVENT SHALL BIZAR SOFTWARE PTY LTD BE LIABLE TO ANY PARTY FOR
   8 # DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING
   9 # OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
  10 # POSSIBILITY OF SUCH DAMAGE.
  11 #
  12 # BIZAR SOFTWARE PTY LTD SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
  13 # BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  14 # FOR A PARTICULAR PURPOSE.  THE CODE PROVIDED HEREUNDER IS ON AN "AS IS"
  15 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
  16 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  17 #
  18 # $Id: roundupdb.py,v 1.49 2002-03-19 06:41:49 richard Exp $
  19
  20 __doc__ = """
  21 Extending hyperdb with types specific to issue-tracking.
  22 """
  23
  24 import re, os, smtplib, socket, copy, time, random
  25 import MimeWriter, cStringIO
  26 import base64, quopri, mimetypes
  27
  28 import hyperdb, date
  29
  30 # set to indicate to roundup not to actually _send_ email
  31 # this var must contain a file to write the mail to
  32 SENDMAILDEBUG = os.environ.get('SENDMAILDEBUG', '')
  33
  34 class DesignatorError(ValueError):
  35     pass
  36 def splitDesignator(designator, dre=re.compile(r'([^\d]+)(\d+)')):
  37     ''' Take a foo123 and return ('foo', 123)
  38     '''
  39     m = dre.match(designator)
  40     if m is None:
  41         raise DesignatorError, '"%s" not a node designator'%designator
  42     return m.group(1), m.group(2)
  43
  44
  45 def extractUserFromList(userClass, users):
  46     '''Given a list of users, try to extract the first non-anonymous user
  47        and return that user, otherwise return None
  48     '''
  49     if len(users) > 1:
  50         # make sure we don't match the anonymous or admin user
  51         for user in users:
  52             if user == '1': continue
  53             if userClass.get(user, 'username') == 'anonymous': continue
  54             # first valid match will do
  55             return user
  56         # well, I guess we have no choice
  57         return user[0]
  58     elif users:
  59         return users[0]
  60     return None
  61
  62 class Database:
  63     def getuid(self):
  64         """Return the id of the "user" node associated with the user
  65         that owns this connection to the hyperdatabase."""
  66         return self.user.lookup(self.journaltag)
  67
  68     def uidFromAddress(self, address, create=1):
  69         ''' address is from the rfc822 module, and therefore is (name, addr)
  70
  71             user is created if they don't exist in the db already
  72         '''
  73         (realname, address) = address
  74
  75         # try a straight match of the address
  76         user = extractUserFromList(self.user,
  77             self.user.stringFind(address=address))
  78         if user is not None: return user
  79
  80         # try the user alternate addresses if possible
  81         props = self.user.getprops()
  82         if props.has_key('alternate_addresses'):
  83             users = self.user.filter({'alternate_addresses': address},
  84                 [], [])
  85             user = extractUserFromList(self.user, users)
  86             if user is not None: return user
  87
  88         # try to match the username to the address (for local
  89         # submissions where the address is empty)
  90         user = extractUserFromList(self.user,
  91             self.user.stringFind(username=address))
  92
  93         # couldn't match address or username, so create a new user
  94         if create:
  95             return self.user.create(username=address, address=address,
  96                 realname=realname)
  97         else:
  98             return 0
  99
 100 _marker = []
 101 # XXX: added the 'creator' faked attribute
 102 class Class(hyperdb.Class):
 103     # Overridden methods:
 104     def __init__(self, db, classname, **properties):
 105         if (properties.has_key('creation') or properties.has_key('activity')
 106                 or properties.has_key('creator')):
 107             raise ValueError, '"creation", "activity" and "creator" are reserved'
 108         hyperdb.Class.__init__(self, db, classname, **properties)
 109         self.auditors = {'create': [], 'set': [], 'retire': []}
 110         self.reactors = {'create': [], 'set': [], 'retire': []}
 111
 112     def create(self, **propvalues):
 113         """These operations trigger detectors and can be vetoed.  Attempts
 114         to modify the "creation" or "activity" properties cause a KeyError.
 115         """
 116         if propvalues.has_key('creation') or propvalues.has_key('activity'):
 117             raise KeyError, '"creation" and "activity" are reserved'
 118         for audit in self.auditors['create']:
 119             audit(self.db, self, None, propvalues)
 120         nodeid = hyperdb.Class.create(self, **propvalues)
 121         for react in self.reactors['create']:
 122             react(self.db, self, nodeid, None)
 123         return nodeid
 124
 125     def set(self, nodeid, **propvalues):
 126         """These operations trigger detectors and can be vetoed.  Attempts
 127         to modify the "creation" or "activity" properties cause a KeyError.
 128         """
 129         if propvalues.has_key('creation') or propvalues.has_key('activity'):
 130             raise KeyError, '"creation" and "activity" are reserved'
 131         for audit in self.auditors['set']:
 132             audit(self.db, self, nodeid, propvalues)
 133         # Take a copy of the node dict so that the subsequent set
 134         # operation doesn't modify the oldvalues structure.
 135         try:
 136             # try not using the cache initially
 137             oldvalues = copy.deepcopy(self.db.getnode(self.classname, nodeid,
 138                 cache=0))
 139         except IndexError:
 140             # this will be needed if somone does a create() and set()
 141             # with no intervening commit()
 142             oldvalues = copy.deepcopy(self.db.getnode(self.classname, nodeid))
 143         hyperdb.Class.set(self, nodeid, **propvalues)
 144         for react in self.reactors['set']:
 145             react(self.db, self, nodeid, oldvalues)
 146
 147     def retire(self, nodeid):
 148         """These operations trigger detectors and can be vetoed.  Attempts
 149         to modify the "creation" or "activity" properties cause a KeyError.
 150         """
 151         for audit in self.auditors['retire']:
 152             audit(self.db, self, nodeid, None)
 153         hyperdb.Class.retire(self, nodeid)
 154         for react in self.reactors['retire']:
 155             react(self.db, self, nodeid, None)
 156
 157     def get(self, nodeid, propname, default=_marker, cache=1):
 158         """Attempts to get the "creation" or "activity" properties should
 159         do the right thing.
 160         """
 161         if propname == 'creation':
 162             journal = self.db.getjournal(self.classname, nodeid)
 163             if journal:
 164                 return self.db.getjournal(self.classname, nodeid)[0][1]
 165             else:
 166                 # on the strange chance that there's no journal
 167                 return date.Date()
 168         if propname == 'activity':
 169             journal = self.db.getjournal(self.classname, nodeid)
 170             if journal:
 171                 return self.db.getjournal(self.classname, nodeid)[-1][1]
 172             else:
 173                 # on the strange chance that there's no journal
 174                 return date.Date()
 175         if propname == 'creator':
 176             journal = self.db.getjournal(self.classname, nodeid)
 177             if journal:
 178                 name = self.db.getjournal(self.classname, nodeid)[0][2]
 179             else:
 180                 return None
 181             return self.db.user.lookup(name)
 182         if default is not _marker:
 183             return hyperdb.Class.get(self, nodeid, propname, default,
 184                 cache=cache)
 185         else:
 186             return hyperdb.Class.get(self, nodeid, propname, cache=cache)
 187
 188     def getprops(self, protected=1):
 189         """In addition to the actual properties on the node, these
 190         methods provide the "creation" and "activity" properties. If the
 191         "protected" flag is true, we include protected properties - those
 192         which may not be modified.
 193         """
 194         d = hyperdb.Class.getprops(self, protected=protected).copy()
 195         if protected:
 196             d['creation'] = hyperdb.Date()
 197             d['activity'] = hyperdb.Date()
 198             d['creator'] = hyperdb.Link("user")
 199         return d
 200
 201     #
 202     # Detector interface
 203     #
 204     def audit(self, event, detector):
 205         """Register a detector
 206         """
 207         l = self.auditors[event]
 208         if detector not in l:
 209             self.auditors[event].append(detector)
 210
 211     def react(self, event, detector):
 212         """Register a detector
 213         """
 214         l = self.reactors[event]
 215         if detector not in l:
 216             self.reactors[event].append(detector)
 217
 218
 219 class FileClass(Class):
 220     def create(self, **propvalues):
 221         ''' snaffle the file propvalue and store in a file
 222         '''
 223         content = propvalues['content']
 224         del propvalues['content']
 225         newid = Class.create(self, **propvalues)
 226         self.db.storefile(self.classname, newid, None, content)
 227         return newid
 228
 229     def get(self, nodeid, propname, default=_marker, cache=1):
 230         ''' trap the content propname and get it from the file
 231         '''
 232
 233         poss_msg = 'Possibly a access right configuration problem.'
 234         if propname == 'content':
 235             try:
 236                 return self.db.getfile(self.classname, nodeid, None)
 237             except IOError, (strerror):
 238                 # BUG: by catching this we donot see an error in the log.
 239                 return 'ERROR reading file: %s%s\n%s\n%s'%(
 240                         self.classname, nodeid, poss_msg, strerror)
 241         if default is not _marker:
 242             return Class.get(self, nodeid, propname, default, cache=cache)
 243         else:
 244             return Class.get(self, nodeid, propname, cache=cache)
 245
 246     def getprops(self, protected=1):
 247         ''' In addition to the actual properties on the node, these methods
 248             provide the "content" property. If the "protected" flag is true,
 249             we include protected properties - those which may not be
 250             modified.
 251         '''
 252         d = Class.getprops(self, protected=protected).copy()
 253         if protected:
 254             d['content'] = hyperdb.String()
 255         return d
 256
 257 class MessageSendError(RuntimeError):
 258     pass
 259
 260 class DetectorError(RuntimeError):
 261     pass
 262
 263 # XXX deviation from spec - was called ItemClass
 264 class IssueClass(Class):
 265
 266     # Overridden methods:
 267
 268     def __init__(self, db, classname, **properties):
 269         """The newly-created class automatically includes the "messages",
 270         "files", "nosy", and "superseder" properties.  If the 'properties'
 271         dictionary attempts to specify any of these properties or a
 272         "creation" or "activity" property, a ValueError is raised."""
 273         if not properties.has_key('title'):
 274             properties['title'] = hyperdb.String()
 275         if not properties.has_key('messages'):
 276             properties['messages'] = hyperdb.Multilink("msg")
 277         if not properties.has_key('files'):
 278             properties['files'] = hyperdb.Multilink("file")
 279         if not properties.has_key('nosy'):
 280             properties['nosy'] = hyperdb.Multilink("user")
 281         if not properties.has_key('superseder'):
 282             properties['superseder'] = hyperdb.Multilink(classname)
 283         Class.__init__(self, db, classname, **properties)
 284
 285     # New methods:
 286
 287     def addmessage(self, nodeid, summary, text):
 288         """Add a message to an issue's mail spool.
 289
 290         A new "msg" node is constructed using the current date, the user that
 291         owns the database connection as the author, and the specified summary
 292         text.
 293
 294         The "files" and "recipients" fields are left empty.
 295
 296         The given text is saved as the body of the message and the node is
 297         appended to the "messages" field of the specified issue.
 298         """
 299
 300     def sendmessage(self, nodeid, msgid, change_note):
 301         """Send a message to the members of an issue's nosy list.
 302
 303         The message is sent only to users on the nosy list who are not
 304         already on the "recipients" list for the message.
 305
 306         These users are then added to the message's "recipients" list.
 307         """
 308         users = self.db.user
 309         messages = self.db.msg
 310         files = self.db.file
 311
 312         # figure the recipient ids
 313         sendto = []
 314         r = {}
 315         recipients = messages.get(msgid, 'recipients')
 316         for recipid in messages.get(msgid, 'recipients'):
 317             r[recipid] = 1
 318
 319         # figure the author's id, and indicate they've received the message
 320         authid = messages.get(msgid, 'author')
 321
 322         # get the current nosy list, we'll need it
 323         nosy = self.get(nodeid, 'nosy')
 324
 325         # possibly send the message to the author, as long as they aren't
 326         # anonymous
 327         if (self.db.config.MESSAGES_TO_AUTHOR == 'yes' and
 328                 users.get(authid, 'username') != 'anonymous'):
 329             sendto.append(authid)
 330         r[authid] = 1
 331
 332         # now figure the nosy people who weren't recipients
 333         for nosyid in nosy:
 334             # Don't send nosy mail to the anonymous user (that user
 335             # shouldn't appear in the nosy list, but just in case they
 336             # do...)
 337             if users.get(nosyid, 'username') == 'anonymous':
 338                 continue
 339             # make sure they haven't seen the message already
 340             if not r.has_key(nosyid):
 341                 # send it to them
 342                 sendto.append(nosyid)
 343                 recipients.append(nosyid)
 344
 345         # no new recipients
 346         if not sendto:
 347             return
 348
 349         # determine the messageid and inreplyto of the message
 350         inreplyto = messages.get(msgid, 'inreplyto')
 351         messageid = messages.get(msgid, 'messageid')
 352         if not messageid:
 353             # this is an old message that didn't get a messageid, so
 354             # create one
 355             messageid = "<%s.%s.%s%s@%s>"%(time.time(), random.random(),
 356                 self.classname, nodeid, self.db.config.MAIL_DOMAIN)
 357             messages.set(msgid, messageid=messageid)
 358
 359         # update the message's recipients list
 360         messages.set(msgid, recipients=recipients)
 361
 362         # send an email to the people who missed out
 363         sendto = [users.get(i, 'address') for i in sendto]
 364         cn = self.classname
 365         title = self.get(nodeid, 'title') or '%s message copy'%cn
 366         # figure author information
 367         authname = users.get(authid, 'realname')
 368         if not authname:
 369             authname = users.get(authid, 'username')
 370         authaddr = users.get(authid, 'address')
 371         if authaddr:
 372             authaddr = ' <%s>'%authaddr
 373         else:
 374             authaddr = ''
 375
 376         # make the message body
 377         m = ['']
 378
 379         # put in roundup's signature
 380         if self.db.config.EMAIL_SIGNATURE_POSITION == 'top':
 381             m.append(self.email_signature(nodeid, msgid))
 382
 383         # add author information
 384         if len(self.get(nodeid,'messages')) == 1:
 385             m.append("New submission from %s%s:"%(authname, authaddr))
 386         else:
 387             m.append("%s%s added the comment:"%(authname, authaddr))
 388         m.append('')
 389
 390         # add the content
 391         m.append(messages.get(msgid, 'content'))
 392
 393         # add the change note
 394         if change_note:
 395             m.append(change_note)
 396
 397         # put in roundup's signature
 398         if self.db.config.EMAIL_SIGNATURE_POSITION == 'bottom':
 399             m.append(self.email_signature(nodeid, msgid))
 400
 401         # encode the content as quoted-printable
 402         content = cStringIO.StringIO('\n'.join(m))
 403         content_encoded = cStringIO.StringIO()
 404         quopri.encode(content, content_encoded, 0)
 405         content_encoded = content_encoded.getvalue()
 406
 407         # get the files for this message
 408         message_files = messages.get(msgid, 'files')
 409
 410         # create the message
 411         message = cStringIO.StringIO()
 412         writer = MimeWriter.MimeWriter(message)
 413         writer.addheader('Subject', '[%s%s] %s'%(cn, nodeid, title))
 414         writer.addheader('To', ', '.join(sendto))
 415         writer.addheader('From', '%s <%s>'%(authname,
 416             self.db.config.ISSUE_TRACKER_EMAIL))
 417         writer.addheader('Reply-To', '%s <%s>'%(self.db.config.INSTANCE_NAME,
 418             self.db.config.ISSUE_TRACKER_EMAIL))
 419         writer.addheader('MIME-Version', '1.0')
 420         if messageid:
 421             writer.addheader('Message-Id', messageid)
 422         if inreplyto:
 423             writer.addheader('In-Reply-To', inreplyto)
 424
 425         # add a uniquely Roundup header to help filtering
 426         writer.addheader('X-Roundup-Name', self.db.config.INSTANCE_NAME)
 427
 428         # attach files
 429         if message_files:
 430             part = writer.startmultipartbody('mixed')
 431             part = writer.nextpart()
 432             part.addheader('Content-Transfer-Encoding', 'quoted-printable')
 433             body = part.startbody('text/plain')
 434             body.write(content_encoded)
 435             for fileid in message_files:
 436                 name = files.get(fileid, 'name')
 437                 mime_type = files.get(fileid, 'type')
 438                 content = files.get(fileid, 'content')
 439                 part = writer.nextpart()
 440                 if mime_type == 'text/plain':
 441                     part.addheader('Content-Disposition',
 442                         'attachment;\n filename="%s"'%name)
 443                     part.addheader('Content-Transfer-Encoding', '7bit')
 444                     body = part.startbody('text/plain')
 445                     body.write(content)
 446                 else:
 447                     # some other type, so encode it
 448                     if not mime_type:
 449                         # this should have been done when the file was saved
 450                         mime_type = mimetypes.guess_type(name)[0]
 451                     if mime_type is None:
 452                         mime_type = 'application/octet-stream'
 453                     part.addheader('Content-Disposition',
 454                         'attachment;\n filename="%s"'%name)
 455                     part.addheader('Content-Transfer-Encoding', 'base64')
 456                     body = part.startbody(mime_type)
 457                     body.write(base64.encodestring(content))
 458             writer.lastpart()
 459         else:
 460             writer.addheader('Content-Transfer-Encoding', 'quoted-printable')
 461             body = writer.startbody('text/plain')
 462             body.write(content_encoded)
 463
 464         # now try to send the message
 465         if SENDMAILDEBUG:
 466             open(SENDMAILDEBUG, 'w').write('FROM: %s\nTO: %s\n%s\n'%(
 467                 self.db.config.ADMIN_EMAIL,', '.join(sendto),message.getvalue()))
 468         else:
 469             try:
 470                 # send the message as admin so bounces are sent there
 471                 # instead of to roundup
 472                 smtp = smtplib.SMTP(self.db.config.MAILHOST)
 473                 smtp.sendmail(self.db.config.ADMIN_EMAIL, sendto,
 474                     message.getvalue())
 475             except socket.error, value:
 476                 raise MessageSendError, \
 477                     "Couldn't send confirmation email: mailhost %s"%value
 478             except smtplib.SMTPException, value:
 479                 raise MessageSendError, \
 480                     "Couldn't send confirmation email: %s"%value
 481
 482     def email_signature(self, nodeid, msgid):
 483         ''' Add a signature to the e-mail with some useful information
 484         '''
 485         web = self.db.config.ISSUE_TRACKER_WEB + 'issue'+ nodeid
 486         email = '"%s" <%s>'%(self.db.config.INSTANCE_NAME,
 487             self.db.config.ISSUE_TRACKER_EMAIL)
 488         line = '_' * max(len(web), len(email))
 489         return '%s\n%s\n%s\n%s'%(line, email, web, line)
 490
 491     def generateCreateNote(self, nodeid):
 492         """Generate a create note that lists initial property values
 493         """
 494         cn = self.classname
 495         cl = self.db.classes[cn]
 496         props = cl.getprops(protected=0)
 497
 498         # list the values
 499         m = []
 500         l = props.items()
 501         l.sort()
 502         for propname, prop in l:
 503             value = cl.get(nodeid, propname, None)
 504             # skip boring entries
 505             if not value:
 506                 continue
 507             if isinstance(prop, hyperdb.Link):
 508                 link = self.db.classes[prop.classname]
 509                 if value:
 510                     key = link.labelprop(default_to_id=1)
 511                     if key:
 512                         value = link.get(value, key)
 513                 else:
 514                     value = ''
 515             elif isinstance(prop, hyperdb.Multilink):
 516                 if value is None: value = []
 517                 l = []
 518                 link = self.db.classes[prop.classname]
 519                 key = link.labelprop(default_to_id=1)
 520                 if key:
 521                     value = [link.get(entry, key) for entry in value]
 522                 value = ', '.join(value)
 523             m.append('%s: %s'%(propname, value))
 524         m.insert(0, '----------')
 525         m.insert(0, '')
 526         return '\n'.join(m)
 527
 528     def generateChangeNote(self, nodeid, oldvalues):
 529         """Generate a change note that lists property changes
 530         """
 531         cn = self.classname
 532         cl = self.db.classes[cn]
 533         changed = {}
 534         props = cl.getprops(protected=0)
 535
 536         # determine what changed
 537         for key in oldvalues.keys():
 538             if key in ['files','messages']: continue
 539             new_value = cl.get(nodeid, key)
 540             # the old value might be non existent
 541             try:
 542                 old_value = oldvalues[key]
 543                 if type(new_value) is type([]):
 544                     new_value.sort()
 545                     old_value.sort()
 546                 if new_value != old_value:
 547                     changed[key] = old_value
 548             except:
 549                 changed[key] = new_value
 550
 551         # list the changes
 552         m = []
 553         l = changed.items()
 554         l.sort()
 555         for propname, oldvalue in l:
 556             prop = props[propname]
 557             value = cl.get(nodeid, propname, None)
 558             if isinstance(prop, hyperdb.Link):
 559                 link = self.db.classes[prop.classname]
 560                 key = link.labelprop(default_to_id=1)
 561                 if key:
 562                     if value:
 563                         value = link.get(value, key)
 564                     else:
 565                         value = ''
 566                     if oldvalue:
 567                         oldvalue = link.get(oldvalue, key)
 568                     else:
 569                         oldvalue = ''
 570                 change = '%s -> %s'%(oldvalue, value)
 571             elif isinstance(prop, hyperdb.Multilink):
 572                 change = ''
 573                 if value is None: value = []
 574                 if oldvalue is None: oldvalue = []
 575                 l = []
 576                 link = self.db.classes[prop.classname]
 577                 key = link.labelprop(default_to_id=1)
 578                 # check for additions
 579                 for entry in value:
 580                     if entry in oldvalue: continue
 581                     if key:
 582                         l.append(link.get(entry, key))
 583                     else:
 584                         l.append(entry)
 585                 if l:
 586                     change = '+%s'%(', '.join(l))
 587                     l = []
 588                 # check for removals
 589                 for entry in oldvalue:
 590                     if entry in value: continue
 591                     if key:
 592                         l.append(link.get(entry, key))
 593                     else:
 594                         l.append(entry)
 595                 if l:
 596                     change += ' -%s'%(', '.join(l))
 597             else:
 598                 change = '%s -> %s'%(oldvalue, value)
 599             m.append('%s: %s'%(propname, change))
 600         if m:
 601             m.insert(0, '----------')
 602             m.insert(0, '')
 603         return '\n'.join(m)
 604
 605 #
 606 # $Log: not supported by cvs2svn $
 607 # Revision 1.48  2002/03/18 18:32:00  rochecompaan
 608 # All messages sent to the nosy list are now encoded as quoted-printable.
 609 #
 610 # Revision 1.47  2002/02/27 03:16:02  richard
 611 # Fixed a couple of dodgy bits found by pychekcer.
 612 #
 613 # Revision 1.46  2002/02/25 14:22:59  grubert
 614 #  . roundup db: catch only IOError in getfile.
 615 #
 616 # Revision 1.44  2002/02/15 07:08:44  richard
 617 #  . Alternate email addresses are now available for users. See the MIGRATION
 618 #    file for info on how to activate the feature.
 619 #
 620 # Revision 1.43  2002/02/14 22:33:15  richard
 621 #  . Added a uniquely Roundup header to email, "X-Roundup-Name"
 622 #
 623 # Revision 1.42  2002/01/21 09:55:14  rochecompaan
 624 # Properties in change note are now sorted
 625 #
 626 # Revision 1.41  2002/01/15 00:12:40  richard
 627 # #503340 ] creating issue with [asignedto=p.ohly]
 628 #
 629 # Revision 1.40  2002/01/14 22:21:38  richard
 630 # #503353 ] setting properties in initial email
 631 #
 632 # Revision 1.39  2002/01/14 02:20:15  richard
 633 #  . changed all config accesses so they access either the instance or the
 634 #    config attriubute on the db. This means that all config is obtained from
 635 #    instance_config instead of the mish-mash of classes. This will make
 636 #    switching to a ConfigParser setup easier too, I hope.
 637 #
 638 # At a minimum, this makes migration a _little_ easier (a lot easier in the
 639 # 0.5.0 switch, I hope!)
 640 #
 641 # Revision 1.38  2002/01/10 05:57:45  richard
 642 # namespace clobberation
 643 #
 644 # Revision 1.37  2002/01/08 04:12:05  richard
 645 # Changed message-id format to "<%s.%s.%s%s@%s>" so it complies with RFC822
 646 #
 647 # Revision 1.36  2002/01/02 02:31:38  richard
 648 # Sorry for the huge checkin message - I was only intending to implement #496356
 649 # but I found a number of places where things had been broken by transactions:
 650 #  . modified ROUNDUPDBSENDMAILDEBUG to be SENDMAILDEBUG and hold a filename
 651 #    for _all_ roundup-generated smtp messages to be sent to.
 652 #  . the transaction cache had broken the roundupdb.Class set() reactors
 653 #  . newly-created author users in the mailgw weren't being committed to the db
 654 #
 655 # Stuff that made it into CHANGES.txt (ie. the stuff I was actually working
 656 # on when I found that stuff :):
 657 #  . #496356 ] Use threading in messages
 658 #  . detectors were being registered multiple times
 659 #  . added tests for mailgw
 660 #  . much better attaching of erroneous messages in the mail gateway
 661 #
 662 # Revision 1.35  2001/12/20 15:43:01  rochecompaan
 663 # Features added:
 664 #  .  Multilink properties are now displayed as comma separated values in
 665 #     a textbox
 666 #  .  The add user link is now only visible to the admin user
 667 #  .  Modified the mail gateway to reject submissions from unknown
 668 #     addresses if ANONYMOUS_ACCESS is denied
 669 #
 670 # Revision 1.34  2001/12/17 03:52:48  richard
 671 # Implemented file store rollback. As a bonus, the hyperdb is now capable of
 672 # storing more than one file per node - if a property name is supplied,
 673 # the file is called designator.property.
 674 # I decided not to migrate the existing files stored over to the new naming
 675 # scheme - the FileClass just doesn't specify the property name.
 676 #
 677 # Revision 1.33  2001/12/16 10:53:37  richard
 678 # take a copy of the node dict so that the subsequent set
 679 # operation doesn't modify the oldvalues structure
 680 #
 681 # Revision 1.32  2001/12/15 23:48:35  richard
 682 # Added ROUNDUPDBSENDMAILDEBUG so one can test the sendmail method without
 683 # actually sending mail :)
 684 #
 685 # Revision 1.31  2001/12/15 19:24:39  rochecompaan
 686 #  . Modified cgi interface to change properties only once all changes are
 687 #    collected, files created and messages generated.
 688 #  . Moved generation of change note to nosyreactors.
 689 #  . We now check for changes to "assignedto" to ensure it's added to the
 690 #    nosy list.
 691 #
 692 # Revision 1.30  2001/12/12 21:47:45  richard
 693 #  . Message author's name appears in From: instead of roundup instance name
 694 #    (which still appears in the Reply-To:)
 695 #  . envelope-from is now set to the roundup-admin and not roundup itself so
 696 #    delivery reports aren't sent to roundup (thanks Patrick Ohly)
 697 #
 698 # Revision 1.29  2001/12/11 04:50:49  richard
 699 # fixed the order of the blank line and '-------' line
 700 #
 701 # Revision 1.28  2001/12/10 22:20:01  richard
 702 # Enabled transaction support in the bsddb backend. It uses the anydbm code
 703 # where possible, only replacing methods where the db is opened (it uses the
 704 # btree opener specifically.)
 705 # Also cleaned up some change note generation.
 706 # Made the backends package work with pydoc too.
 707 #
 708 # Revision 1.27  2001/12/10 21:02:53  richard
 709 # only insert the -------- change note marker if there is a change note
 710 #
 711 # Revision 1.26  2001/12/05 14:26:44  rochecompaan
 712 # Removed generation of change note from "sendmessage" in roundupdb.py.
 713 # The change note is now generated when the message is created.
 714 #
 715 # Revision 1.25  2001/11/30 20:28:10  rochecompaan
 716 # Property changes are now completely traceable, whether changes are
 717 # made through the web or by email
 718 #
 719 # Revision 1.24  2001/11/30 11:29:04  rochecompaan
 720 # Property changes are now listed in emails generated by Roundup
 721 #
 722 # Revision 1.23  2001/11/27 03:17:13  richard
 723 # oops
 724 #
 725 # Revision 1.22  2001/11/27 03:00:50  richard
 726 # couple of bugfixes from latest patch integration
 727 #
 728 # Revision 1.21  2001/11/26 22:55:56  richard
 729 # Feature:
 730 #  . Added INSTANCE_NAME to configuration - used in web and email to identify
 731 #    the instance.
 732 #  . Added EMAIL_SIGNATURE_POSITION to indicate where to place the roundup
 733 #    signature info in e-mails.
 734 #  . Some more flexibility in the mail gateway and more error handling.
 735 #  . Login now takes you to the page you back to the were denied access to.
 736 #
 737 # Fixed:
 738 #  . Lots of bugs, thanks Roché and others on the devel mailing list!
 739 #
 740 # Revision 1.20  2001/11/25 10:11:14  jhermann
 741 # Typo fix
 742 #
 743 # Revision 1.19  2001/11/22 15:46:42  jhermann
 744 # Added module docstrings to all modules.
 745 #
 746 # Revision 1.18  2001/11/15 10:36:17  richard
 747 #  . incorporated patch from Roch'e Compaan implementing attachments in nosy
 748 #     e-mail
 749 #
 750 # Revision 1.17  2001/11/12 22:01:06  richard
 751 # Fixed issues with nosy reaction and author copies.
 752 #
 753 # Revision 1.16  2001/10/30 00:54:45  richard
 754 # Features:
 755 #  . #467129 ] Lossage when username=e-mail-address
 756 #  . #473123 ] Change message generation for author
 757 #  . MailGW now moves 'resolved' to 'chatting' on receiving e-mail for an issue.
 758 #
 759 # Revision 1.15  2001/10/23 01:00:18  richard
 760 # Re-enabled login and registration access after lopping them off via
 761 # disabling access for anonymous users.
 762 # Major re-org of the htmltemplate code, cleaning it up significantly. Fixed
 763 # a couple of bugs while I was there. Probably introduced a couple, but
 764 # things seem to work OK at the moment.
 765 #
 766 # Revision 1.14  2001/10/21 07:26:35  richard
 767 # feature #473127: Filenames. I modified the file.index and htmltemplate
 768 #  source so that the filename is used in the link and the creation
 769 #  information is displayed.
 770 #
 771 # Revision 1.13  2001/10/21 00:45:15  richard
 772 # Added author identification to e-mail messages from roundup.
 773 #
 774 # Revision 1.12  2001/10/04 02:16:15  richard
 775 # Forgot to pass the protected flag down *sigh*.
 776 #
 777 # Revision 1.11  2001/10/04 02:12:42  richard
 778 # Added nicer command-line item adding: passing no arguments will enter an
 779 # interactive more which asks for each property in turn. While I was at it, I
 780 # fixed an implementation problem WRT the spec - I wasn't raising a
 781 # ValueError if the key property was missing from a create(). Also added a
 782 # protected=boolean argument to getprops() so we can list only the mutable
 783 # properties (defaults to yes, which lists the immutables).
 784 #
 785 # Revision 1.10  2001/08/07 00:24:42  richard
 786 # stupid typo
 787 #
 788 # Revision 1.9  2001/08/07 00:15:51  richard
 789 # Added the copyright/license notice to (nearly) all files at request of
 790 # Bizar Software.
 791 #
 792 # Revision 1.8  2001/08/02 06:38:17  richard
 793 # Roundupdb now appends "mailing list" information to its messages which
 794 # include the e-mail address and web interface address. Templates may
 795 # override this in their db classes to include specific information (support
 796 # instructions, etc).
 797 #
 798 # Revision 1.7  2001/07/30 02:38:31  richard
 799 # get() now has a default arg - for migration only.
 800 #
 801 # Revision 1.6  2001/07/30 00:05:54  richard
 802 # Fixed IssueClass so that superseders links to its classname rather than
 803 # hard-coded to "issue".
 804 #
 805 # Revision 1.5  2001/07/29 07:01:39  richard
 806 # Added vim command to all source so that we don't get no steenkin' tabs :)
 807 #
 808 # Revision 1.4  2001/07/29 04:05:37  richard
 809 # Added the fabricated property "id".
 810 #
 811 # Revision 1.3  2001/07/23 07:14:41  richard
 812 # Moved the database backends off into backends.
 813 #
 814 # Revision 1.2  2001/07/22 12:09:32  richard
 815 # Final commit of Grande Splite
 816 #
 817 # Revision 1.1  2001/07/22 11:58:35  richard
 818 # More Grande Splite
 819 #
 820 #
 821 # vim: set filetype=python ts=4 sw=4 et si