docs: def validate_file(mwtabfile, section_schema_mapping=section_schema_mapping, validate_samples=True, validate_factors=True):
      """Validate entire ``mwTab`` formatted file one section at a time.
      
      :param mwtabfile: Instance of :class:`~mwtab.mwtab.MWTabFile`.
      :type mwtabfile: :class:`~mwtab.mwtab.MWTabFile`
      :param dict section_schema_mapping: Dictionary that provides mapping between section name and schema definition.
      :param validate_samples: Make sure that sample ids are consistent across file.
      :type validate_samples: :py:obj:`True` or :py:obj:`False`  
      :param validate_factors: Make sure that factors are consistent across file.
      :type validate_factors: :py:obj:`True` or :py:obj:`False`
      :return: Validated file.
      :rtype: :py:class:`collections.OrderedDict`
      """
      validated_mwtabfile = OrderedDict()
  
      try:
          _validate_samples_factors(mwtabfile, validate_samples, validate_factors)
      except Exception:
          raise
  
      for section_key, section in mwtabfile.items():
          try:
              schema = section_schema_mapping[section_key]
              section = validate_section(section=section, schema=schema)
              validated_mwtabfile[section_key] = section
          except Exception:
              raise
  
      return validated_mwtabfile