Differences

This shows you the differences between two versions of the page.

--- user:zeman:dz-parser:vystupy.pm [2007/03/28 16:39]
zeman vytvořeno
+++ user:zeman:dz-parser:vystupy.pm [2007/03/28 23:42] (current)
zeman
@@ Line 1: / Line 1: @@
-Návrh řešení vstupů a výstupů v DZ Parseru
+====== vystupy.pm ======
+Modul umožňuje řídit výstupy z programu a podle potřeby je přesměrovávat nebo logovat do souborů, posílat mailem atd. Ti, kdo posílají data na výstup přes tento modul, se nemusejí starat, zda je soubor pro jejich druh výstupu již otevřen atd.
+Standardní použití: místo ''print()'' voláte funkci ''vystup()'', které předáte řetězec identifikující váš výstupní proud a řetězec, který se má vypsat.
+<code perl>vystup("hlavni", "Tento text jde na výstup.\n");</code>
+Pokud modulu vystupy někdo dříve neřekl něco jiného, váš text poputuje na ''STDERR''.
+Typická věc, kterou asi budete chtít udělat, je zvolit jeden výstup, který má jít na ''STDOUT'' místo na ''STDERR''. Samozřejmě to stačí udělat jednou na začátku programu. V případě potřeby můžete na ''STDOUT'' přesměrovat i více výstupů najednou.
+<code perl>use vystupy;
+$vystupy::vystupy{hlavni}{stdout} = 1;</code>
+Zapnutí STDOUTu pro určitý výstup automaticky pro tento výstup vypne STDERR. Pokud byste chtěli posílat dotyčný výstup současně na STDOUT i STDERR, musíte to explicitně říct:
+<code perl>use vystupy;
+$vystupy::vystupy{hlavni}{stdout} = 1;
+$vystupy::vystupy{hlavni}{stderr} = 1;</code>
+Skutečné výhody použití modulu vystupy se projeví teprve, když chcete své výstupy logovat do souborů, abyste mohli později zjišťovat, proč program provedl to, co provedl. Modulu stačí říct cestu ke složce, kde se logy ukládají. Modul zajistí, aby logy z tohoto běhu programu nepřepsaly žádné starší logy. Každému souboru vyrobí jméno ve tvaru //n.x//, kde //n// je dosud nepoužité číslo (jednoznačně identifikuje běh programu v rámci této složky) a //x// je název výstupu.
+Logování půjde zapnout buď globálně pro všechny výstupy (něco jako $vystupy::log = 1) nebo jmenovitě pro jednotlivé výstupy ($vystupy::vystupy{hlavni}{log} = 1). Bude-li zapnuto globální logování, k nastavení logování u jednotlivých výstupů se nebude přihlížet. Tohle zatím není implementováno. Dosud se to dělalo tak, že v konfiguračním souboru se zapnul režim debug a všechny výstupy se logovaly.
+Další věci, které už jsou ve vystupy.pm nějak udělané, ale jejich implementaci by to chtělo dotáhnout, resp. zelegantnit:
+  * míra ukecanosti a ladění (některé skupiny výstupů lze plošně vypnout, pokud uživatel nepožaduje ladící režim)
+  * kódování jednotlivých výstupů (defaultně utf-8; další se přečte z konfiguráku, popř. nastavit jedno kódování pro všechny výstupy, které jdou přímo do terminálu, popř. se přímo dívat, zda jsme v dosu)
+  * Některé výstupy chci pouze jako log, ale nechci je vidět na obrazovce (STDERR). Takže pokud je logování plošně vypnuté, tento výstup se úplně zahodí, pokud je zapnuté, tento výstup jde do logu. To není totéž, jako když je logování plošně vypnuté a nějaký soubor pošlu do logu natruc. Příklad: záznam konfigurace, s jakou byl běh spuštěn.
+  * Posílání některých výstupů mailem (typicky závěrečný mail s výsledky testu; mail je současně upozorněním, že výpočet už doběhl). V budoucnosti bych mohl alternativně zařídit i upozornění na příkazovém řádku, jako jsem to měl v Marylandu.
+====== Návrh řešení vstupů a výstupů v DZ Parseru ======
 S výjimkou dočasných ladících výstupů na STDERR má monopol na výstup modul vystup. Všechny ostatní moduly volají jeho funkci vystup($nazev_vystupu).
@@ Line 33: / Line 63: @@
 Jak tedy na výše nastíněný model přejít z toho, co mám teď? Ze všeho nejdřív asi musím odbourat konfigurační soubor. Z něj se mi pořád načítají cesty, odkud co číst a kam co psát.

[ Back to the navigation ] [ Back to the content ]

Institute of Formal and Applied Linguistics Wiki

Differences