XML Instance

The xml-instance module contains all the classes related to XBRL-XML instance files. It contains the attributes Scenario, Context and Facts.

The main purpose is to extract and classify the data. In the xbrl file, the basic unit is the fact, form by a unique value and its decimals (precision), context and currency.

This facts are grouped by a context. In xbrl files, it is represented with an id, and contains info related to the entity and period where facts belongs to. Also, an attribute named scenario appears related to the context. Its main function is parsing the xml-instance, integrating the dimension of the taxonomy’s variable with the context.

Instance Class

class xbridge.xml_instance.Instance(path: str | bytes | _ElementTree | None = None)

Bases: object

Class representing an XBRL XML instance file. Its attributes are the characters contained in the XBRL files. Each property returns one of these attributes.

Parameters:: path – File path to be used

property base_currency: str | None: Returns the base currency of the instance file

property contexts: Dict[str, Context] | None: Returns the Context of the instance file.

property decimals_monetary: int | None: Returns the single value for monetary values in the instance.

property decimals_percentage: int | None: Returns the single value for percentage values in the instance.

property entity: str: Returns the entity of the instance file.

property facts: List[Fact] | None: Returns the facts of the instance file.

property facts_list_dict: List[Dict[str, Any]] | None: Returns a list of dictionaries with the facts of the instance file.

property filing_indicators: List[FilingIndicator] | None: Returns the filing indicators of the instance file.

get_contexts() → None: Extracts Context from the XML instance file.

get_facts() → None: Extracts facts from the XML instance file.

get_facts_list_dict() → None: Generates a list of dictionaries with the facts of the instance file.

get_filing_indicators() → None: Extracts filing indicators from the XML instance file.

get_module_code() → None: Extracts the module name from the XML instance file.

get_units() → None: Extracts the base currency of the instance

property identifier_prefix: str: Returns the identifier prefix of the instance file.

property instance_df: DataFrame | None: Returns a pandas DataFrame with the facts of the instance file.

property module_code: str | None: Returns the module name of the instance file.

property module_ref: str | None: Returns the module reference of the instance file.

property namespaces: Dict[str | None, str]: Returns the namespaces is of the instance file.

parse() → None: Parses the XML file into the library objects.

property period: str | None: Returns the period of the instance file

to_df() → None: Generates a pandas DataFrame with the facts of the instance file.

property units: Dict[str, str] | None: Returns the units of the instance file

validate_entity(context: str) → None: Validates that a certain Context does not add a second entity (i.e., the instance contains data only for one entity).

Scenario Class

class xbridge.xml_instance.Scenario(scenario_xml: _Element | None = None)

Bases: object

Class for the scenario of a Context. It parses the XML node with the scenario created and gets a value that fits with the scenario created from the XML node.

static get_value(child_scenario: _Element) → str: Gets the value for dimension from the XML node with the scenario.

parse() → None: Parses the XML node with the scenario

Context Class

class xbridge.xml_instance.Context(context_xml: _Element)

Bases: object

Context class.

Class for the context of a fact. Its attributes are id, entity, period and scenario.

Returns a dictionary which has as keys the entity and the period.

property entity: str: Returns the entity of the Context.

property id: str: Returns the id of the Context.

parse() → None: Parses the XML node with the Context.

property period: str: Returns the period of the Context.

property scenario: Scenario: Returns the scenario of the Context.

Fact Class

class xbridge.xml_instance.Fact(fact_xml: _Element)

Bases: object

Class for the facts of an instance. Returns the facts of the instance with information such as the value, its decimals, Context and units.

parse() → None: Parse the XML node with the fact.

Filing Indicator Class

class xbridge.xml_instance.FilingIndicator(filing_indicator_xml: _Element)

Bases: object

Class for the filing indicator of an instance. Returns the filing Indicator value and also a table with a Context

parse() → None: Parse the XML node with the filing indicator.