def repair_des_header(self):
"""
Determines whether the data extension subheader is well-formed, and tries
to repair it if not. Currently just sets the `DESSHSI` field to the
required value.
Returns `0` if wellformedness could not be evaluated, `1` if no change was
required, `2` if the subheader was replaced, and `3` if the replacement effort
failed (details logged at error level).
Returns
-------
int
"""
stat = self.is_des_well_formed()
if stat is None:
return 0
elif stat:
return 1
sicd_des = self._des_header.UserHeader
sicd_des.DESSHSI = get_specification_identifier()
stat = self.rewrite_des_header()
return 2 if stat else 3
def is_des_well_formed(self):
"""
Returns whether the data extension subheader well-formed. Returns `None`
if the DataExtensionHeader or the UserHeader section of it was not successfully
parsed. Currently just checks the `DESSHSI` field for the required value.
Returns
-------
bool|None
"""
if not self._is_sicd or self.des_header is None or \
not isinstance(self.des_header, DataExtensionHeader):
return None
sicd_des = self._des_header.UserHeader
if not isinstance(sicd_des, XMLDESSubheader):
return None
return sicd_des.DESSHSI.strip() == get_specification_identifier()