#!/usr/bin/env python
     #
     # Copyright 2007 Doug Hellmann.
     #
     #
     #                         All Rights Reserved
     #
     # Permission to use, copy, modify, and distribute this software and
     # its documentation for any purpose and without fee is hereby
     # granted, provided that the above copyright notice appear in all
     # copies and that both that copyright notice and this permission
     # notice appear in supporting documentation, and that the name of Doug
     # Hellmann not be used in advertising or publicity pertaining to
     # distribution of the software without specific, written prior
     # permission.
     #
     # DOUG HELLMANN DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
     # INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
     # NO EVENT SHALL DOUG HELLMANN BE LIABLE FOR ANY SPECIAL, INDIRECT OR
     # CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
     # OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
     # NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
     # CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
     #
     
     """Copying a file
     
     """
     
     __version__ = "$Id$"
     #end_pymotw_header
     
     from shutil import *
     import os
     from StringIO import StringIO
     import sys
     
     class VerboseStringIO(StringIO):
         def read(self, n=-1):
             next = StringIO.read(self, n)
             print 'read(%d) =>' % n, next
             return next
     
     lorem_ipsum = '''Lorem ipsum dolor sit amet, consectetuer adipiscing elit. 
     Vestibulum aliquam mollis dolor. Donec vulputate nunc ut diam. 
     Ut rutrum mi vel sem. Vestibulum ante ipsum.'''
     
     print 'Default:'
     input = VerboseStringIO(lorem_ipsum)
     output = StringIO()
     copyfileobj(input, output)
     
     print
     
     print 'All at once:'
     input = VerboseStringIO(lorem_ipsum)
     output = StringIO()
     copyfileobj(input, output, -1)
     
     print
     
     print 'Blocks of 20:'
     input = VerboseStringIO(lorem_ipsum)
     output = StringIO()
     copyfileobj(input, output, 20)