rmasalov-surpass 0.1.0

data/lib/surpass/bitmap.rb

@@ -0,0 +1,218 @@
+class ObjBmpRecord < BiffRecord
+  RECORD_ID = 0x005D    # Record identifier
+  
+  def initialize(row, col, sheet, im_data_bmp, x, y, scale_x, scale_y)
+    width = im_data_bmp.width * scale_x
+    height = im_data_bmp.height * scale_y
+    
+    col_start, x1, row_start, y1, col_end, x2, row_end, y2 = position_image(sheet, row, col, x, y, width, height)
+    
+    # Store the OBJ record that precedes an IMDATA record. This could be generalise
+    # to support other Excel objects.
+    cobj = 0x0001      # count of objects in file (set to 1)
+    ot = 0x0008        # object type. 8 = picture
+    id = 0x0001        # object id
+    grbit = 0x0614     # option flags
+    coll = col_start    # col containing upper left corner of object
+    dxl = x1            # distance from left side of cell
+    rwt = row_start     # row containing top left corner of object
+    dyt = y1            # distance from top of cell
+    colr = col_end      # col containing lower right corner of object
+    dxr = x2            # distance from right of cell
+    rwb = row_end       # row containing bottom right corner of object
+    dyb = y2            # distance from bottom of cell
+    cbmacro = 0x0000    # length of fmla structure
+    reserved1 = 0x0000  # reserved
+    reserved2 = 0x0000  # reserved
+    icvback = 0x09      # background colour
+    icvfore = 0x09      # foreground colour
+    fls = 0x00          # fill pattern
+    fauto = 0x00        # automatic fill
+    icv = 0x08          # line colour
+    lns = 0xff          # line style
+    lnw = 0x01          # line weight
+    fautob = 0x00       # automatic border
+    frs = 0x0000        # frame style
+    cf = 0x0009         # image format, 9 = bitmap
+    reserved3 = 0x0000  # reserved
+    cbpictfmla = 0x0000 # length of fmla structure
+    reserved4 = 0x0000  # reserved
+    grbit2 = 0x0001     # option flags
+    reserved5 = 0x0000  # reserved
+    
+    args = [cobj, ot, id, grbit, coll, dxl, rwt, dyt, colr, dxr, rwb, dyb, cbmacro, reserved1, reserved2, icvback, icvfore, fls, fauto, icv, lns, lnw, fautob, frs, cf, reserved3, cbpictfmla, reserved4, grbit2, reserved5]
+    @record_data = args.pack('L v12 L v C8 v L v4 L')
+  end
+  
+  # Calculate the vertices that define the position of the image as required by
+  # the OBJ record.
+  # 
+  #          +------------+------------+
+  #          |     A      |      B     |
+  #    +-----+------------+------------+
+  #    |     |(x1,y1)     |            |
+  #    |  1  |(A1)._______|______      |
+  #    |     |    |              |     |
+  #    |     |    |              |     |
+  #    +-----+----|    BITMAP    |-----+
+  #    |     |    |              |     |
+  #    |  2  |    |______________.     |
+  #    |     |            |        (B2)|
+  #    |     |            |     (x2,y2)|
+  #    +---- +------------+------------+
+  # 
+  # Example of a bitmap that covers some of the area from cell A1 to cell B2.
+  # 
+  # Based on the width and height of the bitmap we need to calculate 8 vars:
+  #     col_start, row_start, col_end, row_end, x1, y1, x2, y2.
+  # The width and height of the cells are also variable and have to be taken into
+  # account.
+  # The values of col_start and row_start are passed in from the calling
+  # function. The values of col_end and row_end are calculated by subtracting
+  # the width and height of the bitmap from the width and height of the
+  # underlying cells.
+  # The vertices are expressed as a percentage of the underlying cell width as
+  # follows (rhs values are in pixels):
+  # 
+  #        x1 = X / W *1024
+  #        y1 = Y / H *256
+  #        x2 = (X-1) / W *1024
+  #        y2 = (Y-1) / H *256
+  # 
+  #        Where:  X is distance from the left side of the underlying cell
+  #                Y is distance from the top of the underlying cell
+  #                W is the width of the cell
+  #                H is the height of the cell
+  # 
+  # Note: the SDK incorrectly states that the height should be expressed as a
+  # percentage of 1024.
+  # 
+  # col_start  - Col containing upper left corner of object
+  # row_start  - Row containing top left corner of object
+  # x1  - Distance to left side of object
+  # y1  - Distance to top of object
+  # width  - Width of image frame
+  # height  - Height of image frame
+  def position_image(sheet, row_start, col_start, x1, y1, width, height)
+    while x1 >= size_col(sheet, col_start) do
+      x1 -= size_col(sheet, col_start)
+      col_start += 1
+    end
+    
+    # Adjust start row for offsets that are greater than the row height
+    while y1 >= size_row(sheet, row_start) do
+      y1 -= size_row(sheet, row_start)
+      row_start += 1
+    end
+    
+    # Initialise end cell to the same as the start cell
+    row_end = row_start   # Row containing bottom right corner of object
+    col_end = col_start   # Col containing lower right corner of object
+    width = width + x1 - 1
+    height = height + y1 - 1
+    
+    # Subtract the underlying cell widths to find the end cell of the image
+    while (width >= size_col(sheet, col_end)) do
+      width -= size_col(sheet, col_end)
+      col_end += 1
+    end
+    
+    # Subtract the underlying cell heights to find the end cell of the image
+    while (height >= size_row(sheet, row_end)) do
+      height -= size_row(sheet, row_end)
+      row_end += 1
+    end
+    
+    # Bitmap isn't allowed to start or finish in a hidden cell, i.e. a cell
+    # with zero height or width.
+    starts_or_ends_in_hidden_cell = ((size_col(sheet, col_start) == 0) or (size_col(sheet, col_end) == 0) or (size_row(sheet, row_start) == 0) or (size_row(sheet, row_end) == 0))
+    return if starts_or_ends_in_hidden_cell
+
+    # Convert the pixel values to the percentage value expected by Excel
+    x1 = (x1.to_f / size_col(sheet, col_start) * 1024).to_i
+    y1 = (y1.to_f / size_row(sheet, row_start) * 256).to_i
+    # Distance to right side of object
+    x2 = (width.to_f / size_col(sheet, col_end) * 1024).to_i
+    # Distance to bottom of object
+    y2 = (height.to_f / size_row(sheet, row_end) * 256).to_i
+    
+    [col_start, x1, row_start, y1, col_end, x2, row_end, y2]
+  end
+  
+  def size_col(sheet, col)
+    sheet.col_width(col)
+  end
+
+  def size_row(sheet, row)
+    sheet.row_height(row)
+  end
+end
+
+class ImDataBmpRecord < BiffRecord
+  RECORD_ID = 0x007F
+  
+  attr_accessor :width
+  attr_accessor :height
+  attr_accessor :size
+  
+  # Insert a 24bit bitmap image in a worksheet. The main record required is
+  # IMDATA but it must be proceeded by a OBJ record to define its position.
+  def initialize(filename)
+    @width, @height, @size, data = process_bitmap(filename)
+    
+    cf = 0x09
+    env = 0x01
+    lcb = @size
+    
+    @record_data =  [cf, env, lcb].pack('v2L') + data
+  end
+  
+  # Convert a 24 bit bitmap into the modified internal format used by Windows.
+  # This is described in BITMAPCOREHEADER and BITMAPCOREINFO structures in the
+  # MSDN library.
+  def process_bitmap(filename)
+    data = nil
+    File.open(filename, "rb") do |f|
+      data = f.read
+    end
+    
+    raise "bitmap #{filename} doesn't contain enough data" if data.length <= 0x36
+    raise "bitmap #{filename} is not valid" unless data[0, 2] === "BM"
+    
+    # Remove bitmap data: ID.
+    data = data[2..-1]
+
+    # Read and remove the bitmap size. This is more reliable than reading
+    # the data size at offset 0x22.
+    size = data[0,4].unpack('L')[0]
+    size -=  0x36   # Subtract size of bitmap header.
+    size +=  0x0C   # Add size of BIFF header.
+
+    data = data[4..-1]
+    # Remove bitmap data: reserved, offset, header length.
+    data = data[12..-1]
+    # Read and remove the bitmap width and height. Verify the sizes.
+    width, height = data[0,8].unpack('L2')
+    data = data[8..-1]
+    raise "bitmap #{filename} largest image width supported is 65k." if (width > 0xFFFF)
+    raise "bitmap #{filename} largest image height supported is 65k." if (height > 0xFFFF)
+    
+    # Read and remove the bitmap planes and bpp data. Verify them.
+    planes, bitcount = data[0,4].unpack('v2')
+    data = data[4..-1]
+    raise "bitmap #{filename} isn't a 24bit true color bitmap." if (bitcount != 24)
+    raise "bitmap #{filename} only 1 plane supported in bitmap image." if (planes != 1)
+
+    # Read and remove the bitmap compression. Verify compression.
+    compression = data[0,4].unpack('L')[0]
+    data = data[4..-1]
+    raise "bitmap #{filename} compression not supported in bitmap image." if (compression != 0)
+        
+    # Remove bitmap data: data size, hres, vres, colours, imp. colours.
+    data = data[20..-1]
+    # Add the BITMAPCOREHEADER data
+    header = [0x000c, width, height, 0x01, 0x18].pack('Lv4')
+    
+    [width, height, size, header + data]
+  end
+end

data/lib/surpass/chart.rb

@@ -0,0 +1,16 @@
+class Chart
+  def initialize
+    raise "not implemented"
+  end
+  
+  
+  # ● OBJ Object description for the chart 
+  # ● BOF Type = chart (➜5.8) 
+  # Chart records 
+  # ● EOF End of the Chart Substream of the chart object (5.37) 
+  def to_biff
+    result = []
+    result << Biff8BOFRecord.new(Biff8BOFRecord::CHART).to_biff
+    result.join
+  end
+end

data/lib/surpass/column.rb

@@ -0,0 +1,40 @@
+class Column
+  attr_accessor :index
+  attr_accessor :width
+  attr_accessor :hidden
+  attr_accessor :level
+  attr_accessor :collapse
+  
+  def initialize(index, parent)
+    is_int = index.is_a?(Integer)
+    in_range = (index >= 0) && (index <= 255)
+    raise "column index #{index} is not valid" unless is_int && in_range
+    
+    @index = index
+    @parent = parent
+    @parent_wb = parent.parent
+    @xf_index = 0x0F
+    
+    @width = 0x0B92
+    @hidden = 0
+    @level = 0
+    @collapse = 0
+  end
+  
+  def to_biff
+    options =  (as_numeric(@hidden) & 0x01) << 0
+    options |= (@level & 0x07) << 8
+    options |= (as_numeric(@collapse) & 0x01) << 12
+    
+    ColInfoRecord.new(@index, @index, @width, @xf_index, options).to_biff
+  end
+  
+  def set_style(style)
+    @xf_index = @parent_wb.add_style(style)
+  end
+  
+  def width_in_pixels
+      # *** Approximation ****
+    (self.width * 0.0272 + 0.446).round
+  end
+end

data/lib/surpass/document.rb

@@ -0,0 +1,406 @@
+class Reader
+  DIR_ENTRY_SIZE = 128
+  
+  attr_accessor :header
+  attr_accessor :data
+  
+  attr_accessor :doc_magic
+  attr_accessor :file_uid
+  attr_accessor :rev_num
+  attr_accessor :ver_num
+  attr_accessor :byte_order
+  attr_accessor :sect_size
+  attr_accessor :short_sect_size
+  
+  attr_accessor :total_sat_sectors
+  attr_accessor :dir_start_sid
+  attr_accessor :min_stream_size
+  attr_accessor :ssat_start_sid
+  attr_accessor :total_ssat_sectors
+  attr_accessor :msat_start_sid
+  attr_accessor :total_msat_sectors
+  
+  attr_accessor :msat
+  attr_accessor :sat
+  attr_accessor :ssat
+  attr_accessor :dir_entry_list
+  
+  def initialize(file)
+    @streams = {}
+    
+    file = File.open(file, 'rb') unless file.respond_to?(:read)
+    doc = file.read
+    @header, @data = doc[0...512], doc[512..-1]
+    
+    build_header
+    build_msat
+    build_sat
+    build_directory
+    build_short_sectors_data
+
+    if @short_sectors_data.length > 0
+      build_ssat
+    else
+      @ssat_start_sid = -2
+      @total_ssat_sectors = 0
+      @ssat = [-2]
+    end
+
+    @dir_entry_list[1..-1].each do |d|
+      did, sz, name, t, c, did_left, did_right, did_root, dentry_start_sid, stream_size = d
+      stream_data = ''
+      if stream_size > 0
+        if stream_size > @min_stream_size
+          args = [@data, @sat, dentry_start_sid, @sect_size]
+        else
+          args = [@short_sectors_data, @ssat, dentry_start_sid, @short_sect_size]
+        end
+        stream_data = stream_data(*args)
+      end
+      # BAD IDEA: names may be equal. NEED use full paths...
+      @streams[name] = stream_data if !name.length == 0
+    end
+  end
+  
+  def build_header
+    @doc_magic = @header[0...8]
+    raise 'Not an OLE file.' unless @doc_magic === "\320\317\021\340\241\261\032\341"
+
+    @file_uid              = @header[8...24]
+    @rev_num               = @header[24...26]
+    @ver_num               = @header[26...28]
+    @byte_order            = @header[28...30]
+    @log2_sect_size       = @header[30...32].unpack('v')[0]
+    @log2_short_sect_size = @header[32...34].unpack('v')[0]
+    @total_sat_sectors    = @header[44...48].unpack('V')[0]
+    @dir_start_sid        = @header[48...52].unpack('V')[0]
+    @min_stream_size      = @header[56...60].unpack('V')[0]
+    @ssat_start_sid       = @header[60...64].unpack('V')[0]
+    @total_ssat_sectors   = @header[64...68].unpack('V')[0]
+    @msat_start_sid       = @header[68...72].unpack('V')[0]
+    @total_msat_sectors   = @header[72...76].unpack('V')[0]
+
+    @sect_size        = 1 << @log2_sect_size
+    @short_sect_size  = 1 << @log2_short_sect_size
+  end
+  
+  def build_msat
+    @msat = @header[76..-1].unpack('V109')
+    next_sector = @msat_start_sid
+    while next_sector > 0 do
+      raise "not implemented"
+      start = next_sector * @sect_size
+      finish = (next_sector + 1) * @sect_size
+      msat_sector = @data[start...finish]
+      @msat << msat_sector
+      next_sector = msat_sector[-1]
+    end
+  end
+  
+  def build_sat
+    sat_stream = @msat.collect {|i| i >= 0 ? @data[(i*@sect_size)...((i+1)*@sect_size)] : '' }.join
+    @sat = sat_stream.unpack('V*')
+  end
+  
+  def build_ssat
+    ssat_stream = stream_data(@data, @sat, @ssat_start_sid, @sect_size)
+    @ssat = ssat_stream.unpack('V*')
+  end
+  
+  def build_directory
+    dir_stream = stream_data(@data, @sat, @dir_start_sid, @sect_size)
+    @dir_entry_list = []
+    i = 0
+    while i < dir_stream.length do
+      dentry = dir_stream[i...(i+DIR_ENTRY_SIZE)]
+      i += DIR_ENTRY_SIZE
+      
+      did = @dir_entry_list.length
+      sz = dentry[64...66].unpack('C')[0]
+      
+      if sz > 0
+        name = dentry[0...(sz-2)] # TODO unicode
+      else
+        name = ''
+      end
+      
+      t = dentry[66...67].unpack('C')[0]
+      c = dentry[67...68].unpack('C')[0]
+      did_left = dentry[68...72].unpack('V')[0]
+      did_right = dentry[72...76].unpack('V')[0]
+      did_root = dentry[76...80].unpack('V')[0]
+      dentry_start_sid = dentry[116...120].unpack('V')[0]
+      stream_size = dentry[120...124].unpack('V')[0]
+      
+      @dir_entry_list << [did, sz, name, t, c, did_left, did_right, did_root, dentry_start_sid, stream_size]
+    end
+  end
+  
+  def build_short_sectors_data
+    did, sz, name, t, c, did_left, did_right, did_root, dentry_start_sid, stream_size = @dir_entry_list[0]
+    raise unless t == 0x05 # Short-Stream Container Stream (SSCS) resides in Root Storage
+
+    if stream_size == 0
+      @short_sectors_data = ''
+    else
+      @short_sectors_data = stream_data(@data, @sat, dentry_start_sid, @sect_size)
+    end
+  end
+  
+  def stream_data(data, sat, start_sid, sect_size)
+      sid = start_sid
+      chunks = [[sid, sid]]
+      stream_data = ''
+      while sat[sid] >= 0 do
+          next_in_chain = sat[sid]
+          last_chunk_start, last_chunk_finish = chunks[-1]
+          if next_in_chain == last_chunk_finish + 1
+              chunks[-1] = last_chunk_start, next_in_chain
+          else
+              chunks << [next_in_chain, next_in_chain]
+          end
+          sid = next_in_chain
+      end
+      
+      chunks.each do |s, f|
+        stream_data += data[s*sect_size...(f+1)*sect_size]
+      end
+      stream_data
+    end
+end
+
+
+# This implementation writes only 'Root Entry', 'Workbook' streams
+# and 2 empty streams for aligning directory stream on sector boundary
+# 
+# LAYOUT:
+# 0         header
+# 76                MSAT (1st part: 109 SID)
+# 512       workbook stream
+# ...       additional MSAT sectors if streams' size > about 7 Mb == (109*512 * 128)
+# ...       SAT
+# ...       directory stream
+#
+# NOTE: this layout is "ad hoc". It can be more general. RTFM
+class ExcelDocument
+  SECTOR_SIZE = 0x0200
+  MIN_LIMIT   = 0x1000
+
+  SID_FREE_SECTOR  = -1
+  SID_END_OF_CHAIN = -2
+  SID_USED_BY_SAT  = -3
+  SID_USED_BY_MSAT = -4
+  
+  def initialize
+    @book_stream_sect = []
+    @dir_stream_sect = []
+    
+    @packed_sat = ''
+    @sat_sect = []
+    
+    @packed_msat_1st = ''
+    @packed_msat_2nd = ''
+    @msat_sect_2nd = []
+    @header = ''
+  end
+  
+  def build_directory
+    @dir_stream = ''
+    
+    name = 'Root Entry'
+    type = 0x05 # root storage
+    colour = 0x01 # black
+    did_left  = -1
+    did_right = -1
+    did_root  = 1
+    start_sid = -2
+    stream_sz = 0
+    @dir_stream += pack_directory(name, type, colour, did_left, did_right, did_root, start_sid, stream_sz)
+
+    name = 'Workbook'
+    type = 0x02 # user stream
+    colour = 0x01 # black
+    did_left  = -1
+    did_right = -1
+    did_root  = -1
+    start_sid = 0
+    stream_sz = @book_stream_len
+    @dir_stream += pack_directory(name, type, colour, did_left, did_right, did_root, start_sid, stream_sz)
+    # padding
+    name      = ''
+    type      = 0x00 # empty
+    colour    = 0x01 # black
+    did_left  = -1
+    did_right = -1
+    did_root  = -1
+    start_sid = -2
+    stream_sz = 0
+    @dir_stream += pack_directory(name, type, colour, did_left, did_right, did_root, start_sid, stream_sz) * 2
+  end
+  
+  def pack_directory(name, type, colour, did_left, did_right, did_root, start_sid, stream_sz)
+    encoded_name = ''
+    0.upto(name.length) do |i|
+      encoded_name << name[i, 1] + "\000" 
+    end
+    encoded_name << "\000"
+    name_sz = encoded_name.length
+
+    args = [encoded_name, name_sz, type, colour, did_left, did_right, did_root, 0, 0, 0, 0, 0, 0, 0, 0, 0, start_sid, stream_sz, 0]
+    args.pack('a64 v C2 V3 V9 V V2')
+  end
+  
+  def build_sat
+    book_sect_count       = @book_stream_len >> 9
+    dir_sect_count        = @dir_stream.length >> 9
+    total_sect_count      = book_sect_count + dir_sect_count
+    sat_sect_count        = 0
+    msat_sect_count       = 0
+    sat_sect_count_limit  = 109
+    
+    while (total_sect_count > 128*sat_sect_count) || (sat_sect_count > sat_sect_count_limit) do
+      sat_sect_count += 1
+      total_sect_count += 1
+      if sat_sect_count > sat_sect_count_limit
+        msat_sect_count += 1
+        total_sect_count += 1
+        sat_sect_count_limit += 127
+      end
+    end
+    
+    # initialize the sat array to be filled with the "empty" character specified by SID_FREE_SECTOR
+    sat = [SID_FREE_SECTOR]*128*sat_sect_count
+    
+    sect = 0
+    while sect < book_sect_count - 1 do
+      @book_stream_sect << sect
+      sat[sect] = sect + 1
+      sect += 1
+    end
+    @book_stream_sect << sect
+    sat[sect] = SID_END_OF_CHAIN
+    sect += 1
+    
+    while sect < book_sect_count + msat_sect_count do
+      @msat_sect_2nd << sect
+      sat[sect] = SID_USED_BY_MSAT
+      sect += 1
+    end
+    
+    while sect < book_sect_count + msat_sect_count + sat_sect_count do
+      @sat_sect << sect
+      sat[sect] = SID_USED_BY_SAT
+      sect += 1
+    end
+    
+    while sect < book_sect_count + msat_sect_count + sat_sect_count + dir_sect_count - 1 do
+      @dir_stream_sect << sect
+      sat[sect] = sect + 1
+      sect += 1
+    end
+    
+    @dir_stream_sect << sect
+    sat[sect] = SID_END_OF_CHAIN
+    sect += 1
+    
+    @packed_sat = sat.pack('V*')
+    
+    msat_1st = []
+    109.times do |i|
+      msat_1st[i] = @sat_sect[i] || SID_FREE_SECTOR
+    end
+    @packed_msat_1st = msat_1st.pack('V*')
+    
+    msat_2nd = [SID_FREE_SECTOR] * 128 * msat_sect_count
+    msat_2nd[-1] = SID_END_OF_CHAIN if msat_sect_count > 0
+    
+    i = 109
+    msat_sect = 0
+    sid_num = 0
+    
+    while i < sat_sect_count do
+      if (sid_num + 1) % 128 == 0
+        msat_sect += 1
+        msat_2nd[sid_num] = @msat_sect_2nd[msat_sect] if msat_sect < @msat_sect_2nd.length
+      else
+        msat_2nd[sid_num] = @sat_sect[i]
+        i += 1
+      end
+      sid_num += 1
+    end
+    
+    @packed_msat_2nd = msat_2nd.pack('V*')
+  end
+  
+  def build_header
+     doc_magic                    = "\320\317\021\340\241\261\032\341"
+     file_uid                     =  "\000" * 16
+     rev_num                      = ">\000"
+     ver_num                      = "\003\000"
+     byte_order                   = "\376\377"
+     log_sect_size                = [9].pack('v')
+     log_short_sect_size          = [6].pack('v')
+     not_used0                    = "\000"*10
+     total_sat_sectors            = [@sat_sect.length].pack('V')
+     dir_start_sid                = [@dir_stream_sect[0]].pack('V')
+     not_used1                    = "\000"*4        
+     min_stream_size              = [0x1000].pack('V')
+     ssat_start_sid               = [-2].pack('V')
+     total_ssat_sectors           = [0].pack('V')
+     
+     if @msat_sect_2nd.length == 0
+       msat_start_sid = [-2].pack('V')
+     else
+       msat_start_sid = [@msat_sect_2nd[0]].pack('V')
+     end
+     
+     total_msat_sectors = [@msat_sect_2nd.length].pack('V')
+     
+     @header = [
+         doc_magic,
+         file_uid,
+         rev_num,
+         ver_num,
+         byte_order,
+         log_sect_size,
+         log_short_sect_size,
+         not_used0,
+         total_sat_sectors,
+         dir_start_sid,
+         not_used1,
+         min_stream_size,
+         ssat_start_sid,
+         total_ssat_sectors,
+         msat_start_sid,
+         total_msat_sectors
+     ].join
+  end
+  
+  def data(stream)
+    distance_to_end_of_next_sector_boundary = 0x1000 - (stream.length % 0x1000)
+    @book_stream_len = stream.length + distance_to_end_of_next_sector_boundary
+    padding = "\000" * distance_to_end_of_next_sector_boundary
+
+    build_directory
+    build_sat
+    build_header
+    
+    s = StringIO.new
+    s.write(@header)
+    s.write(@packed_msat_1st)
+    s.write(stream)
+    s.write(padding)
+    s.write(@packed_msat_2nd)
+    s.write(@packed_sat)
+    s.write(@dir_stream)
+    s.rewind
+    s
+  end
+  
+  def save(file, stream)
+    we_own_it = !file.respond_to?(:write)
+    file = File.open(file, 'wb') if we_own_it
+    file.write data(stream).read
+    file.close if we_own_it
+  end
+end