tma_import_parser.py¶

Overview¶

This file contains 25 documented elements.

Classes¶

TMAFieldMapping¶

Mappatura dei campi tra vari formati e il database TMA

Methods¶

find_field_mapping(cls, field_name)¶

Trova il campo del database corrispondente a un nome di campo del file

validate_field_value(cls, field, value)¶

Valida il valore di un campo specifico

BaseParser¶

Classe base astratta per i parser

Inherits from: ABC

Methods¶

init(self, file_path)¶

Initializes a new instance of BaseParser with the specified file path. Sets file_path to the provided string argument and initializes errors, warnings, and data as empty lists.

parse(self)¶

Metodo astratto per il parsing del file

validate_required_fields(self, record)¶

Valida i campi obbligatori

clean_value(self, value)¶

Pulisce e normalizza i valori

ExcelParser¶

Parser per file Excel

Inherits from: BaseParser

Methods¶

parse(self)¶

Parsing di file Excel

CSVParser¶

Parser per file CSV

Inherits from: BaseParser

Methods¶

init(self, file_path, delimiter, encoding)¶

Initializes a CSVParser instance by invoking the parent BaseParser constructor with the provided file_path, then storing the delimiter and encoding as instance attributes.

Parameters: - file_path (str): Path to the CSV file to be parsed. - delimiter (str, optional): Character used to separate fields in the CSV file. Defaults to ','. - encoding (str, optional): Character encoding used when reading the file. Defaults to 'utf-8'.

parse(self)¶

Parsing di file CSV

JSONParser¶

Parser per file JSON

Inherits from: BaseParser

Methods¶

parse(self)¶

Parsing di file JSON

XMLParser¶

Parser per file XML

Inherits from: BaseParser

Methods¶

parse(self)¶

Parsing di file XML

DOCXParser¶

Parser per file DOCX

Inherits from: BaseParser

Methods¶

init(self, file_path, use_festos_parser, db_session)¶

No description available. Initializes a DOCXParser instance by invoking the parent BaseParser constructor with the provided file_path. Stores the use_festos_parser flag, which controls whether the Festos-specific parsing strategy is used, and the db_session database session object as instance attributes.

parse(self)¶

Parsing di file DOCX

TMAImportManager¶

Manager principale per l'importazione dei dati TMA

Methods¶

init(self, db_manager)¶

Initializes a TMAImportManager instance with the provided database manager and a predefined mapping of file extension parsers. The db_manager parameter is stored as an instance attribute for use during import operations. The parsers dictionary maps the file extensions '.xlsx', '.xls', '.csv', '.json', '.xml', and '.docx' to their corresponding parser classes (ExcelParser, CSVParser, JSONParser, XMLParser, and DOCXParser).

import_file(self, file_path, custom_mapping, use_festos_parser)¶

Importa un file nel database TMA

Args: file_path: percorso del file da importare custom_mapping: mapping personalizzato dei campi (opzionale) use_festos_parser: usa il parser specifico per Festos (per file DOCX)

Returns: Tuple con (numero record importati, lista errori, lista warning)

import_batch(self, file_paths)¶

Importa multipli file in batch