mirror of https://github.com/pese-git/cherrypick.git synced 2026-01-24 05:25:19 +00:00

Files

Sergey Penkovsky e0a5ae66f6 fix(docs): comment out all broken links to allow successful Docusaurus build

- Commented out references to non-existent files and examples in both English and Russian documentation:
  - circular-dependency-detection.md
  - logging.md
  - documentation-links.md
  - using-annotations.md
- This fix prevents build failures caused by unresolved links in Docusaurus for both locales.
- All offending links are now non-blocking comments, allowing the site to build and deploy successfully until the related pages are added.

2025-08-14 16:24:57 +03:00

2.8 KiB

Raw Blame History

sidebar_position

sidebar_position
2

Логирование

CherryPick позволяет логировать все события и ошибки DI с помощью расширяемого observer-механизма.

Кастомные Observer'ы

Вы можете передавать свою реализацию CherryPickObserver в root- или любой подскоуп. Это позволяет централизовать и настраивать логирование, направлять логи в консоль, файл, сторонние сервисы или системы как Talker.

Пример: вывод всех событий в консоль

import 'package:cherrypick/cherrypick.dart';

void main() {
  // Встроенный PrintCherryPickObserver для консоли
  final observer = PrintCherryPickObserver();
  final scope = CherryPick.openRootScope(observer: observer);
  // Все события и ошибки DI будут выведены!
}

Пример: расширенное логирование через Talker

Для более гибкого логирования или UI-оверлеев можно использовать observer наподобие talker_cherrypick_logger:

import 'package:cherrypick/cherrypick.dart';
import 'package:talker/talker.dart';
import 'package:talker_cherrypick_logger/talker_cherrypick_logger.dart';

void main() {
  final talker = Talker();
  final observer = TalkerCherryPickObserver(talker);
  CherryPick.openRootScope(observer: observer);
  // Все события попадают в Talker!
}

Поведение по умолчанию

По умолчанию логирование "тихое" (SilentCherryPickObserver) для production — нет вывода без observer'а.
Можно назначить observer для любого скоупа.

Возможности Observer'а

Регистрация зависимостей
Получение/создание/удаление экземпляров
Установка/удаление модулей
Открытие/закрытие скоупов
Кэш-хиты/мимо
Обнаружение циклов
Диагностика, предупреждения, ошибки

Когда применять

Подробное логирование в dev/test окружениях
Передача логов в основную систему/аналитику
Отладка и профилирование DI

2.8 KiB Raw Blame History Unescape Escape