pip/doc/pages/application.md

~english \page application Application-level tools ~russian \page application Инструменты уровня приложения

~english

The Application module provides classes commonly needed at program startup and runtime:

• PICLI — command-line argument parser. Add named arguments (e.g. \c addArgument("debug") for \c -d / \c --debug), check presence with \a hasArgument(), optionally read values. Used in \ref using_basic for console and debug flags.
• PILog — high-level logging with categories and levels. Configure sinks and severity; write log lines from anywhere in the process.
• PISystemMonitor — snapshot of system resources (CPU, memory, etc.). Query current stats or subscribe to periodic updates.
• PISingleApplication — ensure only one instance of the application runs; optional inter-process messaging when a second instance is started.
• PITranslator — translation support: load catalogs, select language, translate strings at runtime.

All are included via the main PIP library or the Application umbrella (\a piapplicationmodule.h). For CLI and logging, see \ref using_basic; for full API details see the headers \a picli.h, \a pilog.h, \a pisystemmonitor.h, \a pisingleapplication.h, \a pitranslator.h.

~russian

Модуль Application предоставляет классы, часто нужные при запуске и работе приложения:

• PICLI — разбор аргументов командной строки. Добавление именованных аргументов (\c addArgument("debug") для \c -d / \c --debug), проверка наличия \a hasArgument(), при необходимости чтение значений. Используется в \ref using_basic для флагов консоли и отладки.
• PILog — логирование с категориями и уровнями. Настройка приёмников и уровня детализации; запись строк лога из любой части процесса.
• PISystemMonitor — снимок ресурсов системы (CPU, память и т.д.). Запрос текущей статистики или подписка на периодические обновления.
• PISingleApplication — гарантия единственного экземпляра приложения; при необходимости обмен сообщениями между процессами при запуске второго экземпляра.
• PITranslator — поддержка перевода: загрузка каталогов, выбор языка, перевод строк в runtime.

Всё подключается через основную библиотеку PIP или зонтичный заголовок (\a piapplicationmodule.h). Для CLI и лога см. \ref using_basic; детали API — в заголовках \a picli.h, \a pilog.h, \a pisystemmonitor.h, \a pisingleapplication.h, \a pitranslator.h.