В крайнем случае запятая: В крайнем случае, в любом случае, в таком случае

Создан 20 июн.

59144 серебряных знака1111 бронзовых знаков

Не тот ответ, который вы ищете? Посмотрите другие вопросы с метками visual-studio или задайте свой вопрос.

Ваша конфиденциальность

Нажимая «Принять все файлы cookie», вы соглашаетесь, что Stack Exchange может хранить файлы cookie на вашем устройстве и раскрывать информацию в соответствии с нашей Политикой в ​​отношении файлов cookie.

Принимать все файлы cookie Настроить параметры

Слово, пожалуйста: некоторые запятые могут вызвать паузу в редакторе.

Многих людей учат, что запятая ставится везде, где вы хотите обозначить паузу.На первый взгляд кажется, что эта система работает нормально. Часто именно так и поступают запятые. Но не всегда.

Следование этому упрощенному правилу может привести к ошибкам, из-за которых редакторы вроде меня могут вырезать много запятых. Вот несколько типов запятых, которые попадают на пол в моей монтажной.

Запятая между несогласованными прилагательными. Возьмите фразу вроде «На новом курорте есть потрясающее казино площадью 10 000 квадратных футов». Эта первая запятая — перед 10,000. Он конченый. Запятые идут между так называемыми координатными прилагательными, но не между нескоординированными прилагательными.Что такое координатное прилагательное? Его можно было бы логически заменить координирующим союзом «и».

Вставьте «и» в наш пример предложения, и вы получите «потрясающее казино площадью 10 000 квадратных футов». Это не потрясающее казино площадью 10 000 квадратных футов. Это потрясающее казино площадью 10 000 квадратных футов. Очевидно, здесь играет роль личное суждение. Но по моему мнению, «потрясающее казино площадью 10 000 квадратных футов» не так естественно, как «потрясающее казино площадью 10 000 квадратных футов».

Другой способ понять это — то, что прилагательные-координаты изменяют одно и то же существительное независимо. Сравните «Он был милым, добрым, щедрым парнем» с «На нем была ярко-желтая рубашка с воротником». Видите, как в первом примере прилагательные не зависят от существительного? И посмотрите, как во втором примере прилагательные, похоже, имеют кумулятивный эффект? Рубашка не была ярко-желтой. Он был ярко-желтым. Вот в чем разница. Вот почему между этими прилагательными не ставится запятая.

Координатные прилагательные часто могут меняться местами, не влияя на смысл предложения: «Он был щедрым, милым, добрым парнем.Несогласованные прилагательные не могут: «Он носил яркую рубашку с желтым воротником».

Пункты, связанные с союзом: «Это веселое семейное занятие будет развлекать всех детей в течение нескольких часов, но не съедает ваш отпускной бюджет», кажется, вполне приемлемым в том виде, в каком они есть. Но он содержит запятую другого типа, которую я удаляю. Но если бы в это предложение было вставлено еще одно слово, слово «оно» перед словом «не будет», запятая осталась бы. Почему? Потому что есть правило, согласно которому в большинстве случаев следует использовать запятую для разделения полных предложений, соединенных союзом.Для полного предложения нужны подлежащее и глагол. В нашем примере после «но» нет темы. Есть только глагол (не), который разделяет подлежащее с предыдущим глаголом (не). Итак, здесь нет запятых.

Оксфордские запятые: в словах «красный, белый и синий» моя работа — удалить запятую перед «и». Но дело не в том, правильно или неправильно. Это просто вопрос стиля. Издатели книг и журналов, как правило, предпочитают эту запятую, называемую оксфордской или серийной запятой, тогда как в новостях и руководствах по деловому стилю она не используется.

Поэтому, когда у вас есть три или более элемента в списке, а последнему предшествует союз вроде «и», поставьте запятую перед «и», если вы хотите подражать книгам и журналам. Но если вы, как и я, следите за новостным стилем, запятую нужно убрать.

Многие люди твердо придерживаются мнения об оксфордской запятой. Он очень популярен среди людей, которые обращают внимание на подобные вещи. Распространенным аргументом является то, что оксфордская запятая нужна, чтобы понять предложение вроде «Я хочу поблагодарить своих родителей, Бога и Бетти.«Без второй запятой кажется, что Бог и Бетти — родители говорящего.

Но этот пример прооксфордской запятой упускает один маленький момент: если бы первый элемент в списке был единственным, оксфордская запятая была бы вредна, а не помогала бы: «Я хочу поблагодарить моего отца, Бога и Бетти».

ИЮНЬ CASAGRANDE — автор книги «Лучшая книга по пунктуации периода». С ней можно связаться по адресу [email protected].

Новая фаговая терапия спасает пациента с бактериальной инфекцией с множественной лекарственной устойчивостью

Ученые и врачи Медицинской школы Сан-Диего Калифорнийского университета, работая с коллегами из Университета им.Медицинский исследовательский центр С. Военно-морского флота — Управление исследований биологической защиты (NMRC-BDRD), Техасский университет A&M, биотехнологическая компания из Сан-Диего и другие места успешно использовали экспериментальную терапию с использованием бактериофагов — вирусов, которые нацелены на определенные штаммы бактерий и потребляют их. лечить находящегося на грани смерти пациента от бактерии с множественной лекарственной устойчивостью.

Фаговая терапия

Фаговая терапия Зараженный бактерией с множественной лекарственной устойчивостью, Том Паттерсон находился в коматозном состоянии и находился на грани смерти.Врачи и ученые из Калифорнийского университета в Сан-Диего со многими сотрудниками использовали экспериментальную бактериофаговую терапию — вирусы, нацеленные на бактерии и потребляющие их, — чтобы спасти его жизнь. Успех может стать катализатором разработки новых средств защиты от растущей глобальной угрозы устойчивости к противомикробным препаратам.

Терапевтический подход, представленный в рецензируемом журнале, должен быть представлен завтра в устной презентации Бисваджита Бисваса, доктора медицины, на праздновании столетия исследований бактериофагов в Институте Пастера в Париже. соавторы исследования и руководитель отдела фагов в отделе геномики и биоинформатики NMRC-BDRD.27 апреля — День терапии человеческими фагами, приуроченный к 100-летию клинических исследований, начатых Феликсом д’Эреллем, французско-канадским микробиологом из Института Пастера, которому приписывают совместное открытие бактериофагов с британским бактериологом Фредериком Творт.

Авторы говорят, что это тематическое исследование может стать еще одним катализатором для разработки новых средств защиты от растущей глобальной угрозы устойчивости к противомикробным препаратам, от которой, по оценкам Всемирной организации здравоохранения, к 2050 году погибнет не менее 50 миллионов человек в год.Основываясь на успехе этого дела, в сотрудничестве с NMRC Калифорнийский университет в Сан-Диего изучает варианты создания нового центра для продвижения исследований и разработки методов лечения на основе бактериофагов.

«Когда стало ясно, что все антибиотики не работают и Том может умереть, мы обратились в FDA с просьбой о подаче заявки на срочное исследование нового лекарства, чтобы испытать бактериофаги», — сказал ведущий автор. Роберт «Чип» Скули, доктор медицины, профессор медицины, заведующий отделением инфекционных болезней Медицинской школы Калифорнийского университета в Сан-Диего и главный врач, ведущий дело.

«Насколько нам известно, он является первым пациентом в Соединенных Штатах с обширной системной инфекцией, который лечится с помощью этого подхода с использованием внутривенных бактериофагов. После того, как он был на грани смерти в коме, он достаточно хорошо выздоровел, чтобы вернуться к работе. Конечно, это всего лишь один пациент, один случай. Мы еще не до конца понимаем потенциал — и ограничения — клинической терапии бактериофагами, но это беспрецедентная и примечательная история, и, учитывая глобальную угрозу здоровью организмов с множественной лекарственной устойчивостью, мы должны стремиться к ней.”

Бактериофаги (зеленые), атакующие бактерии (оранжевые). Изображение любезно предоставлено Graham Beards.

Заражение в отпуске

Состояние Паттерсона ухудшилось, и 3 декабря 2015 года он был доставлен во Франкфурт, Германия, где врачи обнаружили псевдокисту поджелудочной железы, скопление жидкости вокруг поджелудочной железы. Жидкость сливали, а содержимое культивировали. Паттерсон заразился штаммом с множественной лекарственной устойчивостью Acinetobacter baumannii , условно-патогенный и часто смертельный патоген.Бактерия оказалась особенно проблематичной в больницах и на Ближнем Востоке, поскольку многие раненые ветераны и солдаты возвращаются в США с хроническими инфекциями.

Первоначально было доказано, что единственными антибиотиками, оказавшими какое-либо действие, была комбинация меропенема, тигециклина и колистина, лекарство последней инстанции, поскольку оно часто вызывает, помимо других побочных эффектов, повреждение почек. Состояние Паттерсона стабилизировалось в достаточной степени, и 12 декабря 2015 года его перевезли по воздуху из Германии в отделение интенсивной терапии (ICU) больницы Торнтон в Калифорнийском университете в Сан-Диего.По прибытии было обнаружено, что его бактериальный изолят стал устойчивым ко всем этим антибиотикам.

В больнице Торнтон, которая теперь является частью медицинского центра Джейкобса, Паттерсон начал выздоравливать, перейдя из отделения интенсивной терапии в обычную палату. Но за день до запланированной выписки в учреждение долгосрочной неотложной помощи внутренний дренаж, предназначенный для локализации его инфекции и сдерживания ее, соскользнул, в результате чего бактерии попали в его брюшную полость и кровоток. Паттерсон сразу же испытал септический шок.Его сердце забилось быстрее. Он не мог дышать. У него поднялась температура, и он впал в кому, которая продлилась большую часть следующих двух месяцев. Фактически он умирал.

«Я не помню этот период своей жизни», — вспоминал Паттерсон. «Было так много боли, что ты почти не можешь с ней справиться. Я счастлив не вспоминать.

Strathdee, его жена, не привыкать к ужасам болезней. В качестве эпидемиолога-инфекциониста и директора Института глобального здравоохранения Калифорнийского университета в Сан-Диего она работала по всему миру, от Индии до Афганистана и Мексики, пытаясь снизить уровень ВИЧ-инфекции и смертности.

«Настал момент, когда он становился все слабее и слабее, и я не хотел его терять. Я не был готов отпустить его, поэтому взял его за руку и сказал: «Дорогой, они делают все, что могут, и нет ничего, что могло бы убить этого жука, поэтому, если вы хотите драться, вам нужно бороться. Вы хотите, чтобы я нашел альтернативные методы лечения? Мы не можем оставить камня на камне ».

Том вспомнил этот момент:« Я смутно помню, как вы говорили: «Вы хотите, чтобы я попробовал или нет, потому что это будет трудное время, и нет уверенности, что это сработает».«Я помню, как сжал твою руку, но это была всего лишь вспышка».

Strathdee начал исследования. Коллега упомянул, что его друг приехал в Тбилиси, Грузия, чтобы пройти «фаговую терапию» от тяжелого состояния и был «чудесным образом излечен». Стратди узнала о бактериофагах, когда была студенткой, но они не были частью основной медицинской доктрины. Она обратилась за помощью к незнакомцам из сообщества исследователей фагов и к своему коллеге Чипу Скули.

Бактериофаги — это повсеместно распространенные вирусы, встречающиеся везде, где существуют бактерии.По оценкам, на планете более 10 ³¹ бактериофагов. Это на десять миллионов триллионов триллионов больше, чем у любого другого организма на Земле, включая бактерии, вместе взятые. Каждый из них эволюционировал, чтобы заразить конкретного бактериального хозяина с целью размножения, не затрагивая другие клетки организма.

Идея их терапевтического использования не нова. Описанная столетие назад фаговая терапия была популярна в 1920-х и 1930-х годах для лечения различных типов инфекций и состояний, но результаты были противоречивыми и не имели научного подтверждения.Появление антибиотиков в 1940-х годах отодвинуло фаговую терапию в сторону, за исключением некоторых регионов Восточной Европы и бывшего Советского Союза, где она оставалась темой активных исследований.

При сокращении возможностей Стрэтди, Скули и его коллеги обратились за помощью. Они нашли много исследователей, готовых помочь. Три группы обладали подходящими фагами, которые были активны против конкретной бактериальной инфекции Паттерсона: Управление исследований биологической защиты NMRC в Фредерике, штат Мэриленд; Центр фаговых технологий Техасского университета A&M; и AmpliPhi, биотехнологическая компания из Сан-Диего, специализирующаяся на терапии с использованием бактериофагов.Исследовательская группа из Государственного университета Сан-Диего, возглавляемая микробным экологом Форестом Роуэром, доктором философии, очистила образцы фагов для клинического использования.

С экстренного разрешения Управления по санитарному надзору за качеством пищевых продуктов и медикаментов каждый источник предоставил врачам Калифорнийского университета в Сан-Диего штаммы фагов для лечения Паттерсона без гарантии, что какой-либо из штаммов действительно подействует. «Это одна из замечательных сторон всего этого опыта, — сказал Скули, — невероятного и быстрого сотрудничества между людьми, разбросанными по всему миру.Это было отчаянное время, и люди действительно активизировались ».

Фаговая терапия обычно проводится местно или перорально. В случае Паттерсона фаги были введены через катетеры в его брюшную полость и внутривенно для борьбы с более широкой системной инфекцией, чего не делали в США в эпоху антибиотиков. «Это делает их более эффективными», — сказал Скули. «Действие находится на стыке пациента и организма».

С настройкой и корректировкой — его врачи учились на лету — Паттерсон начал улучшаться.Он вышел из комы в течение трех дней после начала внутривенной фаговой терапии. «Том проснулся, повернулся к дочери и сказал:« Я люблю тебя », — вспоминал Скули. Паттерсон вскоре был отлучен от респиратора и лекарств от кровяного давления.

Роберт «Чип» Скули, доктор медицины, профессор медицины и заведующий отделением инфекционных болезней Медицинской школы Калифорнийского университета в Сан-Диего.

«Для лечащего врача это было непросто, — сказал Скули. «Обычно вы знаете, какая должна быть дозировка, как часто лечить.Улучшение показателей жизнедеятельности — хороший способ узнать, что вы прогрессируете, но когда вы делаете это впервые, вам не с чем сравнивать.

«Многое было действительно проработано по мере того, как мы шли вперед, комбинируя предыдущую литературу, нашу собственную интуицию о том, как эти фаги будут циркулировать и работать, и советы людей, которые думали об этом в течение долгого времени».

Подробности лечения

Врачи пробовали разные комбинации антибиотиков. У него развилась дыхательная недостаточность и гипотензия, потребовавшие искусственной вентиляции легких и периодического неотложного лечения. Он становился все более бредовым. Когда в середине января он впал в кому, его, по сути, поддерживали на аппарате жизнеобеспечения. В конце концов Скули сказал, что больше не осталось противомикробных препаратов.Стратди вспомнил, как коллеги вслух задавались вопросом, готова ли она к смерти Тома.

Ее не было. Бактериофаготерапия началась 15 марта 2016 года, когда смесь из четырех фагов, предоставленных Texas A&M и биотехнологической компанией AmpliPhi из Сан-Диего, была введена через катетеры в псевдокисту. Если лечение не убьет его, медицинская бригада Паттерсона планировала ввести фаги ВМС внутривенно, заполнив его кровоток и достигнув инфекции, бушующей по всему его телу. Насколько известно врачам Паттерсона, такого лечения раньше не применяли.

17 марта ввели внутривенно фаги ВМС. Были опасения по поводу эндотоксинов, вырабатываемых фагами естественным путем. Никто не знал, чего ожидать, но Паттерсон хорошо переносил лечение — действительно, не было никаких побочных эффектов — и 19 марта он внезапно проснулся и узнал свою дочь.

«Одна из целей NMRC в отношении науки о бактериофагах — предоставить военнослужащим, инфицированным мультирезистентными организмами, дополнительные противомикробные препараты, чтобы у нас был опыт и все возможности для обеспечения эффективного фагового коктейля для доктора.Паттерсон, — сказал Терон Гамильтон, доктор философии, руководитель отдела геномики и биоинформатики в Управлении исследований биологической защиты ВМФ. «Очевидно, мы очень довольны результатом и надеемся, что этот случай повысит осведомленность о возможности применения фаговой терапии в таких сложных случаях, как этот».

Последующее лечение, однако, будет нелегким. Кривая обучения была крутой и неотмеченной. Были приступы сепсиса — опасного для жизни осложнения, вызванного массивной инфекцией. Несмотря на улучшение, состояние Паттерсона оставалось тяжелым.Врачи обнаружили, что бактерия в конечном итоге выработала устойчивость к фагам, что Скули охарактеризовал как «повторяющийся дарвиновский танец», но команда компенсировала это постоянным изменением лечения с помощью новых штаммов фагов — некоторые из которых были получены NMRC из сточных вод — и антибиотиков.

В начале мая Паттерсон перестали принимать антибиотики. После 6 июня свидетельств A. baumannii в его теле. Выписан домой 12 августа 2016 года.

Последующая обработка и последующие
Восстановление было не совсем гладким и устойчивым.Были неудачи, не связанные с фагами. Паттерсон, который раньше был крепким мужчиной, в течение нескольких месяцев кормился внутривенно в больнице, и он потерял 100 фунтов, в основном мышцы. Ему потребовалась интенсивная физическая реабилитация, чтобы восстановить силы и двигаться. «Это не похоже на фильмы, где вы просто просыпаетесь из комы, оглядываетесь и выскакиваете из постели», — сказал Паттерсон. «Вы обнаруживаете, что ваше тело больше не работает». Он сказал, что чувствует, как части его мозга оживают.

Стеффани Стратди, доктор философии, и Том Паттерсон, доктор философии, дома.

Тем не менее, Паттерсон назвал этот опыт чудесным. Даже находясь в коме, когда он часто боролся с воображаемыми демонами, он вспомнил, как слышал и узнавал голоса и понимал, что за пределами его тьмы есть жизнь и надежда.

И помимо него, он надеется, что его опыт воплотится в новые методы лечения для других: «Фаговая терапия действительно стала чудом для меня, и что это может означать, что миллионы людей, которые могут быть излечены от инфекций с множественной лекарственной устойчивостью в будущее.Это была своего рода привилегия.

Скули сказал, что Паттерсону повезло. Его жена была опытным ученым и была полна решимости найти лекарство, и они оба работали в Медицинской школе Калифорнийского университета в Сан-Диего: «Ему повезло оказаться в месте, где были все ресурсы и смелость, необходимые для поддержки его во время этой инновационной терапии. был разработан, который по сути представлял собой домашний коктейль из вирусов, который нужно было дать отчаянно больному человеку. Я думаю, что многие другие места колебались бы.Я думаю, что его клиническая реакция была очень приятной и говорит о силе многомерного медицинского центра со всем необходимым ».

Тем не менее, Скули сказал, что любое широкое, одобренное в будущем применение фаговой терапии сталкивается с фундаментальными проблемами в отличие от прошлых методов лечения. «FDA обычно говорит:« Это антибиотик. Мы знаем, какова его структура и как вы можете дать его нескольким людям ». В случае бактериофаговой терапии FDA будет иметь дело с подходом, при котором врачи должны будут разрабатывать коктейли с фагами для каждого пациента, адаптированные к их инфекционным организмам.Это идеальное персонализированное лекарство ».

Хорошая новость, по словам Скули, заключается в том, что новые молекулярные инструменты, робототехника и другие достижения делают возможной персонализированную медицину так, как это было не 10 или 15 лет назад. «Тогда это было бы невозможно созерцать. Предстоит еще много исследований, но я думаю, что будет много клинических приложений, в которых этот подход может быть очень полезным для пациентов ».

Подробнее о бактериофагах

Существуют тысячи разновидностей фагов, каждая из которых эволюционировала, чтобы заразить только один или несколько типов бактерий. Как и другие вирусы, они не могут воспроизводиться сами по себе, но должны управлять репродуктивным механизмом бактерий.Для этого они прикрепляются к бактерии и вставляют свой генетический материал. Затем литические фаги разрушают клетку, расщепляя ее, чтобы высвободить новые вирусные частицы, чтобы продолжить процесс. Таким образом, фаги можно считать единственным «лекарством», способным к размножению; когда их работа сделана, они выводятся из организма.

logging — средство ведения журналов для Python — документация Python 3.9.6

Исходный код: Lib / logging / __ init__.py

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

Ключевое преимущество наличия API журналирования, предоставляемого стандартным библиотечным модулем заключается в том, что все модули Python могут участвовать в ведении журнала, поэтому журнал вашего приложения может включать ваши собственные сообщения, интегрированные с сообщениями от сторонних модули.

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

Основные классы, определенные модулем, вместе с их функциями: перечислено ниже.

• Регистраторы предоставляют интерфейс, который напрямую использует код приложения.

• Обработчики отправляют записи журнала (созданные регистраторами) в соответствующие пункт назначения.

• Фильтры обеспечивают более детализированное средство для определения записей журнала. для вывода.

• Форматировщики определяют структуру записей журнала в окончательном выводе.

Объекты регистратора

имеют следующие атрибуты и методы.Обратите внимание, что регистраторы должны НИКОГДА не создавайте экземпляры напрямую, а всегда через функцию уровня модуля. logging.getLogger (имя) . Несколько вызовов getLogger () с одним и тем же name всегда будет возвращать ссылку на один и тот же объект Logger.

Имя потенциально является иерархическим значением, разделенным точками, например foo.bar.baz (хотя это также может быть просто foo , например). Регистраторы, расположенные ниже в иерархическом списке, являются потомками регистраторов. выше в списке.Например, для регистратора с именем foo , регистраторы с именами foo.bar , foo.bar.baz и foo.bam — все потомки foo . Иерархия имен логгеров аналогична Python. иерархия пакетов, и идентична ей, если вы организуете свои регистраторы на помодульное основание с использованием рекомендованной конструкции logging.getLogger (__ имя__) . Это потому, что в модуле __name__ — имя модуля в пространстве имен пакета Python.

класс лесозаготовка. Регистратор

размножить

Если значение этого атрибута истинно, события, регистрируемые в этом регистраторе, будут передается обработчикам регистраторов более высокого уровня (предков), в дополнение к любые обработчики, прикрепленные к этому регистратору. Сообщения передаются непосредственно в обработчики регистраторов предков — ни уровень, ни фильтры предка Рассмотрены рассматриваемые регистраторы.

Если это оценивается как ложь, сообщения журнала не передаются обработчикам предков регистраторов.

Конструктор устанавливает для этого атрибута значение True .

Примечание

Если вы прикрепите обработчик к регистратору и , один или несколько его предки, он может генерировать одну и ту же запись несколько раз. В общем, ты не нужно прикреплять обработчик более чем к одному регистратору — если вы просто прикрепите его к соответствующему регистратору, который находится наверху в регистраторе иерархии, тогда он будет видеть все события, зарегистрированные всеми дочерними регистраторами, при условии, что их параметр распространения оставлен равным True .Общий сценарий состоит в том, чтобы прикрепить обработчики только к корневому регистратору и позволить размножение позаботится обо всем остальном.

комплект Уровень ( уровень )

Устанавливает порог для этого регистратора на уровень . Регистрация сообщений, которые меньше серьезный, чем уровень будет проигнорирован; сообщения журнала с уровнем серьезности или выше будут отправлены тем обработчиком или обработчиками, которые обслуживают этот регистратор, если для обработчика не задан более высокий уровень серьезности, чем , уровень .

Когда создается регистратор, устанавливается уровень NOTSET (что вызывает все сообщения, которые будут обрабатываться, когда регистратор является корневым регистратором или делегированием родительскому, когда регистратор не является корневым регистратором). Обратите внимание, что корневой регистратор создается с уровнем ПРЕДУПРЕЖДЕНИЕ .

Термин «делегирование родителю» означает, что если регистратор имеет уровень NOTSET, его цепочка регистраторов предков просматривается до тех пор, пока не появится предок с найден уровень, отличный от NOTSET, или достигнут корень.

Если найден предок с уровнем, отличным от NOTSET, то уровень этого предка уровень рассматривается как эффективный уровень регистратора, на котором выполняется поиск предка началось и используется для определения того, как обрабатывается событие регистрации.

Если корень достигнут, и у него есть уровень NOTSET, то все сообщения будут обработанный. В противном случае уровень корня будет использоваться как эффективный уровень.

Список уровней см. В разделе «Уровни ведения журнала».

Изменено в версии 3.2: параметр level теперь принимает строковое представление уровень, такой как «ИНФОРМАЦИЯ» в качестве альтернативы целочисленным константам. например, ИНФОРМАЦИЯ .Обратите внимание, однако, что уровни хранятся внутри как целые числа, и такие методы, как, например, getEffectiveLevel () и isEnabledFor () вернет / ожидает передачи целых чисел.

isEnabledFor ( уровень )

Указывает, будет ли обработано этим регистратором сообщение с уровнем серьезности . Этот метод сначала проверяет уровень уровня модуля, установленный logging.disable (level) , а затем эффективный уровень регистратора, как определено по getEffectiveLevel () .

getEffectiveLevel ()

Указывает эффективный уровень для этого регистратора. Если значение, отличное от NOTSET был установлен с помощью setLevel () , он возвращается. Иначе, иерархия перемещается к корню до тех пор, пока не будет установлено значение, отличное от NOTSET найден, и это значение возвращается. Возвращенное значение целое число, обычно одно из logging.DEBUG , logging.INFO пр.

getChild (суффикс )

Возвращает регистратор, который является потомком этого регистратора, как определено суффиксом.Таким образом, logging.getLogger ('abc'). GetChild ('def.ghi') вернет то же самое logger, как будет возвращено logging.getLogger ('abc.def.ghi') . Это удобный метод, полезный, когда родительский регистратор назван с использованием, например, __name__ а не буквальную строку.

отладка ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем DEBUG в этом регистраторе. msg — это строка формата сообщения, а args — это аргументы, которые объединяются в msg с использованием оператора форматирования строки. (Обратите внимание, что это означает, что вы можете используйте ключевые слова в строке формата вместе с одним аргументом словаря.) Операция% форматирования не выполняется для сообщения msg , если не указано args .

В kwargs проверяются четыре аргумента ключевого слова: exc_info , stack_info , stacklevel и extra .

Если exc_info не оценивается как ложь, это приводит к тому, что информация об исключении добавлен в сообщение журнала. Если кортеж исключения (в формате, возвращаемом sys.exc_info () ) или предоставляется экземпляр исключения, он используется; в противном случае вызывается sys.exc_info () для получения информации об исключении.

Второй необязательный аргумент ключевого слова — stack_info , по умолчанию Ложь . Если true, информация о стеке добавляется в журнал. сообщение, включая фактический вызов журнала.Обратите внимание, что это не то же самое информация стека, отображаемая путем указания exc_info : Первый — это кадры стека от нижней части стека до вызова журналирования в текущем потоке, тогда как последний — это информация о кадрах стека которые были размотаны после исключения при поиске обработчики исключений.

Вы можете указать stack_info независимо от exc_info , например просто показать как вы дошли до определенного места в коде, даже если не было никаких исключений поднятый.Кадры стека печатаются после строки заголовка, в которой говорится:

 Стек (последний вызов последний):
 

Имитирует Traceback (последний вызов последним): , который используется, когда отображение фреймов исключений.

Третий необязательный аргумент ключевого слова — stacklevel , по умолчанию 1 . Если больше 1, соответствующее количество кадров стека пропускается. при вычислении номера строки и имени функции, установленных в LogRecord создан для события регистрации.Это можно использовать в помощниках по ведению журнала, чтобы записанное имя функции, имя файла и номер строки не являются информацией для вспомогательной функции / метода, а скорее для ее вызывающей стороны. Название этого Параметр отражает эквивалентный параметр в модуле предупреждений .

Четвертый аргумент ключевого слова — это дополнительных , которые можно использовать для передачи словарь, который используется для заполнения __dict__ файла LogRecord создан для события регистрации с определенными пользователем атрибутами.Эти обычай Затем атрибуты можно использовать по своему усмотрению. Например, они могли быть включены в зарегистрированные сообщения. Например:

 FORMAT = '% (asctime) -15s% (clientip) s% (user) -8s% (message) s'
logging.basicConfig (формат = ФОРМАТ)
d = {'clientip': '192.168.0.1', 'пользователь': 'fbloggs'}
logger = logging.getLogger ('tcpserver')
logger.warning ('Проблема протокола:% s', 'сброс соединения', extra = d)
 

напечатает что-то вроде

 08.02.2006 22: 20: 02,165 192.168.0.1 fbloggs Проблема протокола: сброс соединения
 

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

Если вы решите использовать эти атрибуты в регистрируемых сообщениях, вам необходимо некоторая осторожность. В приведенном выше примере, например, Formatter был настроить со строкой формата, которая ожидает «clientip» и «user» в атрибуте словарь LogRecord . Если они отсутствуют, сообщение будет не будут регистрироваться, потому что произойдет исключение форматирования строки.Итак, в этом случае вам всегда нужно передавать дополнительный словарь с этими ключами.

Хотя это может раздражать, эта функция предназначена для использования в специализированных обстоятельства, такие как многопоточные серверы, где один и тот же код выполняется в многие контексты и интересные условия, которые возникают, зависят от этого контекст (например, IP-адрес удаленного клиента и аутентифицированное имя пользователя в пример выше). В таких условиях вполне вероятно, что специализированные Formatter s будет использоваться с конкретным Handler s.

Изменено в версии 3.2: добавлен параметр stack_info .

Изменено в версии 3.5: параметр exc_info теперь может принимать экземпляры исключений.

Изменено в версии 3.8: добавлен параметр stacklevel .

информация ( сообщение , * args , ** kwargs )

Записывает сообщение с уровнем ИНФОРМАЦИЯ в этот регистратор. Аргументы интерпретируется как debug () .

предупреждение ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем ПРЕДУПРЕЖДЕНИЕ на этом регистраторе. Аргументы интерпретируется как debug () .

Примечание

Существует устаревший метод warn , который функционально идентично предупреждению . Поскольку предупреждение устарело, не используйте it — используйте вместо предупреждение .

ошибка ( msg , * args , ** kwargs )

Записывает в журнал сообщение с уровнем ОШИБКА . Аргументы интерпретируется как debug () .

критическое ( сообщение , * args , ** kwargs )

Записывает в этот регистратор сообщение с уровнем КРИТИЧЕСКИЙ . Аргументы интерпретируется как debug () .

журнал ( уровень , сообщение , * args , ** kwargs )

Записывает в этот регистратор сообщение с целочисленным уровнем уровень . Другие аргументы интерпретируется как debug () .

исключение ( сообщение , * args , ** kwargs )

Записывает в журнал сообщение с уровнем ОШИБКА .Аргументы интерпретируется как debug () . Информация об исключении добавляется в журнал сообщение. Этот метод следует вызывать только из обработчика исключений.

addFilter ( фильтр )

Добавляет указанный фильтр filter к этому регистратору.

removeFilter ( фильтр )

Удаляет указанный фильтр filter из этого регистратора.

фильтр ( запись )

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

addHandler ( hdlr )

Добавляет указанный обработчик hdlr к этому регистратору.

removeHandler ( hdlr )

Удаляет указанный обработчик hdlr из этого регистратора.

findCaller ( stack_info = False , stacklevel = 1 )

Находит исходное имя файла вызывающего абонента и номер строки. Возвращает имя файла, строку номер, имя функции и информация о стеке в виде четырехэлементного кортежа. Стек информация возвращается как Нет , если stack_info не Истина .

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

ручка ( запись )

Обрабатывает запись, передавая ее всем обработчикам, связанным с этим регистратором и его предки (пока не будет найдено ложное значение , передайте ).Этот метод используется для неотобранных записей, полученных из сокета, а также для записей, созданных локально. Фильтрация на уровне регистратора применяется с использованием filter () .

makeRecord ( имя , уровень , fn , lno , msg , args , exc_info , func = None , extra = None , extra = None )

Это фабричный метод, который можно переопределить в подклассах для создания специализированные экземпляров LogRecord .

hasHandlers ()

Проверяет, настроены ли для этого средства ведения журнала какие-либо обработчики. Это делается ищет обработчики в этом регистраторе и его родителях в иерархии регистратора. Возвращает Истинно , если обработчик был найден, иначе Ложь . Метод прекращает поиск вверх по иерархии всякий раз, когда регистратор с атрибутом «распространять» установлен на false — это будет последний регистратор, который проверяется на наличие обработчиков.

Изменено в версии 3.7: Лесорубы теперь можно мариновать и не собирать.

Уровни регистрации

Числовые значения уровней ведения журнала приведены в следующей таблице. Эти в первую очередь представляет интерес, если вы хотите определить свои собственные уровни и нуждаетесь в них имеют определенные значения относительно предопределенных уровней. Если вы определите уровень с тем же числовым значением он перезаписывает предопределенное значение; предопределенный имя потеряно.

Объекты-обработчики

имеют следующие атрибуты и методы.Обратите внимание, что Handler никогда не создается напрямую; этот класс действует как база для более полезных подклассы. Однако метод __init __ () в подклассах должен вызывать Обработчик .__ init __ () .

класс лесозаготовка. Погрузчик

__init__ (уровень = NOTSET )

Инициализирует экземпляр Handler , задав его уровень, задав список фильтров в пустой список и создание блокировки (с помощью createLock () ) для сериализованный доступ к механизму ввода-вывода.

createLock ()

Инициализирует блокировку потока, которая может использоваться для сериализации доступа к базовому Функциональность ввода-вывода, которая может быть небезопасной для потоков.

приобрести ()

Получает блокировку потока, созданную с помощью createLock () .

выпуск ()

Освобождает блокировку резьбы, полученную с помощью Acquire () .

комплект Уровень ( уровень )

Устанавливает порог для этого обработчика на уровень . Регистрация сообщений, которые менее серьезный, чем уровень , будет проигнорирован. При создании обработчика уровень установлен на NOTSET (что приводит к тому, что все сообщения обработанный).

Список уровней см. В разделе «Уровни ведения журнала».

Изменено в версии 3.2: параметр level теперь принимает строковое представление уровень, такой как «ИНФОРМАЦИЯ» в качестве альтернативы целочисленным константам. например, ИНФОРМАЦИЯ .

setFormatter ( fmt )

Устанавливает Formatter для этого обработчика на fmt .

addFilter ( фильтр )

Добавляет указанный фильтр filter к этому обработчику.

removeFilter ( фильтр )

Удаляет указанный фильтр filter из этого обработчика.

фильтр ( запись )

Примените фильтры этого обработчика к записи и верните Истина , если запись подлежит обработке. Фильтры проверяются по очереди, пока один из они возвращают ложное значение. Если ни один из них не возвращает ложное значение, запись будет выпущен. Если возвращается ложное значение, обработчик не будет выдавать записывать.

заподлицо ()

Убедитесь, что все данные журнала сброшены.Эта версия ничего не делает и предназначен для реализации подклассами.

закрыть ()

Уберите все ресурсы, используемые обработчиком. Эта версия не выводит данные, но удаляет обработчик из внутреннего списка обработчиков, который закрывается, когда Вызывается shutdown () . Подклассы должны гарантировать, что это будет вызвано из переопределенных методов close () .

ручка ( запись )

Условно генерирует указанную запись журнала, в зависимости от фильтров, которые могут были добавлены в обработчик.Оборачивает фактическую эмиссию записи в получение / снятие блокировки потока ввода / вывода.

ручка Ошибка ( запись )

Этот метод должен вызываться из обработчиков при обнаружении исключения во время вызова emit () . Если атрибут уровня модуля raiseExceptions — это False , исключения автоматически игнорируются. Это то, что в основном требуется для системы ведения журнала — большинству пользователей наплевать ошибки в системе логирования, их больше интересует приложение ошибки.Однако вы можете заменить это специальным обработчиком, если хотите. Указанная запись — это та, которая обрабатывалась, когда исключение произошел. (Значение по умолчанию raiseExceptions — True , так как это полезнее во время разработки).

формат ( запись )

Выполните форматирование для записи — если форматтер установлен, используйте его. В противном случае используйте модуль форматирования по умолчанию для модуля.

испускает ( запись )

Сделайте все возможное, чтобы зарегистрировать указанную запись журнала.Эта версия предназначен для реализации подклассами и поэтому вызывает NotImplementedError .

Список стандартных обработчиков см. В разделе logging.handlers .

Объекты форматирования

Formatter имеют следующие атрибуты и методы. Они есть отвечает за преобразование LogRecord в (обычно) строку, которая может интерпретироваться человеком или внешней системой.База Formatter позволяет указать строку форматирования. Если нет при поставке используется значение по умолчанию '% (message) s' , которое просто включает сообщение в журнале вызова. Чтобы иметь дополнительную информацию в форматированный вывод (например, отметка времени), продолжайте читать.

Formatter может быть инициализирован строкой формата, использующей знания атрибутов LogRecord — например, значение по умолчанию, упомянутое выше используя тот факт, что сообщение и аргументы пользователя предварительно отформатированы в атрибут сообщения LogRecord ‘s .Эта строка формата содержит стандартные ключи сопоставления Python% -style. See section Форматирование строк в стиле printf для получения дополнительной информации о форматировании строк.

Полезные ключи сопоставления в LogRecord приведены в разделе, посвященном Атрибуты LogRecord.

класс лесозаготовка. Formatter ( fmt = None , datefmt = None , style = ‘%’ , validate = True )

Возвращает новый экземпляр класса Formatter .Экземпляр инициализируется строкой формата для сообщения в целом, а также строка формата для части даты / времени сообщения. Если нет fmt — это указано, используется '% (message) s' . Если не указан datefmt , формат используется, что описано в документации formatTime () .

Параметр стиля может быть одним из «%», «{» или «$» и определяет, как строка формата будет объединена с ее данными: с использованием одного из% -форматирования, ул.format () или строка. Шаблон . Это относится только к строка формата fmt (например, '% (message) s' или {message} ), а не фактические сообщения журнала передаются в Logger.debug и т. д .; видеть Использование определенных стилей форматирования в вашем приложении для получения дополнительной информации об использовании {- и $ -форматирования для сообщений журнала.

Изменено в версии 3.2: добавлен параметр стиля .

Изменено в версии 3.8: добавлен параметр validate .Неправильный или несоответствующий стиль и формат вызовет ValueError . Например: logging.Formatter ('% (asctime) s -% (message) s',) .

формат ( запись )

Словарь атрибутов записи используется как операнд для строки операция форматирования. Возвращает результирующую строку. Перед форматированием словаря, проводится пара подготовительных шагов. Сообщение Атрибут записи вычисляется с использованием msg % args .Если строка форматирования содержит '(asctime)' , вызывается formatTime () для форматирования времени события. Если есть информация об исключении, это отформатирован с использованием formatException () и добавлен к сообщению. Примечание что отформатированная информация об исключении кэшируется в атрибуте exc_text . Это полезно, потому что информация об исключении может быть замариновать и отправить по проволоке, но будьте осторожны, если у вас более одного подкласса Formatter , который настраивает форматирование информации об исключении.В этом случае вам нужно будет очистить кешированный значение после того, как форматтер выполнил свое форматирование, так что следующий средство форматирования для обработки события не использует кешированное значение, а пересчитывает его заново.

Если доступна информация о стеке, она добавляется после исключения. информации, используя formatStack () для ее преобразования при необходимости.

formatTime ( запись , datefmt = None )

Этот метод должен вызываться из format () с помощью средства форматирования, которое хочет использовать форматированное время.Этот метод можно переопределить в средства форматирования, чтобы обеспечить выполнение любых конкретных требований, но основное поведение выглядит следующим образом: если указан datefmt (строка), он используется с time.strftime () для форматирования времени создания записывать. В противном случае используется формат «% Y-% m-% d% H:% M:% S, uuu», где часть uuu — это значение в миллисекундах, а остальные буквы соответствуют time.strftime () документация. Пример времени в этом формате: 23.01.2003 00: 29: 50, 411 .Возвращается результирующая строка.

Эта функция использует настраиваемую пользователем функцию для преобразования создания время до кортежа. По умолчанию используется time.localtime () ; изменить это для конкретного экземпляра средства форматирования, установите атрибут преобразователя в функцию с той же сигнатурой, что и time.localtime () или time.gmtime () . Чтобы изменить его для всех форматеров, например, если вы хотите, чтобы все времена регистрации отображались в GMT, установите преобразователь атрибут в классе Formatter .

Изменено в версии 3.3: Ранее формат по умолчанию был жестко запрограммирован, как в этом примере: 2010-09-06 22: 38: 15,292 где часть перед запятой обрабатывается строкой формата strptime ( '% Y-% m-% d% H:% M:% S' ), а часть после запятой — это значение в миллисекундах. Поскольку strptime не иметь заполнитель формата для миллисекунд, значение миллисекунды добавляется с использованием другой строки формата, '% s,% 03d' — и обе эти Строки формата жестко запрограммированы в этот метод.С изменением, эти строки определены как атрибуты уровня класса, которые могут быть при необходимости переопределить на уровне экземпляра. Имена атрибуты: default_time_format (для строки формата strptime) и default_msec_format (для добавления значения миллисекунды).

Изменено в версии 3.9: default_msec_format может быть Нет .

formatException ( exc_info )

Форматирует указанную информацию об исключении (стандартный кортеж исключений как возвращено sys.exc_info () ) в виде строки. Эта реализация по умолчанию просто использует traceback.print_exception () . Результирующая строка вернулся.

formatStack ( stack_info )

Форматирует указанную информацию стека (строку, возвращаемую traceback.print_stack () , но с удаленной последней новой строкой) как нить. Эта реализация по умолчанию просто возвращает входное значение.

Объекты фильтра

Фильтры могут использоваться обработчиками и регистраторами для более сложных фильтрация, чем это предусмотрено по уровням.Базовый класс фильтра разрешает только события которые находятся ниже определенной точки в иерархии регистраторов. Например, фильтр инициализированный с помощью «A.B» разрешит события, регистрируемые регистраторами «A.B», «A.B.C», «A.B.C.D», «A.B.D» и т. Д., Но не «A.BB», «B.A.B» и т. Д. пустая строка, все события передаются.

класс лесозаготовка. Фильтр ( name = » )

Возвращает экземпляр класса Filter . Если указано имя , оно именует регистратор, который вместе со своими дочерними элементами будет иметь разрешенные события через фильтр.Если имя — пустая строка, разрешает каждое событие.

фильтр ( запись )

Должна ли регистрироваться указанная запись? Возвращает ноль, если нет, ненулевое значение, если да. Если это будет сочтено целесообразным, запись может быть изменена на месте этим метод.

Обратите внимание, что фильтры, прикрепленные к обработчикам, просматриваются перед тем, как событие генерируется обработчиком, тогда как фильтры, прикрепленные к регистраторам, консультируются всякий раз, когда событие регистрируется (используя debug () , info () , и т.п.) перед отправкой события обработчикам. Это означает, что события, имеющие были сгенерированы дочерними регистраторами, не будут отфильтрованы фильтром регистратора , если фильтр также не был применен к этим потомкам-регистраторам.

На самом деле вам не нужно создавать подкласс . Фильтр : вы можете передать любой экземпляр который имеет метод filter с той же семантикой.

Изменено в версии 3.2: вам не нужно создавать специализированные классы Filter или использовать другие классы с фильтром Метод : вы можете использовать функцию (или другой вызываемый) как фильтр.Логика фильтрации проверит, объект имеет атрибут filter : если это так, предполагается, что это Вызывается Filter и его метод filter () . В противном случае это считается вызываемым и вызывается с записью как сингл параметр. Возвращаемое значение должно соответствовать возвращаемому фильтр () .

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

Объекты LogRecord

Экземпляры LogRecord создаются автоматически Logger каждый раз, когда что-то регистрируется, и может быть создано вручную с помощью makeLogRecord () (например, из маринованного события, полученного через провод).

класс лесозаготовка. LogRecord ( имя , уровень , путь , белье , msg , args , exc_info , func = None , sinfo50 = None , sinfo50 = None

Содержит всю информацию, относящуюся к регистрируемому событию.

Первичная информация передается в msg и args , которые объединены с использованием msg% args для создания поля message записывать.

Параметры

• имя — Имя регистратора, используемого для регистрации события, представленного это LogRecord. Обратите внимание, что это имя всегда будет иметь это значение, даже если оно может быть отправлено обработчиком, прикрепленным к другой (предок) регистратор.

• уровень — числовой уровень события журнала (один из DEBUG, INFO и т. Д.) Обратите внимание, что это преобразовано в два атрибута LogRecord: levelno для числового значения и levelname для соответствующее название уровня.

• pathname — Полный путь к исходному файлу, в котором выполняется запись в журнал. был сделан.

• cabin — Номер строки в исходном файле, где был зарегистрирован вызов. сделали.

• msg — Сообщение с описанием события, возможно, строка формата с заполнители для переменных данных.

• args — Переменные данные для объединения в аргумент msg для получения Описание события.

• exc_info — Кортеж исключения с текущей информацией об исключении, или Нет , если информация об исключении недоступна.

• func — Имя функции или метода, из которых вызывается ведение журнала. был вызван.

• sinfo — Текстовая строка, представляющая информацию стека из базы стек в текущем потоке до вызова журналирования.

getMessage ()

Возвращает сообщение для этого экземпляра LogRecord после слияния любого предоставленные пользователем аргументы с сообщением.Если пользовательское сообщение аргумент вызова журнала не является строкой, для него вызывается str () . преобразовать его в строку. Это позволяет использовать определяемые пользователем классы как сообщения, чей метод __str__ может возвращать фактическую строку формата в использоваться.

Изменено в версии 3.2: Создание LogRecord стало более настраиваемым за счет предоставление фабрики, которая используется для создания записи. Завод может быть установить с помощью getLogRecordFactory () и setLogRecordFactory () (см. подпись завода).

Эту функцию можно использовать для вставки собственных значений в LogRecord во время создания. Вы можете использовать следующий шаблон:

 old_factory = logging.getLogRecordFactory ()

def record_factory (* args, ** kwargs):
    запись = old_factory (* аргументы, ** kwargs)
    record.custom_attribute = 0xdecafbad
    возвратная запись

logging.setLogRecordFactory (record_factory)
 

С помощью этого шаблона несколько фабрик могут быть объединены в цепочку, и до тех пор, пока поскольку они не перезаписывают атрибуты друг друга или непреднамеренно перезаписать стандартные атрибуты, перечисленные выше, не должно быть сюрпризы.

Атрибуты LogRecord

LogRecord имеет ряд атрибутов, большинство из которых являются производными от параметры конструктору. (Обратите внимание, что названия не всегда соответствуют точно между параметрами конструктора LogRecord и LogRecord атрибуты.) Эти атрибуты могут использоваться для объединения данных из записи в строка формата. В следующей таблице перечислены (в алфавитном порядке) имена атрибутов, их значения и соответствующий заполнитель в% -стиле строка формата.

Если вы используете {} -форматирование ( str.format () ), вы можете использовать {attrname} как заполнитель в строке формата. Если вы используете $ -formatting ( string.Template ), используйте форму $ {attrname} . В в обоих случаях, конечно, заменить attrname на фактическое имя атрибута вы хотите использовать.

В случае {} -форматирования вы можете указать флаги форматирования, поместив их после имени атрибута, отделенного от него двоеточием.Например: a заполнитель {msecs: 03d} форматирует значение в миллисекундах 4 как 004 . Обратитесь к документации str.format () для получения полной информации о доступные вам варианты.

Изменено в версии 3.1: добавлено processName .

Объекты адаптера регистратора

LoggerAdapter экземпляров используются для удобной передачи контекстных информация в записи звонков. Пример использования см. В разделе добавление контекстной информации к выходным данным журнала.

класс лесозаготовка. Адаптер регистратора ( регистратор , дополнительный )

Возвращает экземпляр LoggerAdapter , инициализированный базовый экземпляр Logger и dict-подобный объект.

процесс ( сообщение , kwargs )

Изменяет аргументы сообщения и / или ключевого слова, передаваемые вызову регистрации в чтобы вставить контекстную информацию. Эта реализация принимает объект передается конструктору как extra и добавляет его к kwargs с помощью ключа ‘дополнительный’. Возвращаемое значение — кортеж ( msg , kwargs ), который имеет (возможно, измененные) версии переданных аргументов.

В дополнение к вышесказанному, LoggerAdapter поддерживает следующие методы Logger : debug () , info () , предупреждение () , ошибка () , исключение () , критический () , журнал () , isEnabledFor () , getEffectiveLevel () , setLevel () и hasHandlers () . Эти методы имеют те же сигнатуры, что и их аналоги в Logger , поэтому вы можете использовать два типа экземпляров взаимозаменяемо.

Изменено в версии 3.6: добавлены атрибут manager и метод _log () , которые делегировать основному регистратору и разрешить вложение адаптеров.

Безопасность резьбы

Модуль регистрации предназначен для обеспечения многопоточности без каких-либо специальных работ. должны быть выполнены его клиентами. Это достигается с помощью потоковой передачи замки; есть одна блокировка для сериализации доступа к общим данным модуля, и каждый обработчик также создает блокировку для сериализации доступа к своему базовому вводу-выводу.

Если вы реализуете асинхронные обработчики сигналов с помощью сигнала модуль, возможно, вы не сможете использовать ведение журнала из таких обработчиков. Это поскольку реализации блокировки в модуле threading не всегда повторно входящий, и поэтому не может быть вызван из таких обработчиков сигналов.

Функции на уровне модуля

В дополнение к классам, описанным выше, существует ряд модулей уровня функции.

лесозаготовка. getLogger ( name = None )

Вернуть регистратор с указанным именем или, если имя Нет , вернуть logger, который является корневым регистратором иерархии. Если указано, имя обычно иерархическое имя, разделенное точками, например ‘a’ , ‘a.b’ или ‘a.b.c.d’ . Выбор этих имен полностью зависит от разработчика, использующего ведение журнала.

Все вызовы этой функции с заданным именем возвращают один и тот же экземпляр регистратора.Это означает, что экземпляры логгера никогда не нужно передавать между разными частями. приложения.

лесозаготовка. getLoggerClass ()

Вернуть либо стандартный класс Logger , либо последний класс, переданный в setLoggerClass () . Эта функция может быть вызвана из нового класса определение, чтобы гарантировать, что установка настроенного класса Logger будет не отменять настройки, уже примененные другим кодом.Например:

 класс MyLogger (logging.getLoggerClass ()):
    # ... здесь переопределить поведение
 

лесозаготовка. getLogRecordFactory ()

Вернуть вызываемый объект, который используется для создания LogRecord .

Новое в версии 3.2: Эта функция была предоставлена ​​вместе с setLogRecordFactory () , чтобы дать разработчикам больше контроля над тем, как LogRecord представляет собой событие регистрации.

См. setLogRecordFactory () для получения дополнительной информации о том, как завод называется.

лесозаготовка. отладка ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем DEBUG в корневом регистраторе. msg — это строка формата сообщения, а args — это аргументы, которые объединяются в msg с использованием оператора форматирования строки.(Обратите внимание, что это означает, что вы можете используйте ключевые слова в строке формата вместе с одним аргументом словаря.)

В kwargs проверяются три аргумента ключевого слова: exc_info который, если он не оценивается как ложный, приводит к тому, что информация об исключении добавлен в сообщение журнала. Если кортеж исключения (в формате, возвращаемом sys.exc_info () ) или предоставляется экземпляр исключения, он используется; в противном случае вызывается sys.exc_info () для получения информации об исключении.

Второй необязательный аргумент ключевого слова — stack_info , по умолчанию Ложь . Если true, информация о стеке добавляется в журнал. сообщение, включая фактический вызов журнала. Обратите внимание, что это не то же самое информация стека, отображаемая путем указания exc_info : Первый — это кадры стека от нижней части стека до вызова журналирования в текущем потоке, тогда как последний — это информация о кадрах стека которые были размотаны после исключения при поиске обработчики исключений.

Вы можете указать stack_info независимо от exc_info , например просто показать как вы дошли до определенного места в коде, даже если не было никаких исключений поднятый. Кадры стека печатаются после строки заголовка, в которой говорится:

 Стек (последний вызов последний):
 

Имитирует Traceback (последний вызов последним): , который используется, когда отображение фреймов исключений.

Третий необязательный аргумент ключевого слова — extra , который можно использовать для передачи словарь, который используется для заполнения __dict__ LogRecord, созданного для событие регистрации с определенными пользователем атрибутами.Затем эти настраиваемые атрибуты можно можно использовать по своему усмотрению. Например, они могут быть включены в зарегистрированные Сообщения. Например:

 FORMAT = '% (asctime) -15s% (clientip) s% (user) -8s% (message) s'
logging.basicConfig (формат = ФОРМАТ)
d = {'clientip': '192.168.0.1', 'пользователь': 'fbloggs'}
logging.warning ('Проблема протокола:% s', 'сброс соединения', extra = d)
 

напечатает что-то вроде:

 08.02.2006 22: 20: 02,165 192.168.0.1 fbloggs Проблема протокола: сброс соединения
 

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

Если вы решите использовать эти атрибуты в регистрируемых сообщениях, вам необходимо некоторая осторожность. В приведенном выше примере, например, Formatter был настроить со строкой формата, которая ожидает «clientip» и «user» в атрибуте словарь LogRecord. Если они отсутствуют, сообщение не будет регистрируется, потому что произойдет исключение форматирования строки.Итак, в этом случае вы всегда нужно передавать дополнительный словарь с этими ключами.

Хотя это может раздражать, эта функция предназначена для использования в специализированных обстоятельства, такие как многопоточные серверы, где один и тот же код выполняется в многие контексты и интересные условия, которые возникают, зависят от этого контекст (например, IP-адрес удаленного клиента и аутентифицированное имя пользователя в пример выше). В таких условиях вполне вероятно, что специализированные Formatter s будет использоваться с конкретным Handler s.

Изменено в версии 3.2: добавлен параметр stack_info .

лесозаготовка. информация ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем ИНФОРМАЦИЯ в корневом регистраторе. Аргументы интерпретируется как debug () .

лесозаготовка. предупреждение ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем WARNING в корневом регистраторе.Аргументы интерпретируются как debug () .

Примечание

Имеется устаревшая функция предупреждать , которая функционально идентично предупреждению . Поскольку предупреждение устарело, не используйте it — используйте вместо предупреждение .

лесозаготовка. ошибка ( msg , * args , ** kwargs )

Регистрирует сообщение с уровнем ОШИБКА в корневом регистраторе.Аргументы интерпретируется как debug () .

лесозаготовка. критическое ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем КРИТИЧЕСКИЙ в корневом регистраторе. Аргументы интерпретируются как debug () .

лесозаготовка. исключение ( сообщение , * args , ** kwargs )

Регистрирует сообщение с уровнем ОШИБКА в корневом регистраторе.Аргументы интерпретируется как debug () . Информация об исключении добавляется в журнал сообщение. Эта функция должна вызываться только из обработчика исключений.

лесозаготовка. журнал ( уровень , msg , * args , ** kwargs )

Регистрирует сообщение с уровнем уровень в корневом регистраторе. Другие аргументы интерпретируется как debug () .

Примечание

Указанные выше вспомогательные функции на уровне модуля, которые делегируются корневого регистратора, вызовите basicConfig () , чтобы убедиться, что хотя бы один обработчик доступен.Из-за этого в потоках следует использовать , а не , в версиях Python до 2.7.1 и 3.2, если хотя бы один обработчик был добавлен к корневому регистратору перед потоками начал. В более ранних версиях Python из-за недостатка безопасности потоков в basicConfig () это может (в редких случаях) привести к обработчики добавляются несколько раз к корневому регистратору, который, в свою очередь, может привести к нескольким сообщениям для одного и того же события.

лесозаготовка. отключить (уровень = КРИТИЧЕСКИЙ )

Обеспечивает приоритетный уровень уровень для всех регистраторов, который имеет приоритет над собственный уровень регистратора. Когда возникает необходимость временно ограничить ведение журнала вывод вниз по всему приложению, эта функция может быть полезной. Его эффект заключается в отключении всех вызовов журналирования с уровнем серьезности и ниже, так что если вы вызовете его со значением INFO, тогда все события INFO и DEBUG будут отброшены, тогда как сообщения серьезности WARNING и выше будут обработаны в соответствии с эффективным уровнем регистратора.Если logging.disable (logging.NOTSET) вызывается , он эффективно удаляет это уровень переопределения, так что вывод журнала снова зависит от эффективного уровни индивидуальных регистраторов.

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

Изменено в версии 3.7: для параметра уровня по умолчанию задан уровень КРИТИЧЕСКИЙ .Видеть bpo-28524 для получения дополнительной информации об этом изменении.

лесозаготовка. addLevelName ( уровень , levelName )

Associates level level с текстом levelName во внутреннем словаре, который используется для отображения числовых уровней в текстовое представление, например, когда Formatter форматирует сообщение. Эту функцию также можно использовать для определения свои собственные уровни. Единственное ограничение — все используемые уровни должны быть зарегистрированные с помощью этой функции, уровни должны быть положительными целыми числами, и они должен увеличиваться в порядке возрастания серьезности.

Примечание

Если вы думаете об определении собственных уровней, см. раздел о пользовательских уровнях.

лесозаготовка. getLevelName ( уровень )

Возвращает текстовое или числовое представление уровня ведения журнала уровень .

Если уровень является одним из предопределенных уровней КРИТИЧЕСКИЙ , ОШИБКА , WARNING , INFO или DEBUG , тогда вы получите соответствующая строка.Если вы связали уровни с именами, используя addLevelName () , то имя, которое вы связали с level , будет вернулся. Если числовое значение, соответствующее одному из определенных уровней, равно передается, возвращается соответствующее строковое представление.

Параметр level также принимает строковое представление уровня, например как «ИНФОРМАЦИЯ». В таких случаях эта функция возвращает соответствующий числовой значение уровня.

Если подходящее числовое или строковое значение не передается, строка «Уровень% s»% уровень возвращается.

Примечание

Уровни являются внутренне целыми числами (так как их нужно сравнивать в логика регистрации). Эта функция используется для преобразования между целочисленным уровнем и имя уровня, отображаемое в выводе форматированного журнала с помощью % (levelname) s спецификатор формата (см. Атрибуты LogRecord) и наоборот.

Изменено в версии 3.4: В версиях Python ранее, чем 3.4, этой функции также можно было передать текстовый уровень и вернет соответствующее числовое значение уровня.Это недокументированное поведение было сочтено ошибкой и было удалено в Python 3.4, но восстановлен в 3.4.2 из-за сохранения обратной совместимости.

лесозаготовка. makeLogRecord ( attrdict )

Создает и возвращает новый экземпляр LogRecord , атрибуты которого определяется аттрибутом . Эта функция полезна для взятия маринованных Словарь атрибутов LogRecord , отправленный через сокет и воссоздание это как экземпляр LogRecord на принимающей стороне.

лесозаготовка. basicConfig ( ** kwargs )

Выполняет базовую настройку системы журналов путем создания StreamHandler со стандартным Formatter и добавив его в корневой регистратор. Функции debug () , info () , warning () , error () и critical () автоматически вызовет basicConfig () если для корневого регистратора не определены обработчики.

Эта функция ничего не делает, если у корневого регистратора уже есть обработчики. настроен, если аргумент ключевого слова force не установлен на True .

Примечание

Эта функция должна вызываться из основного потока до того, как будут запущены другие потоки. В версиях Python до 2.7.1 и 3.2, если эта функция вызывается из нескольких потоков, возможно (в редких случаях) добавление обработчика к корневому регистратору более одного раза, что приводит к неожиданным результатам например, сообщения дублируются в журнале.

Поддерживаются следующие аргументы ключевого слова.

Формат	Описание
имя_файла	Задает создание FileHandler, используя указанное имя файла, а не StreamHandler.
файловый режим	Если указано имя_файла , откройте файл в этом режиме.По умолчанию к '.
формат	Использовать указанную строку формата для обработчик. По умолчанию атрибуты имя уровня , имя и сообщение разделенные двоеточиями.
datefmt	Использовать указанный формат даты / времени, как принято time.strftime () .
стиль	Если указан формат , используйте этот стиль для строки формата.Один из % , '{' или '$' для стиля printf, str.format () или строка. Шаблон соответственно. По умолчанию % .
уровень	Установить уровень корневого регистратора на указанный уровень.
поток	Используйте указанный поток для инициализации StreamHandler. Обратите внимание, что этот аргумент несовместимо с filename — если оба присутствуют, возникает ошибка ValueError .
манипуляторы	Если указано, это должно быть повторением уже созданные обработчики для добавления в корень регистратор. Любые обработчики, которые еще не иметь набор форматировщиков будет назначен форматировщик по умолчанию, созданный в этой функции. Обратите внимание, что этот аргумент несовместим с имя файла или поток — если оба присутствуют, возникает ошибка ValueError .
усилие	Если этот аргумент ключевого слова задан как правда, любые существующие обработчики, прикрепленные к корневой регистратор удаляется и закрывается, прежде чем выполнение конфигурации, как указано другими аргументами.
кодировка	Если этот аргумент ключевого слова указан вместе с имя файла , его значение используется, когда FileHandler создается и поэтому используется, когда открытие выходного файла.
ошибок	Если этот аргумент ключевого слова указан вместе с имя файла , его значение используется, когда FileHandler создается и поэтому используется, когда открытие выходного файла.Если не указано, используется значение «обратная косая черта». Примечание что, если None не указан, он будет передано как таковое в func: open , что означает что это будет рассматриваться так же, как передача «Ошибки».

Изменено в версии 3.2: добавлен аргумент стиля .

Изменено в версии 3.3: добавлен аргумент обработчиков . Добавлены дополнительные проверки в поймать ситуации, когда указаны несовместимые аргументы (например,г. обработчики вместе с потоком или имя файла или поток вместе с имя файла ).

Изменено в версии 3.8: добавлен аргумент force .

Изменено в версии 3.9: , кодирующие ошибки и , были добавлены аргументов.

лесозаготовка. выключение ()

Информирует систему регистрации о необходимости правильного отключения путем промывки и закрытие всех обработчиков.Это должно вызываться при выходе из приложения и нет дальнейшее использование системы регистрации должно быть произведено после этого вызова.

Когда модуль регистрации импортируется, он регистрирует эту функцию как выход обработчик (см. atexit ), поэтому обычно в этом нет необходимости вручную.

лесозаготовка. setLoggerClass ( класс )

Указывает системе ведения журнала использовать класс klass при создании экземпляра средства ведения журнала.Класс должен определять __init __ () так, чтобы только аргумент имени был требуется, а __init __ () должен вызывать Logger .__ init __ () . Этот функция обычно вызывается до того, как какие-либо регистраторы будут созданы приложениями. которым необходимо использовать настраиваемое поведение регистратора. После этого звонка, как и при любом другом время, не создавайте экземпляры регистраторов напрямую с помощью подкласса: продолжайте использовать API logging.getLogger () для получения ваших регистраторов.

лесозаготовка. setLogRecordFactory ( завод )

Установите вызываемый объект, который используется для создания LogRecord .

Параметры

factory — вызываемая фабрика, которая будет использоваться для создания экземпляра записи журнала.

Новое в версии 3.2: Эта функция была предоставлена ​​вместе с getLogRecordFactory () для позволяют разработчикам больше контролировать, как LogRecord представляет создается событие регистрации.

Завод имеет подпись:

factory (имя, уровень, fn, lno, msg, args, exc_info, func = None, sinfo = None, ** kwargs)

наименование

Имя регистратора.

уровень

Уровень ведения журнала (числовой).

fn

Полный путь к файлу, в котором был выполнен вызов журнала.

лно

Номер строки в файле, где был выполнен вызов журнала.

сообщение

Сообщение журнала.

аргументов

Аргументы сообщения журнала.

exc_info

Исключительный кортеж или Нет .

функция

Имя функции или метода, вызвавшего ведение журнала. вызов.

синфо

Отслеживание стека, например, предоставляемое traceback.print_stack () , показывающий иерархию вызовов.

кварг

Дополнительные аргументы ключевого слова.

Атрибуты уровня модуля

лесозаготовка. lastResort

Через этот атрибут доступен «обработчик последней инстанции». Этот это StreamHandler , записывающий в sys.stderr с уровнем ПРЕДУПРЕЖДЕНИЕ , и используется для обработки событий регистрации в отсутствие каких-либо конфигурация журналирования.Конечный результат — просто распечатать сообщение на sys.stderr . Это заменяет предыдущее сообщение об ошибке, в котором говорилось, что «Для логгера XYZ обработчики не найдены». Если вам нужно раньше поведение по какой-то причине lastResort может быть установлено на None .

Интеграция с модулем предупреждений

Функцию captureWarnings () можно использовать для интеграции регистрации с модулем предупреждений .

лесозаготовка. captureWarnings ( capture )

Эта функция используется для включения сбора предупреждений при входе в систему и выключенный.

Если захват равен Истина , предупреждения, выданные модулем warnings , будут быть перенаправленным в систему ведения журнала. В частности, предупреждение будет форматируется с использованием warnings.formatwarning () и результирующей строки зарегистрирован в регистраторе с именем 'py.warnings' с уровнем серьезности WARNING .

Если захват равен Ложь , перенаправление предупреждений в систему ведения журнала остановится, а предупреждения будут перенаправлены в исходные пункты назначения (т.е. действовавшие до вызова captureWarnings (True) ).

См. Также

Модуль logging.config

API конфигурации для модуля регистрации.

Модуль logging.handlers

Полезные обработчики, включенные в модуль регистрации.

PEP 282 — Система регистрации

Предложение, в котором описывается эта функция для включения в стандарт Python библиотека.

Исходный пакет протоколирования Python

Это исходный источник пакета протоколирования . Версия пакет, доступный на этом сайте, подходит для использования с Python 1.5.2, 2.1.x и 2.2.x, которые не включают пакет logging в стандартный библиотека.

Экспорт коллекции в виде файла CSV

Применимые планы

• Бесплатно
• Plus
• Business
• Enterprise

Вы можете экспортировать всю коллекцию в файл .csv за пару кликов. Для этого откройте меню параметров коллекции, щелкнув имя коллекции, когда она открыта, и выберите «Экспорт в CSV».