Lib/toaiff.py

   1 """Convert "arbitrary" sound files to AIFF (Apple and SGI's audio format).
   2
   3 Input may be compressed.
   4 Uncompressed file type may be AIFF, WAV, VOC, 8SVX, NeXT/Sun, and others.
   5 An exception is raised if the file is not of a recognized type.
   6 Returned filename is either the input filename or a temporary filename;
   7 in the latter case the caller must ensure that it is removed.
   8 Other temporary files used are removed by the function.
   9 """
  10 from warnings import warnpy3k
  11 warnpy3k("the toaiff module has been removed in Python 3.0", stacklevel=2)
  12 del warnpy3k
  13
  14 import os
  15 import tempfile
  16 import pipes
  17 import sndhdr
  18
  19 __all__ = ["error", "toaiff"]
  20
  21 table = {}
  22
  23 t = pipes.Template()
  24 t.append('sox -t au - -t aiff -r 8000 -', '--')
  25 table['au'] = t
  26
  27 # XXX The following is actually sub-optimal.
  28 # XXX The HCOM sampling rate can be 22k, 22k/2, 22k/3 or 22k/4.
  29 # XXX We must force the output sampling rate else the SGI won't play
  30 # XXX files sampled at 5.5k or 7.333k; however this means that files
  31 # XXX sampled at 11k are unnecessarily expanded.
  32 # XXX Similar comments apply to some other file types.
  33 t = pipes.Template()
  34 t.append('sox -t hcom - -t aiff -r 22050 -', '--')
  35 table['hcom'] = t
  36
  37 t = pipes.Template()
  38 t.append('sox -t voc - -t aiff -r 11025 -', '--')
  39 table['voc'] = t
  40
  41 t = pipes.Template()
  42 t.append('sox -t wav - -t aiff -', '--')
  43 table['wav'] = t
  44
  45 t = pipes.Template()
  46 t.append('sox -t 8svx - -t aiff -r 16000 -', '--')
  47 table['8svx'] = t
  48
  49 t = pipes.Template()
  50 t.append('sox -t sndt - -t aiff -r 16000 -', '--')
  51 table['sndt'] = t
  52
  53 t = pipes.Template()
  54 t.append('sox -t sndr - -t aiff -r 16000 -', '--')
  55 table['sndr'] = t
  56
  57 uncompress = pipes.Template()
  58 uncompress.append('uncompress', '--')
  59
  60
  61 class error(Exception):
  62     pass
  63
  64 def toaiff(filename):
  65     temps = []
  66     ret = None
  67     try:
  68         ret = _toaiff(filename, temps)
  69     finally:
  70         for temp in temps[:]:
  71             if temp != ret:
  72                 try:
  73                     os.unlink(temp)
  74                 except os.error:
  75                     pass
  76                 temps.remove(temp)
  77     return ret
  78
  79 def _toaiff(filename, temps):
  80     if filename[-2:] == '.Z':
  81         (fd, fname) = tempfile.mkstemp()
  82         os.close(fd)
  83         temps.append(fname)
  84         sts = uncompress.copy(filename, fname)
  85         if sts:
  86             raise error, filename + ': uncompress failed'
  87     else:
  88         fname = filename
  89     try:
  90         ftype = sndhdr.whathdr(fname)
  91         if ftype:
  92             ftype = ftype[0] # All we're interested in
  93     except IOError, msg:
  94         if type(msg) == type(()) and len(msg) == 2 and \
  95                 type(msg[0]) == type(0) and type(msg[1]) == type(''):
  96             msg = msg[1]
  97         if type(msg) != type(''):
  98             msg = repr(msg)
  99         raise error, filename + ': ' + msg
 100     if ftype == 'aiff':
 101         return fname
 102     if ftype is None or not ftype in table:
 103         raise error, '%s: unsupported audio file type %r' % (filename, ftype)
 104     (fd, temp) = tempfile.mkstemp()
 105     os.close(fd)
 106     temps.append(temp)
 107     sts = table[ftype].copy(fname, temp)
 108     if sts:
 109         raise error, filename + ': conversion to aiff failed'
 110     return temp