code: def init_file(self, filename, lines, expected, line_offset):
          
          self.filename = filename
          self.lines = lines
          self.expected = expected or ()
          self.line_offset = line_offset
          self.file_errors = 0
          self.counters['files'] += 1
          self.counters['physical lines'] += len(lines)
docs: Signal a new file.