home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pyth_os2.zip / python-1.0.2 / Lib / multifile.py < prev    next >
Text File  |  1993-12-29  |  3KB  |  118 lines

  1. # A class that makes each part of a multipart message "feel" like an
  2. # ordinary file, as long as you use fp.readline().  Allows recursive
  3. # use, for nested multipart messages.  Probably best used together
  4. # with module mimetools.
  5. #
  6. # Suggested use:
  7. #
  8. # real_fp = open(...)
  9. # fp = MultiFile(real_fp)
  10. #
  11. # "read some lines from fp"
  12. # fp.push(separator)
  13. # while 1:
  14. #    "read lines from fp until it returns an empty string" (A)
  15. #    if not fp.next(): break
  16. # fp.pop()
  17. # "read remaining lines from fp until it returns an empty string"
  18. #
  19. # The latter sequence may be used recursively at (A).
  20. # It is also allowed to use multiple push()...pop() sequences.
  21. # Note that if a nested multipart message is terminated by a separator
  22. # for an outer message, this is not reported, even though it is really
  23. # illegal input.
  24.  
  25. import sys
  26. import string
  27.  
  28. err = sys.stderr.write
  29.  
  30. Error = 'multifile.Error'
  31.  
  32. class MultiFile:
  33.     #
  34.     def __init__(self, fp):
  35.         self.fp = fp
  36.         self.stack = [] # Grows down
  37.         self.level = 0
  38.         self.last = 0
  39.         self.start = self.fp.tell()
  40.         self.posstack = [] # Grows down
  41.     #
  42.     def tell(self):
  43.         if self.level > 0:
  44.             return self.lastpos
  45.         return self.fp.tell() - self.start
  46.     #
  47.     def seek(self, pos):
  48.         if not 0 <= pos <= self.tell() or \
  49.                 self.level > 0 and pos > self.lastpos:
  50.             raise Error, 'bad MultiFile.seek() call'
  51.         self.fp.seek(pos + self.start)
  52.         self.level = 0
  53.         self.last = 0
  54.     #
  55.     def readline(self):
  56.         if self.level > 0: return ''
  57.         line = self.fp.readline()
  58.         if not line:
  59.             self.level = len(self.stack)
  60.             self.last = (self.level > 0)
  61.             if self.last:
  62.                 err('*** Sudden EOF in MultiFile.readline()\n')
  63.             return ''
  64.         if line[:2] <> '--': return line
  65.         n = len(line)
  66.         k = n
  67.         while k > 0 and line[k-1] in string.whitespace: k = k-1
  68.         mark = line[2:k]
  69.         if mark[-2:] == '--': mark1 = mark[:-2]
  70.         else: mark1 = None
  71.         for i in range(len(self.stack)):
  72.             sep = self.stack[i]
  73.             if sep == mark:
  74.                 self.last = 0
  75.                 break
  76.             elif mark1 <> None and sep == mark1:
  77.                 self.last = 1
  78.                 break
  79.         else:
  80.             return line
  81.         # Get here after break out of loop
  82.         self.lastpos = self.tell() - len(line)
  83.         self.level = i+1
  84.         if self.level > 1:
  85.             err('*** Missing endmarker in MultiFile.readline()\n')
  86.         return ''
  87.     #
  88.     def next(self):
  89.         while self.readline(): pass
  90.         if self.level > 1 or self.last:
  91.             return 0
  92.         self.level = 0
  93.         self.last = 0
  94.         self.start = self.fp.tell()
  95.         return 1
  96.     #
  97.     def push(self, sep):
  98.         if self.level > 0:
  99.             raise Error, 'bad MultiFile.push() call'
  100.         self.stack.insert(0, sep)
  101.         self.posstack.insert(0, self.start)
  102.         self.start = self.fp.tell()
  103.     #
  104.     def pop(self):
  105.         if self.stack == []:
  106.             raise Error, 'bad MultiFile.pop() call'
  107.         if self.level <= 1:
  108.             self.last = 0
  109.         else:
  110.             abslastpos = self.lastpos + self.start
  111.         self.level = max(0, self.level - 1)
  112.         del self.stack[0]
  113.         self.start = self.posstack[0]
  114.         del self.posstack[0]
  115.         if self.level > 0:
  116.             self.lastpos = abslastpos - self.start
  117.     #
  118.