Vega strike Python Modules doc: mimetools Namespace Reference

All Data Structures Namespaces Files Functions Variables

Data Structures
class	Message

Functions
def	choose_boundary

def	decode

def	encode

def	pipeto

def	pipethrough

def	copyliteral

def	copybinary

Variables
list	__all__

	_prefix = None

string	uudecode_pipe

dictionary	decodetab

dictionary	encodetab

Detailed Description

Various tools used by MIME-reading or MIME-writing programs.

Function Documentation

def mimetools.choose_boundary ( )

Return a random string usable as a multipart boundary.
The method used is so that it is *very* unlikely that the same
string of characters will every occur again in the Universe,
so the caller needn't check the data it is packing for the
occurrence of the boundary.

The boundary contains dots so you have to quote it in the header.

Definition at line 101 of file mimetools.py.

References random.randint().

 
 def choose_boundary():
     """Return a random string usable as a multipart boundary.
     The method used is so that it is *very* unlikely that the same
     string of characters will every occur again in the Universe,
     so the caller needn't check the data it is packing for the
     occurrence of the boundary.
 
     The boundary contains dots so you have to quote it in the header."""
 
     global _prefix
     import time
     import random
     if _prefix is None:
         import socket
         import os
         hostid = socket.gethostbyname(socket.gethostname())
         try:
             uid = `os.getuid()`
         except:
             uid = '1'
         try:
             pid = `os.getpid()`
         except:
             pid = '1'
         _prefix = hostid + '.' + uid + '.' + pid
     timestamp = '%.3f' % time.time()
     seed = `random.randint(0, 32767)`
     return _prefix + '.' + timestamp + '.' + seed
 
 
 # Subroutines for decoding some common content-transfer-types

def mimetools.copybinary	(	input,
		output
	)

Definition at line 221 of file mimetools.py.

 
 def copybinary(input, output):
     BUFSIZE = 8192
     while 1:
         line = input.read(BUFSIZE)
         if not line: break
         output.write(line)

def mimetools.copyliteral	(	input,
		output
	)

Definition at line 215 of file mimetools.py.

 
 def copyliteral(input, output):
     while 1:
         line = input.readline()
         if not line: break
         output.write(line)

def mimetools.decode	(	input,
		output,
		encoding
	)

Decode common content-transfer-encodings (base64, quopri, uuencode).

Definition at line 133 of file mimetools.py.

References base64.decode(), uu.decode(), quopri.decode(), and pipethrough().

 
 def decode(input, output, encoding):
     """Decode common content-transfer-encodings (base64, quopri, uuencode)."""
     if encoding == 'base64':
         import base64
         return base64.decode(input, output)
     if encoding == 'quoted-printable':
         import quopri
         return quopri.decode(input, output)
     if encoding in ('uuencode', 'x-uuencode', 'uue', 'x-uue'):
         import uu
         return uu.decode(input, output)
     if encoding in ('7bit', '8bit'):
         return output.write(input.read())
     if decodetab.has_key(encoding):
         pipethrough(input, decodetab[encoding], output)
     else:
         raise ValueError, \
               'unknown Content-Transfer-Encoding: %s' % encoding

def mimetools.encode	(	input,
		output,
		encoding
	)

Encode common content-transfer-encodings (base64, quopri, uuencode).

Definition at line 152 of file mimetools.py.

References base64.encode(), quopri.encode(), uu.encode(), and pipethrough().

 
 def encode(input, output, encoding):
     """Encode common content-transfer-encodings (base64, quopri, uuencode)."""
     if encoding == 'base64':
         import base64
         return base64.encode(input, output)
     if encoding == 'quoted-printable':
         import quopri
         return quopri.encode(input, output, 0)
     if encoding in ('uuencode', 'x-uuencode', 'uue', 'x-uue'):
         import uu
         return uu.encode(input, output)
     if encoding in ('7bit', '8bit'):
         return output.write(input.read())
     if encodetab.has_key(encoding):
         pipethrough(input, encodetab[encoding], output)
     else:
         raise ValueError, \
               'unknown Content-Transfer-Encoding: %s' % encoding
 
 # The following is no longer used for standard encodings
 
 # XXX This requires that uudecode and mmencode are in $PATH

def mimetools.pipethrough	(	input,
		command,
		output
	)

Definition at line 205 of file mimetools.py.

References copybinary(), copyliteral(), tempfile.mktemp(), and aifc.open().

 
 def pipethrough(input, command, output):
     tempname = tempfile.mktemp()
     temp = open(tempname, 'w')
     copyliteral(input, temp)
     temp.close()
     pipe = os.popen(command + ' <' + tempname, 'r')
     copybinary(pipe, output)
     pipe.close()
     os.unlink(tempname)

def mimetools.pipeto	(	input,
		command
	)

Data Structures

Functions

Variables

Detailed Description

Function Documentation

Variable Documentation