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.47 2002-02-27 03:16:02 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, 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         # get the files for this message
 402         message_files = messages.get(msgid, 'files')
 403
 404         # create the message
 405         message = cStringIO.StringIO()
 406         writer = MimeWriter.MimeWriter(message)
 407         writer.addheader('Subject', '[%s%s] %s'%(cn, nodeid, title))
 408         writer.addheader('To', ', '.join(sendto))
 409         writer.addheader('From', '%s <%s>'%(authname,
 410             self.db.config.ISSUE_TRACKER_EMAIL))
 411         writer.addheader('Reply-To', '%s <%s>'%(self.db.config.INSTANCE_NAME,
 412             self.db.config.ISSUE_TRACKER_EMAIL))
 413         writer.addheader('MIME-Version', '1.0')
 414         if messageid:
 415             writer.addheader('Message-Id', messageid)
 416         if inreplyto:
 417             writer.addheader('In-Reply-To', inreplyto)
 418
 419         # add a uniquely Roundup header to help filtering
 420         writer.addheader('X-Roundup-Name', self.db.config.INSTANCE_NAME)
 421
 422         # attach files
 423         if message_files:
 424             part = writer.startmultipartbody('mixed')
 425             part = writer.nextpart()
 426             body = part.startbody('text/plain')
 427             body.write('\n'.join(m))
 428             for fileid in message_files:
 429                 name = files.get(fileid, 'name')
 430                 mime_type = files.get(fileid, 'type')
 431                 content = files.get(fileid, 'content')
 432                 part = writer.nextpart()
 433                 if mime_type == 'text/plain':
 434                     part.addheader('Content-Disposition',
 435                         'attachment;\n filename="%s"'%name)
 436                     part.addheader('Content-Transfer-Encoding', '7bit')
 437                     body = part.startbody('text/plain')
 438                     body.write(content)
 439                 else:
 440                     # some other type, so encode it
 441                     if not mime_type:
 442                         # this should have been done when the file was saved
 443                         mime_type = mimetypes.guess_type(name)[0]
 444                     if mime_type is None:
 445                         mime_type = 'application/octet-stream'
 446                     part.addheader('Content-Disposition',
 447                         'attachment;\n filename="%s"'%name)
 448                     part.addheader('Content-Transfer-Encoding', 'base64')
 449                     body = part.startbody(mime_type)
 450                     body.write(base64.encodestring(content))
 451             writer.lastpart()
 452         else:
 453             body = writer.startbody('text/plain')
 454             body.write('\n'.join(m))
 455
 456         # now try to send the message
 457         if SENDMAILDEBUG:
 458             open(SENDMAILDEBUG, 'w').write('FROM: %s\nTO: %s\n%s\n'%(
 459                 self.db.config.ADMIN_EMAIL,', '.join(sendto),message.getvalue()))
 460         else:
 461             try:
 462                 # send the message as admin so bounces are sent there
 463                 # instead of to roundup
 464                 smtp = smtplib.SMTP(self.db.config.MAILHOST)
 465                 smtp.sendmail(self.db.config.ADMIN_EMAIL, sendto,
 466                     message.getvalue())
 467             except socket.error, value:
 468                 raise MessageSendError, \
 469                     "Couldn't send confirmation email: mailhost %s"%value
 470             except smtplib.SMTPException, value:
 471                 raise MessageSendError, \
 472                     "Couldn't send confirmation email: %s"%value
 473
 474     def email_signature(self, nodeid, msgid):
 475         ''' Add a signature to the e-mail with some useful information
 476         '''
 477         web = self.db.config.ISSUE_TRACKER_WEB + 'issue'+ nodeid
 478         email = '"%s" <%s>'%(self.db.config.INSTANCE_NAME,
 479             self.db.config.ISSUE_TRACKER_EMAIL)
 480         line = '_' * max(len(web), len(email))
 481         return '%s\n%s\n%s\n%s'%(line, email, web, line)
 482
 483     def generateCreateNote(self, nodeid):
 484         """Generate a create note that lists initial property values
 485         """
 486         cn = self.classname
 487         cl = self.db.classes[cn]
 488         props = cl.getprops(protected=0)
 489
 490         # list the values
 491         m = []
 492         l = props.items()
 493         l.sort()
 494         for propname, prop in l:
 495             value = cl.get(nodeid, propname, None)
 496             # skip boring entries
 497             if not value:
 498                 continue
 499             if isinstance(prop, hyperdb.Link):
 500                 link = self.db.classes[prop.classname]
 501                 if value:
 502                     key = link.labelprop(default_to_id=1)
 503                     if key:
 504                         value = link.get(value, key)
 505                 else:
 506                     value = ''
 507             elif isinstance(prop, hyperdb.Multilink):
 508                 if value is None: value = []
 509                 l = []
 510                 link = self.db.classes[prop.classname]
 511                 key = link.labelprop(default_to_id=1)
 512                 if key:
 513                     value = [link.get(entry, key) for entry in value]
 514                 value = ', '.join(value)
 515             m.append('%s: %s'%(propname, value))
 516         m.insert(0, '----------')
 517         m.insert(0, '')
 518         return '\n'.join(m)
 519
 520     def generateChangeNote(self, nodeid, oldvalues):
 521         """Generate a change note that lists property changes
 522         """
 523         cn = self.classname
 524         cl = self.db.classes[cn]
 525         changed = {}
 526         props = cl.getprops(protected=0)
 527
 528         # determine what changed
 529         for key in oldvalues.keys():
 530             if key in ['files','messages']: continue
 531             new_value = cl.get(nodeid, key)
 532             # the old value might be non existent
 533             try:
 534                 old_value = oldvalues[key]
 535                 if type(new_value) is type([]):
 536                     new_value.sort()
 537                     old_value.sort()
 538                 if new_value != old_value:
 539                     changed[key] = old_value
 540             except:
 541                 changed[key] = new_value
 542
 543         # list the changes
 544         m = []
 545         l = changed.items()
 546         l.sort()
 547         for propname, oldvalue in l:
 548             prop = props[propname]
 549             value = cl.get(nodeid, propname, None)
 550             if isinstance(prop, hyperdb.Link):
 551                 link = self.db.classes[prop.classname]
 552                 key = link.labelprop(default_to_id=1)
 553                 if key:
 554                     if value:
 555                         value = link.get(value, key)
 556                     else:
 557                         value = ''
 558                     if oldvalue:
 559                         oldvalue = link.get(oldvalue, key)
 560                     else:
 561                         oldvalue = ''
 562                 change = '%s -> %s'%(oldvalue, value)
 563             elif isinstance(prop, hyperdb.Multilink):
 564                 change = ''
 565                 if value is None: value = []
 566                 if oldvalue is None: oldvalue = []
 567                 l = []
 568                 link = self.db.classes[prop.classname]
 569                 key = link.labelprop(default_to_id=1)
 570                 # check for additions
 571                 for entry in value:
 572                     if entry in oldvalue: continue
 573                     if key:
 574                         l.append(link.get(entry, key))
 575                     else:
 576                         l.append(entry)
 577                 if l:
 578                     change = '+%s'%(', '.join(l))
 579                     l = []
 580                 # check for removals
 581                 for entry in oldvalue:
 582                     if entry in value: continue
 583                     if key:
 584                         l.append(link.get(entry, key))
 585                     else:
 586                         l.append(entry)
 587                 if l:
 588                     change += ' -%s'%(', '.join(l))
 589             else:
 590                 change = '%s -> %s'%(oldvalue, value)
 591             m.append('%s: %s'%(propname, change))
 592         if m:
 593             m.insert(0, '----------')
 594             m.insert(0, '')
 595         return '\n'.join(m)
 596
 597 #
 598 # $Log: not supported by cvs2svn $
 599 # Revision 1.46  2002/02/25 14:22:59  grubert
 600 #  . roundup db: catch only IOError in getfile.
 601 #
 602 # Revision 1.44  2002/02/15 07:08:44  richard
 603 #  . Alternate email addresses are now available for users. See the MIGRATION
 604 #    file for info on how to activate the feature.
 605 #
 606 # Revision 1.43  2002/02/14 22:33:15  richard
 607 #  . Added a uniquely Roundup header to email, "X-Roundup-Name"
 608 #
 609 # Revision 1.42  2002/01/21 09:55:14  rochecompaan
 610 # Properties in change note are now sorted
 611 #
 612 # Revision 1.41  2002/01/15 00:12:40  richard
 613 # #503340 ] creating issue with [asignedto=p.ohly]
 614 #
 615 # Revision 1.40  2002/01/14 22:21:38  richard
 616 # #503353 ] setting properties in initial email
 617 #
 618 # Revision 1.39  2002/01/14 02:20:15  richard
 619 #  . changed all config accesses so they access either the instance or the
 620 #    config attriubute on the db. This means that all config is obtained from
 621 #    instance_config instead of the mish-mash of classes. This will make
 622 #    switching to a ConfigParser setup easier too, I hope.
 623 #
 624 # At a minimum, this makes migration a _little_ easier (a lot easier in the
 625 # 0.5.0 switch, I hope!)
 626 #
 627 # Revision 1.38  2002/01/10 05:57:45  richard
 628 # namespace clobberation
 629 #
 630 # Revision 1.37  2002/01/08 04:12:05  richard
 631 # Changed message-id format to "<%s.%s.%s%s@%s>" so it complies with RFC822
 632 #
 633 # Revision 1.36  2002/01/02 02:31:38  richard
 634 # Sorry for the huge checkin message - I was only intending to implement #496356
 635 # but I found a number of places where things had been broken by transactions:
 636 #  . modified ROUNDUPDBSENDMAILDEBUG to be SENDMAILDEBUG and hold a filename
 637 #    for _all_ roundup-generated smtp messages to be sent to.
 638 #  . the transaction cache had broken the roundupdb.Class set() reactors
 639 #  . newly-created author users in the mailgw weren't being committed to the db
 640 #
 641 # Stuff that made it into CHANGES.txt (ie. the stuff I was actually working
 642 # on when I found that stuff :):
 643 #  . #496356 ] Use threading in messages
 644 #  . detectors were being registered multiple times
 645 #  . added tests for mailgw
 646 #  . much better attaching of erroneous messages in the mail gateway
 647 #
 648 # Revision 1.35  2001/12/20 15:43:01  rochecompaan
 649 # Features added:
 650 #  .  Multilink properties are now displayed as comma separated values in
 651 #     a textbox
 652 #  .  The add user link is now only visible to the admin user
 653 #  .  Modified the mail gateway to reject submissions from unknown
 654 #     addresses if ANONYMOUS_ACCESS is denied
 655 #
 656 # Revision 1.34  2001/12/17 03:52:48  richard
 657 # Implemented file store rollback. As a bonus, the hyperdb is now capable of
 658 # storing more than one file per node - if a property name is supplied,
 659 # the file is called designator.property.
 660 # I decided not to migrate the existing files stored over to the new naming
 661 # scheme - the FileClass just doesn't specify the property name.
 662 #
 663 # Revision 1.33  2001/12/16 10:53:37  richard
 664 # take a copy of the node dict so that the subsequent set
 665 # operation doesn't modify the oldvalues structure
 666 #
 667 # Revision 1.32  2001/12/15 23:48:35  richard
 668 # Added ROUNDUPDBSENDMAILDEBUG so one can test the sendmail method without
 669 # actually sending mail :)
 670 #
 671 # Revision 1.31  2001/12/15 19:24:39  rochecompaan
 672 #  . Modified cgi interface to change properties only once all changes are
 673 #    collected, files created and messages generated.
 674 #  . Moved generation of change note to nosyreactors.
 675 #  . We now check for changes to "assignedto" to ensure it's added to the
 676 #    nosy list.
 677 #
 678 # Revision 1.30  2001/12/12 21:47:45  richard
 679 #  . Message author's name appears in From: instead of roundup instance name
 680 #    (which still appears in the Reply-To:)
 681 #  . envelope-from is now set to the roundup-admin and not roundup itself so
 682 #    delivery reports aren't sent to roundup (thanks Patrick Ohly)
 683 #
 684 # Revision 1.29  2001/12/11 04:50:49  richard
 685 # fixed the order of the blank line and '-------' line
 686 #
 687 # Revision 1.28  2001/12/10 22:20:01  richard
 688 # Enabled transaction support in the bsddb backend. It uses the anydbm code
 689 # where possible, only replacing methods where the db is opened (it uses the
 690 # btree opener specifically.)
 691 # Also cleaned up some change note generation.
 692 # Made the backends package work with pydoc too.
 693 #
 694 # Revision 1.27  2001/12/10 21:02:53  richard
 695 # only insert the -------- change note marker if there is a change note
 696 #
 697 # Revision 1.26  2001/12/05 14:26:44  rochecompaan
 698 # Removed generation of change note from "sendmessage" in roundupdb.py.
 699 # The change note is now generated when the message is created.
 700 #
 701 # Revision 1.25  2001/11/30 20:28:10  rochecompaan
 702 # Property changes are now completely traceable, whether changes are
 703 # made through the web or by email
 704 #
 705 # Revision 1.24  2001/11/30 11:29:04  rochecompaan
 706 # Property changes are now listed in emails generated by Roundup
 707 #
 708 # Revision 1.23  2001/11/27 03:17:13  richard
 709 # oops
 710 #
 711 # Revision 1.22  2001/11/27 03:00:50  richard
 712 # couple of bugfixes from latest patch integration
 713 #
 714 # Revision 1.21  2001/11/26 22:55:56  richard
 715 # Feature:
 716 #  . Added INSTANCE_NAME to configuration - used in web and email to identify
 717 #    the instance.
 718 #  . Added EMAIL_SIGNATURE_POSITION to indicate where to place the roundup
 719 #    signature info in e-mails.
 720 #  . Some more flexibility in the mail gateway and more error handling.
 721 #  . Login now takes you to the page you back to the were denied access to.
 722 #
 723 # Fixed:
 724 #  . Lots of bugs, thanks Roché and others on the devel mailing list!
 725 #
 726 # Revision 1.20  2001/11/25 10:11:14  jhermann
 727 # Typo fix
 728 #
 729 # Revision 1.19  2001/11/22 15:46:42  jhermann
 730 # Added module docstrings to all modules.
 731 #
 732 # Revision 1.18  2001/11/15 10:36:17  richard
 733 #  . incorporated patch from Roch'e Compaan implementing attachments in nosy
 734 #     e-mail
 735 #
 736 # Revision 1.17  2001/11/12 22:01:06  richard
 737 # Fixed issues with nosy reaction and author copies.
 738 #
 739 # Revision 1.16  2001/10/30 00:54:45  richard
 740 # Features:
 741 #  . #467129 ] Lossage when username=e-mail-address
 742 #  . #473123 ] Change message generation for author
 743 #  . MailGW now moves 'resolved' to 'chatting' on receiving e-mail for an issue.
 744 #
 745 # Revision 1.15  2001/10/23 01:00:18  richard
 746 # Re-enabled login and registration access after lopping them off via
 747 # disabling access for anonymous users.
 748 # Major re-org of the htmltemplate code, cleaning it up significantly. Fixed
 749 # a couple of bugs while I was there. Probably introduced a couple, but
 750 # things seem to work OK at the moment.
 751 #
 752 # Revision 1.14  2001/10/21 07:26:35  richard
 753 # feature #473127: Filenames. I modified the file.index and htmltemplate
 754 #  source so that the filename is used in the link and the creation
 755 #  information is displayed.
 756 #
 757 # Revision 1.13  2001/10/21 00:45:15  richard
 758 # Added author identification to e-mail messages from roundup.
 759 #
 760 # Revision 1.12  2001/10/04 02:16:15  richard
 761 # Forgot to pass the protected flag down *sigh*.
 762 #
 763 # Revision 1.11  2001/10/04 02:12:42  richard
 764 # Added nicer command-line item adding: passing no arguments will enter an
 765 # interactive more which asks for each property in turn. While I was at it, I
 766 # fixed an implementation problem WRT the spec - I wasn't raising a
 767 # ValueError if the key property was missing from a create(). Also added a
 768 # protected=boolean argument to getprops() so we can list only the mutable
 769 # properties (defaults to yes, which lists the immutables).
 770 #
 771 # Revision 1.10  2001/08/07 00:24:42  richard
 772 # stupid typo
 773 #
 774 # Revision 1.9  2001/08/07 00:15:51  richard
 775 # Added the copyright/license notice to (nearly) all files at request of
 776 # Bizar Software.
 777 #
 778 # Revision 1.8  2001/08/02 06:38:17  richard
 779 # Roundupdb now appends "mailing list" information to its messages which
 780 # include the e-mail address and web interface address. Templates may
 781 # override this in their db classes to include specific information (support
 782 # instructions, etc).
 783 #
 784 # Revision 1.7  2001/07/30 02:38:31  richard
 785 # get() now has a default arg - for migration only.
 786 #
 787 # Revision 1.6  2001/07/30 00:05:54  richard
 788 # Fixed IssueClass so that superseders links to its classname rather than
 789 # hard-coded to "issue".
 790 #
 791 # Revision 1.5  2001/07/29 07:01:39  richard
 792 # Added vim command to all source so that we don't get no steenkin' tabs :)
 793 #
 794 # Revision 1.4  2001/07/29 04:05:37  richard
 795 # Added the fabricated property "id".
 796 #
 797 # Revision 1.3  2001/07/23 07:14:41  richard
 798 # Moved the database backends off into backends.
 799 #
 800 # Revision 1.2  2001/07/22 12:09:32  richard
 801 # Final commit of Grande Splite
 802 #
 803 # Revision 1.1  2001/07/22 11:58:35  richard
 804 # More Grande Splite
 805 #
 806 #
 807 # vim: set filetype=python ts=4 sw=4 et si