project map script | semantic parcer

superset_tool/utils/fileio.py

@@ -64,7 +64,7 @@ def create_temp_file(content: Optional[bytes] = None, suffix: str = ".zip", mode
                     logger.debug("[create_temp_file][Cleanup] Removed temporary file: %s", resource_path)
             except OSError as e:
                 logger.error("[create_temp_file][Failure] Error during cleanup of %s: %s", resource_path, e)
-# [/DEF:create_temp_file]
+# [/DEF:create_temp_file:Function]
 
 # [DEF:remove_empty_directories:Function]
 # @PURPOSE: Рекурсивно удаляет все пустые поддиректории, начиная с указанного пути.
@@ -88,7 +88,7 @@ def remove_empty_directories(root_dir: str, logger: Optional[SupersetLogger] = N
                 logger.error("[remove_empty_directories][Failure] Failed to remove %s: %s", current_dir, e)
     logger.info("[remove_empty_directories][Exit] Removed %d empty directories.", removed_count)
     return removed_count
-# [/DEF:remove_empty_directories]
+# [/DEF:remove_empty_directories:Function]
 
 # [DEF:read_dashboard_from_disk:Function]
 # @PURPOSE: Читает бинарное содержимое файла с диска.
@@ -105,7 +105,7 @@ def read_dashboard_from_disk(file_path: str, logger: Optional[SupersetLogger] =
     if not content:
         logger.warning("[read_dashboard_from_disk][Warning] File is empty: %s", file_path)
     return content, path.name
-# [/DEF:read_dashboard_from_disk]
+# [/DEF:read_dashboard_from_disk:Function]
 
 # [DEF:calculate_crc32:Function]
 # @PURPOSE: Вычисляет контрольную сумму CRC32 для файла.
@@ -116,7 +116,7 @@ def calculate_crc32(file_path: Path) -> str:
     with open(file_path, 'rb') as f:
         crc32_value = zlib.crc32(f.read())
     return f"{crc32_value:08x}"
-# [/DEF:calculate_crc32]
+# [/DEF:calculate_crc32:Function]
 
 # [DEF:RetentionPolicy:DataClass]
 # @PURPOSE: Определяет политику хранения для архивов (ежедневные, еженедельные, ежемесячные).
@@ -125,7 +125,7 @@ class RetentionPolicy:
     daily: int = 7
     weekly: int = 4
     monthly: int = 12
-# [/DEF:RetentionPolicy]
+# [/DEF:RetentionPolicy:DataClass]
 
 # [DEF:archive_exports:Function]
 # @PURPOSE: Управляет архивом экспортированных файлов, применяя политику хранения и дедупликацию.
@@ -207,7 +207,7 @@ def archive_exports(output_dir: str, policy: RetentionPolicy, deduplicate: bool
                 logger.info("[archive_exports][State] Removed by retention policy: %s", file_path.name)
             except OSError as e:
                 logger.error("[archive_exports][Failure] Failed to remove %s: %s", file_path, e)
-# [/DEF:archive_exports]
+# [/DEF:archive_exports:Function]
 
 # [DEF:apply_retention_policy:Function]
 # @PURPOSE: (Helper) Применяет политику хранения к списку файлов, возвращая те, что нужно сохранить.
@@ -240,7 +240,7 @@ def apply_retention_policy(files_with_dates: List[Tuple[Path, date]], policy: Re
     files_to_keep.update(monthly_files[:policy.monthly])  
     logger.debug("[apply_retention_policy][State] Keeping %d files according to retention policy", len(files_to_keep))  
     return files_to_keep  
-# [/DEF:apply_retention_policy]  
+# [/DEF:apply_retention_policy:Function]
 
 # [DEF:save_and_unpack_dashboard:Function]
 # @PURPOSE: Сохраняет бинарное содержимое ZIP-архива на диск и опционально распаковывает его.
@@ -270,7 +270,7 @@ def save_and_unpack_dashboard(zip_content: bytes, output_dir: Union[str, Path],
     except zipfile.BadZipFile as e:
         logger.error("[save_and_unpack_dashboard][Failure] Invalid ZIP archive: %s", e)
         raise InvalidZipFormatError(f"Invalid ZIP file: {e}") from e
-# [/DEF:save_and_unpack_dashboard]
+# [/DEF:save_and_unpack_dashboard:Function]
 
 # [DEF:update_yamls:Function]
 # @PURPOSE: Обновляет конфигурации в YAML-файлах, заменяя значения или применяя regex.
@@ -291,7 +291,7 @@ def update_yamls(db_configs: Optional[List[Dict[str, Any]]] = None, path: str =
     
     for file_path in dir_path.rglob("*.yaml"):
         _update_yaml_file(file_path, configs, regexp_pattern, replace_string, logger)
-# [/DEF:update_yamls]
+# [/DEF:update_yamls:Function]
 
 # [DEF:_update_yaml_file:Function]
 # @PURPOSE: (Helper) Обновляет один YAML файл.
@@ -352,7 +352,7 @@ def _update_yaml_file(file_path: Path, db_configs: List[Dict[str, Any]], regexp_
                 f.write(modified_content)
         except Exception as e:
             logger.error("[_update_yaml_file][Failure] Error performing raw replacement in %s: %s", file_path, e)
-# [/DEF:_update_yaml_file]  
+# [/DEF:_update_yaml_file:Function]
 
 # [DEF:create_dashboard_export:Function]
 # @PURPOSE: Создает ZIP-архив из указанных исходных путей.
@@ -379,7 +379,7 @@ def create_dashboard_export(zip_path: Union[str, Path], source_paths: List[Union
     except (IOError, zipfile.BadZipFile, AssertionError) as e:
         logger.error("[create_dashboard_export][Failure] Error: %s", e, exc_info=True)
         return False
-# [/DEF:create_dashboard_export]
+# [/DEF:create_dashboard_export:Function]
 
 # [DEF:sanitize_filename:Function]
 # @PURPOSE: Очищает строку от символов, недопустимых в именах файлов.
@@ -387,7 +387,7 @@ def create_dashboard_export(zip_path: Union[str, Path], source_paths: List[Union
 # @RETURN: str - Очищенная строка.
 def sanitize_filename(filename: str) -> str:
     return re.sub(r'[\\/*?:"<>|]', "_", filename).strip()
-# [/DEF:sanitize_filename]
+# [/DEF:sanitize_filename:Function]
 
 # [DEF:get_filename_from_headers:Function]
 # @PURPOSE: Извлекает имя файла из HTTP заголовка 'Content-Disposition'.
@@ -398,7 +398,7 @@ def get_filename_from_headers(headers: dict) -> Optional[str]:
     if match := re.search(r'filename="?([^"]+)"?', content_disposition):
         return match.group(1).strip()
     return None
-# [/DEF:get_filename_from_headers]
+# [/DEF:get_filename_from_headers:Function]
 
 # [DEF:consolidate_archive_folders:Function]
 # @PURPOSE: Консолидирует директории архивов на основе общего слага в имени.
@@ -453,6 +453,6 @@ def consolidate_archive_folders(root_directory: Path, logger: Optional[SupersetL
                 logger.info("[consolidate_archive_folders][State] Removed source directory: %s", source_dir)  
             except Exception as e:  
                 logger.error("[consolidate_archive_folders][Failure] Failed to remove source directory %s: %s", source_dir, e)  
-# [/DEF:consolidate_archive_folders]  
+# [/DEF:consolidate_archive_folders:Function]
 
-# [/DEF:superset_tool.utils.fileio]
+# [/DEF:superset_tool.utils.fileio:Module]