eba-xbridge 1.5.0rc6__tar.gz → 1.5.0rc8__tar.gz

{eba_xbridge-1.5.0rc6 → eba_xbridge-1.5.0rc8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eba-xbridge
-Version: 1.5.0rc6
+Version: 1.5.0rc8
 Summary: XBRL-XML to XBRL-CSV converter for EBA Taxonomy (version 4.1)
 License: Apache 2.0
 License-File: LICENSE

{eba_xbridge-1.5.0rc6 → eba_xbridge-1.5.0rc8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "eba-xbridge"
-version = "1.5.0rc6"
+version = "1.5.0rc8"
 description = "XBRL-XML to XBRL-CSV converter for EBA Taxonomy (version 4.1)"
 license = 'Apache 2.0'
 readme = "README.rst"

{eba_xbridge-1.5.0rc6 → eba_xbridge-1.5.0rc8}/src/xbridge/__init__.py

@@ -2,4 +2,4 @@
 Init file for eba-xbridge library
 """
 
-__version__ = "1.5.0rc6"
+__version__ = "1.5.0rc8"

{eba_xbridge-1.5.0rc6 → eba_xbridge-1.5.0rc8}/src/xbridge/converter.py

@@ -15,7 +15,11 @@ from zipfile import ZipFile
 
 import pandas as pd
 
-from xbridge.exceptions import DecimalValueError, FilingIndicatorWarning
+from xbridge.exceptions import (
+    DecimalValueError,
+    FilingIndicatorValueError,
+    FilingIndicatorWarning,
+)
 from xbridge.instance import CsvInstance, Instance, XmlInstance
 from xbridge.modules import Module, Table
 
@@ -513,7 +517,7 @@ class Converter:
         """Validate that no facts are orphaned (belong only to non-reported tables).
 
         Raises:
-            ValueError: If facts exist that belong only to tables with filed=false
+            FilingIndicatorValueError: If facts exist that belong only to tables with filed=false
         """
         if self.instance.instance_df is None or self.instance.instance_df.empty:
             return
@@ -561,7 +565,7 @@ class Converter:
                     "Either set filed=true for the relevant tables "
                     "or remove these facts from the XML."
                 )
-                raise ValueError(error_msg)
+                raise FilingIndicatorValueError(error_msg, orphaned_per_table)
             error_msg += (
                 "\nThese facts will be excluded from the output. "
                 "Consider setting filed=true for the relevant tables "

{eba_xbridge-1.5.0rc6 → eba_xbridge-1.5.0rc8}/src/xbridge/exceptions.py

@@ -21,6 +21,14 @@ class DecimalValueError(ValueError):
         self.offending_value = offending_value
 
 
+class FilingIndicatorValueError(ValueError):
+    """Raised when filing indicator validation fails."""
+
+    def __init__(self, error_message: str, offending_value: Optional[Any] = None) -> None:
+        super().__init__(error_message)
+        self.offending_value = offending_value
+
+
 class XbridgeWarning(Warning):
     """Base warning for the xbridge library."""
 

{eba_xbridge-1.5.0rc6 → eba_xbridge-1.5.0rc8}/src/xbridge/instance.py

@@ -13,7 +13,11 @@ from zipfile import ZipFile
 import pandas as pd
 from lxml import etree
 
-from xbridge.exceptions import IdentifierPrefixWarning, SchemaRefValueError
+from xbridge.exceptions import (
+    FilingIndicatorValueError,
+    IdentifierPrefixWarning,
+    SchemaRefValueError,
+)
 
 # Cache namespace → CSV prefix derivations to avoid repeated string work during parse
 _namespace_prefix_cache: Dict[str, str] = {}
@@ -341,6 +345,10 @@ class Instance:
             self.get_filing_indicators()
         except etree.XMLSyntaxError:
             raise ValueError("Invalid XML format")
+        except SchemaRefValueError:
+            raise  # Let SchemaRefValueError propagate as-is
+        except FilingIndicatorValueError:
+            raise  # Let FilingIndicatorValueError propagate as-is
         except Exception as e:
             raise ValueError(f"Error parsing instance: {str(e)}")
 
@@ -651,6 +659,10 @@ class XmlInstance(Instance):
             self.get_filing_indicators()
         except etree.XMLSyntaxError:
             raise ValueError("Invalid XML format")
+        except SchemaRefValueError:
+            raise  # Let SchemaRefValueError propagate as-is
+        except FilingIndicatorValueError:
+            raise  # Let FilingIndicatorValueError propagate as-is
         except Exception as e:
             raise ValueError(f"Error parsing instance: {str(e)}")
 
@@ -856,12 +868,22 @@ class FilingIndicator:
         self.parse()
 
     def parse(self) -> None:
-        """Parse the XML node with the filing indicator."""
+        """Parse the XML node with the filing indicator.
+
+        Raises:
+            FilingIndicatorValueError: If the filed attribute is not "true", "false", "0", or "1"
+        """
         value = self.filing_indicator_xml.attrib.get(
             "{http://www.eurofiling.info/xbrl/ext/filing-indicators}filed"
         )
         if value:
-            self.value = value == "true"
+            if value not in ("true", "false", "0", "1"):
+                raise FilingIndicatorValueError(
+                    f"Invalid filing indicator value: '{value}'. "
+                    f"The 'filed' attribute must be either 'true', 'false', '0', or '1'.",
+                    offending_value=value,
+                )
+            self.value = value in ("true", "1")
         else:
             self.value = True
         self.table = self.filing_indicator_xml.text