Python: настройка программы через внешние файлы конфигурации и локализации

Расширенные примеры работы с ресурсными файлами

1. Конфигурация с вложенными структурами и валидацией (pydantic + yaml)

Использование pydantic для типизированного чтения YAML-конфигурации:

from pydantic import BaseModel, Field
import yaml
from typing import Optional

class DatabaseConfig(BaseModel):
    host: str = 'localhost'
    port: int = 5432
    user: str = 'admin'
    password: Optional[str] = None

class AppConfig(BaseModel):
    app_name: str
    debug: bool = False
    database: DatabaseConfig = DatabaseConfig()

with open('app_config.yaml', 'r') as f:
    raw = yaml.safe_load(f)
    config = AppConfig(**raw)

print(config.database.host)  # '127.0.0.1'

127.0.0.1

2. Ленивая загрузка переводов с кэшированием

Реализация загрузчика i18n, который загружает файлы только при обращении к языку:

from functools import lru_cache
import json

class TranslationLoader:
    def __init__(self, base_path: str = 'locales'):
        self.base_path = base_path

    @lru_cache(maxsize=None)
    def load(self, lang: str) -> dict:
        try:
            with open(f'{self.base_path}/{lang}.json', 'r', encoding='utf-8') as f:
                return json.load(f)
        except FileNotFoundError:
            return {}

    def get(self, lang: str, key: str, default=None) -> str:
        data = self.load(lang)
        return data.get(key, default or key)

loader = TranslationLoader()
print(loader.get('ru', 'hello'))
print(loader.get('ru', 'goodbye'))

Здравствуйте
До свидания

3. Чтение конфигурации из INI-файла с секциями и поддержкой fallback

import configparser
config = configparser.ConfigParser()
config.read('settings.ini', encoding='utf-8')

# Безопасное получение параметров с типом и значением по умолчанию
timeout = config.getfloat('Connection', 'timeout', fallback=30.0)
print('Timeout:', timeout)

# Получение всех ключей в секции
items = dict(config.items('General'))
print('General section:', items)

Timeout: 30.0
General section: {'debug': 'true', 'loglevel': 'info'}

4. Создание своего менеджера ресурсов с кэшированием в памяти

Класс ResourceManager загружает файлы один раз и хранит их в словаре:

import json, yaml, configparser
from pathlib import Path

class ResourceManager:
    _cache = {}

    @classmethod
    def load(cls, path: str, format: str = 'auto'):
        path = Path(path)
        if path in cls._cache:
            return cls._cache[path]

        if not path.exists():
            raise FileNotFoundError(f'Ресурс {path} не найден')

        ext = format if format != 'auto' else path.suffix
        if ext == '.json':
            with open(path, 'r', encoding='utf-8') as f:
                data = json.load(f)
        elif ext in ('.yaml', '.yml'):
            with open(path, 'r', encoding='utf-8') as f:
                data = yaml.safe_load(f)
        elif ext == '.ini':
            config = configparser.ConfigParser()
            config.read(path, encoding='utf-8')
            data = {s: dict(config.items(s)) for s in config.sections()}
        else:
            raise ValueError(f'Неподдерживаемый формат {ext}')

        cls._cache[path] = data
        return data

# Использование
config = ResourceManager.load('config.yaml')
print(config.get('database'))

{'host': 'localhost', 'port': 3306}

5. Пакетная загрузка всех переводов для многопоточного приложения

import threading
import json

class Localization:
    _data = {}
    _lock = threading.Lock()

    @classmethod
    def load_language(cls, lang: str, filepath: str):
        with cls._lock:
            with open(filepath, 'r', encoding='utf-8') as f:
                cls._data[lang] = json.load(f)

    @classmethod
    def get_text(cls, lang: str, key: str, default=None):
        return cls._data.get(lang, {}).get(key, default or key)

# В отдельных потоках:
threading.Thread(target=Localization.load_language, args=('ru', 'locales/ru.json')).start()
threading.Thread(target=Localization.load_language, args=('en', 'locales/en.json')).start()

# После загрузки (требуется синхронизация)
print(Localization.get_text('ru', 'hello'))

Привет

6. Использование библиотеки click для автоматизации создания .mo файлов

Сборка переводов из .po в .mo через Python:

import subprocess
from pathlib import Path

locale_dir = Path('locale')
for lang_dir in locale_dir.iterdir():
    if lang_dir.is_dir():
        po_file = lang_dir / 'LC_MESSAGES' / 'messages.po'
        mo_file = lang_dir / 'LC_MESSAGES' / 'messages.mo'
        if po_file.exists():
            subprocess.run(['msgfmt', str(po_file), '-o', str(mo_file)], check=True)
            print(f'Компилирован {mo_file}')

Компилирован locale/ru/LC_MESSAGES/messages.mo
Компилирован locale/ja/LC_MESSAGES/messages.mo