Лучшие практики для входа в Python

Question

Я написал простой пакет Python, который имеет набор функций, которые выполняют простые операции (манипулирование данными).Я пытаюсь улучшить пакет и добавить больше функций для ведения журнала, что приводит меня к этому вопросу.

Должен ли я ожидать, что пользователь пакета передаст дескриптор файла или обработчик файла модуля регистрации python в методы пакета, или сам пакет должен иметь свой собственный модуль регистрации, который методы внутриПакет наймите.

Я вижу преимущества (пользовательский контроль ведет журнал и может поддерживать поток вызовов функций на основе одного и того же обработчика) и недостатки (пользовательский регистратор недостаточно хорош), однако, каковы / являются наилучшими практиками в этомдело.

Answer 1

В вашем модуле создайте объект регистратора:

import logging
LOGGER = logging.getLogger(__name__)

и затем вызовите соответствующие функции для этого объекта:

LOGGER.debug('you probably dont care about this')
LOGGER.info('some info message')
LOGGER.error('whoops, something went wrong')

Если пользователь правильно настроил подсистему журналирования,тогда сообщения будут автоматически отправляться туда, куда их хочет пользователь (файл, stderr, syslog и т. д.)