Коришћење библиотеке дневника у Руби је једноставан начин да пратите када нешто није у реду са вашим кодом. Ако нешто пође по злу, детаљни приказ тачно онога што се догодило доводи до грешке може вам уштедјети сате у проналажењу грешке. Како ваши програми постају све већи и сложенији, можда бисте желели да додате начин за писање порука дневника. Руби долази са бројним корисним часови а библиотеке се називају стандардна библиотека. Међу њима је библиотека дрвосјеча која пружа приоритетну и ротирану евиденцију записа.
Основна употреба
Будући да библиотека дневника долази са Рубијем, нема потребе за инсталирањем драгуља или других библиотека. За почетак употребу библиотеке дневника, једноставно захтевају 'логер' и креирајте нови објект Логгер-а. Све поруке написане објекту Логгер биће уписане у датотеку дневника.
#! / уср / бин / енв рубин
захтева 'логер'
лог = Логгер.нев ('лог.ткт')
лог.дебуг "Датотека дневника је креирана"
Приоритети
Свака порука дневника има приоритет. Ови приоритети поједностављују претраживање датотека дневника за озбиљним порукама, као и да ли објекат записивања аутоматски филтрира мање порука када нису потребне. Можете то замислити као свој списак обавеза за дан. Неке ствари апсолутно морају бити урађене, неке ствари заиста треба завршити, а неке ствари можете одложити док не будете имали времена да их урадите.
У претходном примеру је приоритет био дебуг, најмање важан од свих приоритета („одложите док не будете имали времена“ са своје листе До, ако желите). Приоритети порука дневника, у најмању руку од најважнијих, су следећи: исправљање грешака, информације, упозорење, грешкаи кобно. Да бисте поставили ниво порука које логер треба игнорисати, користите ниво атрибут.
#! / уср / бин / енв рубин
захтева 'логер'
лог = Логгер.нев ('лог.ткт')
лог.левел = Логгер:: УПОЗОРЕЊЕ
лог.дебуг "Ово ће бити занемарено"
лог.еррор "Ово се неће занемарити"
Можете креирати онолико дневника дневника колико желите и можете евидентирати сваку ситницу која ваш програм ради, што приоритете чини изузетно корисним. Када покрећете свој програм, можете оставити ниво записника на нешто попут упозорења или грешке да бисте ухватили важне ствари. Затим, кад нешто пође по злу, можете спустити ниво записника (било у изворном коду или прекидачем командне линије) да бисте добили више информација.
Ротација
Библиотека дневника такође подржава ротацију дневника. Ротација дневника спречава да претпоставке постану превелике и помаже у претраживању старијих записа. Кад је ротација дневника омогућена, а записник достигне одређену величину или одређену старост, библиотека дневника ће преименовати ту датотеку и створити нову датотеку дневника. Старије датотеке дневника такође се могу конфигурирати тако да се након одређеног узраста избришу (или „испадну из ротације“).
Да бисте омогућили ротацију дневника, пренесите „месечно“, „недељно“ или „дневно“ конструктору Логгер-а. По избору, конструктору можете проследити максималну величину и број датотека које ћете задржати у ротацији.
#! / уср / бин / енв рубин
захтева 'логер'
лог = Логгер.нев ('лог.ткт', 'дневно')
лог.дебуг "Једном када дневник постане барем један"
лог.дебуг "дан стар, преименоват ће се у и"
лог.дебуг "нова датотека лог.ткт ће бити креирана."