mario.parse_istat(
path: str,
*,
year: int,
table: str = 'IOT',
iot_mode: str = 'product',
level: str = '63',
price: str = 'current',
valuation: str = 'basic',
download: bool = False,
overwrite_download: bool = False,
edition: str = 'latest',
page_url: str | None = None,
model: str = 'Database',
name: str | None = None,
calc_all: bool = False,
**kwargs,
) → object#

Parse official ISTAT input-output workbooks from local files or a downloaded release.

This parser targets the official ISTAT release bundles published on the public release pages for the Italian input-output system. The supported source format is the Excel content distributed inside the official release zip, not other ad hoc spreadsheets.

Parameters:

  • path (str) – local workbook, extracted release directory, or release zip. When download=True, this should be the destination directory where the official ISTAT release zip will be stored and extracted.

  • year (int) – reference year to select from the multi-year workbook.

  • table (str, optional) – one of "IOT" or "SUT".

  • iot_mode (str, optional) – ISTAT symmetric table layout when table='IOT'. Supported values are product for product-by-product and industry for branch-by-branch.

  • level (str, optional) – SUT aggregation level when table='SUT'. Supported values are "63" and "20".

  • price (str, optional) – SUT price system when table='SUT'. Supported values are current and pyp.

  • valuation (str, optional) – SUT use-table valuation when table='SUT'. Supported values are basic and purchaser.

  • download (bool, optional) – when True, download the official ISTAT release zip into path before parsing it locally.

  • overwrite_download (bool, optional) – when download=True, overwrite an existing local archive/extraction.

  • edition (str, optional) – known ISTAT release page label used by the downloader, for example "2020-2022" or "2015-2020". Ignored when download=False.

  • page_url (str, optional) – explicit ISTAT release page URL for the downloader. Ignored when download=False.