logging

"Пример logging.Logger.\nСреда: встроенный MicroPython FEMM 5.\nСоздаёт объект без глобальной регистрации.\nРезультат: Logger."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.info('N=%d',100)
assert s.getvalue() == 'N=100\n'

"Пример logging.getLogger.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает один и тот же логгер по имени; первый root вызывает basicConfig.\nРезультат: Переиспользуемый Logger с данным именем."

import logging
assert logging.getLogger('course-check') is logging.getLogger('course-check')

"Пример logging.Logger.debug.\nСреда: встроенный MicroPython FEMM 5.\nЗаписывает сообщение уровня DEBUG при достаточном пороге.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.debug('N=%d',100)
assert 'N=100' in s.getvalue()

"Пример logging.debug.\nСреда: встроенный MicroPython FEMM 5.\nОтправляет сообщение уровня DEBUG корневому логгеру.\nРезультат: None."

import logging
logging.debug('FEMM example %s','ok')

"Пример logging.Logger.info.\nСреда: встроенный MicroPython FEMM 5.\nЗаписывает сообщение уровня INFO при достаточном пороге.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.info('N=%d',100)
assert 'N=100' in s.getvalue()

"Пример logging.info.\nСреда: встроенный MicroPython FEMM 5.\nОтправляет сообщение уровня INFO корневому логгеру.\nРезультат: None."

import logging
logging.info('FEMM example %s','ok')

"Пример logging.Logger.warning.\nСреда: встроенный MicroPython FEMM 5.\nЗаписывает сообщение уровня WARNING при достаточном пороге.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.warning('N=%d',100)
assert 'N=100' in s.getvalue()

"Пример logging.warning.\nСреда: встроенный MicroPython FEMM 5.\nОтправляет сообщение уровня WARNING корневому логгеру.\nРезультат: None."

import logging
logging.warning('FEMM example %s','ok')

"Пример logging.Logger.error.\nСреда: встроенный MicroPython FEMM 5.\nЗаписывает сообщение уровня ERROR при достаточном пороге.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.error('N=%d',100)
assert 'N=100' in s.getvalue()

"Пример logging.error.\nСреда: встроенный MicroPython FEMM 5.\nОтправляет сообщение уровня ERROR корневому логгеру.\nРезультат: None."

import logging
logging.error('FEMM example %s','ok')

"Пример logging.Logger.critical.\nСреда: встроенный MicroPython FEMM 5.\nЗаписывает сообщение уровня CRITICAL при достаточном пороге.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.critical('N=%d',100)
assert 'N=100' in s.getvalue()

"Пример logging.critical.\nСреда: встроенный MicroPython FEMM 5.\nОтправляет сообщение уровня CRITICAL корневому логгеру.\nРезультат: None."

import logging
logging.critical('FEMM example %s','ok')

"Пример logging.Logger.log.\nСреда: встроенный MicroPython FEMM 5.\nЗаписывает сообщение произвольного уровня.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.log(logging.INFO,'N=%d',100)
assert 'N=100' in s.getvalue()

"Пример logging.log.\nСреда: встроенный MicroPython FEMM 5.\nВызывает log корневого логгера.\nРезультат: None."

import logging
logging.log(logging.WARNING,'FEMM example %d',1)

"Пример logging.Logger.exception.\nСреда: встроенный MicroPython FEMM 5.\nПишет ERROR и, если передан объект ошибки, её traceback.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.exception('bad input',exc_info=ValueError('negative turns'))

"Пример logging.exception.\nСреда: встроенный MicroPython FEMM 5.\nПишет ERROR и, если передан объект ошибки, её traceback.\nРезультат: None."

import logging
logging.exception('bad input',exc_info=ValueError('negative turns'))

"Пример logging.Logger.setLevel.\nСреда: встроенный MicroPython FEMM 5.\nМеняет порог логгера.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.setLevel(logging.ERROR)
assert not log.isEnabledFor(logging.INFO)

"Пример logging.Logger.isEnabledFor.\nСреда: встроенный MicroPython FEMM 5.\nПроверяет уровень до построения дорогого сообщения.\nРезультат: bool."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
assert log.isEnabledFor(logging.INFO)

"Пример logging.Logger.getEffectiveLevel.\nСреда: встроенный MicroPython FEMM 5.\nИспользует собственный ненулевой уровень, затем root, затем WARNING.\nРезультат: Числовой порог."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
assert log.getEffectiveLevel() == logging.DEBUG

"Пример logging.Logger.addHandler.\nСреда: встроенный MicroPython FEMM 5.\nДобавляет направление вывода; повторный вызов добавляет ещё одну ссылку.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
assert log.hasHandlers()

"Пример logging.Logger.hasHandlers.\nСреда: встроенный MicroPython FEMM 5.\nПроверяет только список текущего Logger.\nРезультат: bool: наличие собственных обработчиков."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
assert log.hasHandlers()

"Пример logging.StreamHandler.\nСреда: встроенный MicroPython FEMM 5.\nСоздаёт потоковый обработчик. close только вызывает flush.\nРезультат: StreamHandler."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
log.info('ok')
assert 'ok' in s.getvalue()

"Пример logging.FileHandler.\nСреда: встроенный MicroPython FEMM 5.\nОткрывает текстовый файл; close закрывает его.\nРезультат: FileHandler."

import logging
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
h=logging.FileHandler(work+'/run.log',mode='w')
l=logging.Logger('file-example',logging.INFO)
l.addHandler(h)
l.info('done')
h.close()
with open(work+'/run.log') as f:
    assert 'done' in f.read()

"Пример logging.Formatter.\nСреда: встроенный MicroPython FEMM 5.\nЗадаёт представление записи журнала.\nРезультат: Formatter."

import logging
f=logging.Formatter('%(message)s')
r=logging.LogRecord()
r.set('run',logging.INFO,'done')
assert f.format(r) == 'done'

"Пример logging.Formatter.format.\nСреда: встроенный MicroPython FEMM 5.\nПодставляет поля записи в шаблон.\nРезультат: Строка без завершающего переноса."

import logging
r=logging.LogRecord()
r.set('run',logging.INFO,'done')
assert logging.Formatter('%(message)s').format(r) == 'done'

"Пример logging.Formatter.usesTime.\nСреда: встроенный MicroPython FEMM 5.\nПроверяет наличие asctime в шаблоне.\nРезультат: bool."

import logging
assert logging.Formatter('%(asctime)s').usesTime()

"Пример logging.Handler.setLevel.\nСреда: встроенный MicroPython FEMM 5.\nФильтрует сообщения уже после фильтра логгера.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
h.setLevel(logging.ERROR)
log.info('hidden')
assert s.getvalue() == ''

"Пример logging.Handler.setFormatter.\nСреда: встроенный MicroPython FEMM 5.\nМеняет формат обработчика.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
h.setFormatter(logging.Formatter('%(name)s'))
log.info('ok')
assert 'femm-example' in s.getvalue()

"Пример logging.Handler.close.\nСреда: встроенный MicroPython FEMM 5.\nБазовый close пустой; StreamHandler сбрасывает поток, FileHandler закрывает файл.\nРезультат: None."

import logging
import io
s=io.StringIO()
log=logging.Logger('femm-example',logging.DEBUG)
h=logging.StreamHandler(s)
h.setFormatter(logging.Formatter('%(message)s'))
log.addHandler(h)
h.close()
assert s.getvalue() == ''

"Пример logging.addLevelName.\nСреда: встроенный MicroPython FEMM 5.\nРегистрирует имя уровня до его записи.\nРезультат: None."

import logging
logging.addLevelName(25,'RESULT')
l=logging.Logger('levels',25)
assert l.isEnabledFor(25)

"Пример logging.basicConfig.\nСреда: встроенный MicroPython FEMM 5.\nНастраивает корневой журнал. При существующих handlers без force изменений нет.\nРезультат: None."

import logging
import io
s=io.StringIO()
logging.basicConfig(stream=s,format='%(message)s',level=logging.INFO,force=True)
logging.info('done')
assert s.getvalue() == 'done\n'

"Пример logging.shutdown.\nСреда: встроенный MicroPython FEMM 5.\nЗакрывает все зарегистрированные обработчики.\nРезультат: None."

import logging
logging.shutdown()