📁 Документация Filework

Субпакет для работы с файлами
Полная документация модулей для работы с файлами различных форматов в пакете Hrenpack.
📄 __init__.py
Базовые классы для работы с текстовыми файлами и специализированными форматами
TextFile
Базовый класс для работы с текстовыми файлами
Основные методы: read(), rewrite(), add_data(), read_lines(), edit_line(), copy()
SRTSubtitleFile
Класс для работы с файлами субтитров SRT
Методы: read_subtitle(), edit_line_subtitle_text(), edit_timecode()
ConfigurationFile
Класс для работы с INI-конфигурационными файлами
Методы: get_value(), set_value(), get_boolean(), get_int(), get_float()
JavaScriptObjectNotationFile
Класс для работы с JSON-файлами
Методы: get_value(), set_value(), delete_value(), save()
CommaSeparatedValuesFile
Класс для работы с CSV-файлами
Методы: read_data(), write_data()
extension_check(path: str, *extensions)
Проверяет расширение файла на соответствие ожидаемым
create_file_if_not_exists(path)
Создает файл, если он не существует
write_file_if_not_exists(path: str, text: str = '')
Создает и записывает файл, если он не существует
💻 source_code.py
Классы для работы с исходным кодом программ (в разработке)
ProgrammingLanguageSourceFile
Базовый класс для файлов исходного кода
Методы: online_compile() - компиляция через онлайн-сервис
PythonFile
Специализированный класс для Python-файлов
Методы: run() - выполнение кода Python
CompileError
Исключение для ошибок компиляции
📊 xml.py
Классы для работы с XML и HTML файлами
XMLParser
Расширенный парсер XML на основе BeautifulSoup
Методы: del_tag() - удаление тегов по имени
ParserMixin
Миксин с автоматическим сохранением для XML-парсеров
Особенность: Все методы автоматически сохраняют изменения
ExtensibleMarkupLanguageFile
Класс для работы с XML-файлами
Методы: Все методы BeautifulSoup с автосохранением
HyperTextMarkupLanguageFile
Класс для работы с HTML-файлами
Особенность: Использует HTML-парсер по умолчанию
xml_save(func)
Декоратор для автоматического сохранения после методов парсера

🎯 Основные возможности Filework

Поддерживаемые форматы: TXT, INI, JSON, CSV, SRT, XML, HTML, исходный код

Кодировки: Поддержка различных кодировок, UTF-8 по умолчанию

Автосохранение: Автоматическое сохранение изменений в XML/HTML файлах

Валидация: Проверка расширений файлов и корректности форматов

Безопасность: Подтверждение опасных операций (удаление файлов)