LINUXSOFT.cz Přeskoč levou lištu
Uživatel: Heslo:  
   CZUKPL

> Perl (106) - Debugování pomocí komentářů

Perl Do komentářů budeme zapisovat příkazy se speciální syntaxí, které nám vypíší ladící informace. Jde o zajímavou alternativu k již známým nástrojům.

24.3.2010 00:00 | Jiří Václavík | Články autora | přečteno 6633×

Komentáře v programu se dají využít i k jiným účelům než jen k popisování toho, co se na kterém řádku děje. Modul Smart::Comments stanovuje pravidla, jak využít komentáře k debugování. Funguje tak, že komentáře mají speciální syntaxi a nejsou jen přeskakovány, nýbrž zvlášť vyhodnoceny.

Nejprve nainstalujeme modul Smart::Comments.

$ cpan Smart::Comments

Aktivace režimu Smart::Comments

Abychom mohli využívat výhod, které modul Smart::Comments skýtá, stačí na začátek programu přidat následující řádek.

use Smart::Comments;

Jakmile program odladíme, budeme pravděpodobně chtít režim vypnout. Zde je nejlepším řešením právě uvedený řádek pouze zakomentovat.

Syntaxe speciálních komentářů

Všechny komentáře, které mají být dále nějakým způsobem vyhodnocovány mají následující tvar.

### příkaz
#### příkaz
##### příkaz

Tyto příkazy mají za následek vypsání požadovaných dat na STDERR.

Křížků na začátku komentáře může být libovolně mnoho, nejméně však tři. Jejich počet dělí příkazy do skupin, které lze podle potřeby aktivovat nebo deaktivovat.

To, které skupiny příkazů budou právě aktivní se určuje podle seznamu parametrů předanému příkazu use. Například tento příkaz ovlivní komentáře tak, že aktivuje pouze příkazy uvedené po třech nebo čtyřech křížcích.

use Smart::Comments "###", "####";

Ostatní (například ty, které začínají pěti křížky) interpretovány nebudou.

Výpis textu

Nejjednodušší úkon, který nám provede Smart::Comments je výpis textu. Jako text se chápe každý příkaz za křížky, který končí třemi tečkami. Zkusme spustit následující kód.

use Smart::Comments;
...
### Pripravuji testovani...
...

Na výstupu na STDERR uvidíme následující.

### Pripravuji testovani...

Na tomto místě je zajímavé se znovu zamyslet nad tím, že komentář skutečně vypisuje data. Takové užití je možná neočekávané, avšak účelné, zejména, jak uvidíme dále, ve spojitosti s dalšími druhy příkazů.

V textu můžeme použít i speciální proměnné.

  • <now> - vypíše místo sebe datum a čas
  • <here> - vypíše místo sebe jméno souboru a řádek

Zkusme tedy do programu zapracovat následující řádek.

### [<now>] <here> -- Pripravuji testovani...

Ve výstupu bychom měli vidět, že se skutečně proměnné nahradily.

### [Wed Apr 14 02:12:44 2010] "pokus.pl", line 8 -- Pripravuji testovani...

Výpis proměnných

Další věc, kterou lze se Smart::Comments dělat, je výpis aktuální hodnoty nějakého výrazu. Napišme tedy za křížky nějaký výraz. Příklad úseku zdrojového kódu je zde.

use Smart::Comments;
$u = 7;
### 5 * 6
### $u

Tento kód vytiskne po spuštění programu na STDERR následující.

### 5 * 6: 30
### $u: 7

Výrazy s popisky

Příkaz tvaru popisek : výraz tiskne k hodnotě výrazu vlastní popisek. Uveďme příklad.

$pi=$namereny_obvod_kruhu/$namereny_prumer_kruhu;
### Ocekavano: 3.14159265
### Nase aproximace: $pi

Výsledkem po spuštění bude tento výstup.

### Ocekavano: '3.14159265'
### Nase aproximace: '3.14245681'

Kontrola výrazů

Klíčové slovo require (resp. jeho synonyma ensure, insist, assert) vyhodnocuje logický výraz. Očekáváno je, že jeho výsledkem bude pravda. Pokud tomu tak není, bude volána funkce die.

Vložme tedy někam do zdrojového kódu tento řádek.

### require: $rok > 2008

Je-li v proměnné $rok skutečně hodnota větší než 2008, vše je v pořádku a nedostaneme ani žádný výstup. V opačném případě ale už vynadáno dostaneme.

### $rok > 2008 was not true at pokus.pl line 9.
###     $rok was: 2001

Ukažme si ještě složitější příklad. Změníme logický výraz.

### require: $rok > 2008 or ($rok == 2008 and $mesic > 6)

Jak si s ním Smart::Comments poradí? V případě nepravdy nám vypíše hodnoty všech proměnných, které byly ve výrazu použité.

### $rok > 2008 or ($rok=2008  and $mesic > 6) was not true at comm.pl line 10.
###     $rok was: 2008
###     $mesic was: 5

Zajímavé je, že se zde samo rozpozná, které proměnné ve výrazu figurují. Kdybychom nebyli v kometáři, museli bychom s obdobným problémem postupovat daleko složitěji (stačí se podívat například na rozdíl mezi funkcemi ok a is z modulu Test::More), protože takový výraz by se vyhodnotil, aniž bychom s ním stihli cokoliv udělat.

Použijeme-li místo require (případně jeho synonym) klíčové slovo check, confirm nebo verify, bude v případě neúspěchu místo die volána funkce warn. Nezastavíme tedy program, ale jen způsobíme varování.

Animovaný progresbar

Perl obsahuje několik druhů cyklů. V případě, že právě používáme for, foreach, while nebo until, můžeme k němu vytvořit animovaný progresbar, nebo-li měnící se komentář.

Pokud neprovádíme nějaké složité výpočty nebo neprovádíme velké množství iterací, cykly většinou zaberou jen zlomky sekundy. V takovém případě bude jakékoliv animování nepostřehnutelné.

Trvá-li však výpočet dlouho, můžeme progresbar vyzkoušet. Vložme do programu nějaký cyklus a za ním uveďme komentář následujícího tvaru.

for (1..1_000_000) {       ### pracuji...      hotovo
  1+1;
}

Říká se, že milion nic zabije slona. Pravdivost tohoto tvrzení potvrzuje i předchozí kód. Na běžném počítači jeho provedení několik sekund trvá. Díky tomu progressbar snadno zaznamenáme. Uvidíme řádek, na kterém budou přibývat s postupujícími iteracemi tečky. Po pár set tisících iterací bude progressbar vypadat takto.

pracuji......                  hotovo

Komu se nelíbí tečky, může použít jiný symbol. Zde je několik možností.

### pracuji:::      hotovo
### pracuji===      hotovo
### pracuji|||      hotovo
### pracuji[]       hotovo
### pracuji{}       hotovo
### pracuji===>     hotovo
### pracuji [===>    ] hotovo

Předposlední komentář na konec progressbaru přidává symbol >. Poslední navíc umísťuje celý progressbar do závorek, kde je o něco patrnější.

Možností je ještě více. Koho zajímají, může buď experimentovat nebo se podívat do dokumentace.

Ještě zajímavější to můžeme udělat, když přidáme počet hotových procent. Změníme náš kód na následující.

for (1..1_000_000) {       ### pracuji [===>[%]   ] hotovo
  1+1;
}

Pak bude výstup zhruba v polovině iterací vypadat následovně.

pracuji [.......[63%]        ] hotovo

U cyklů, kde neznáme předem počet iterací (například while) se místo údaje o procentech zobrazí počet hotových iterací.

Časový progresbar

U cyklu for progressbar mimo jiné odhaduje, jak dlouho bude ještě trvat. Měří se zde čas a počítá se průměrná délka iterace. Vyzkoušejme následující úsek.

for (1..15) {      ### prubeh [===[%]    ]
   sleep 2;
}

Po chvíli uvidíme, kolik sekund nám zbývá do konce cyklu.

prubeh [====[35%]                 ]  (about 20 seconds remaining)

Verze pro tisk

pridej.cz

 

DISKUZE

Nejsou žádné diskuzní příspěvky u dané položky.



Příspívat do diskuze mohou pouze registrovaní uživatelé.
> Vyhledávání software
> Vyhledávání článků

24.8.2016 6:44 /Ondřej Čečák
Poslední týden CFP LinuxDays 2016; pokud byste rádi přednášeli na LinuxDays 2016 8. a 9. října v Praze, můžete svůj příspěvek přihlásit, následovat bude veřejné hlasování.
Přidat komentář

9.8.2016 22:56 /Petr Ježek
Zařazení souborového systému reiser4 do jádra 4.7 znamená konečně konec patchování jádra jen kvůli možnosti použít reiser4.
Přidat komentář

12.7.2016 13:14 /František Kučera
Spolek OpenAlt zve na 130. distribuovaný sraz příznivců svobodného softwaru a otevřených technologií (hardware, 3D tisk, SDR, DIY, makers…), který se bude konat ve čtvrtek 21. července od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

11.7.2016 16:53 /Redakce Linuxsoft.cz
Konference LinuxDays hledá přednášející. Přihlášky poběží do konce prázdnin, v září bude hlasování a program. Více na https://www.linuxdays.cz/2016/cfp/.
Přidat komentář

8.5.2016 17:19 /Redakce Linuxsoft.cz
PR: Dne 26.5.2016 proběhne v Praze konference Cloud computing v praxi. Tématy bude např. nejnovější trendy v oblasti cloudu a cloudových řešení, cloudové služby, infrastruktura cloudu, efektivní využití cloudu, možné nástrahy cloudů a jak se jim vyhnout
Přidat komentář

21.4.2016 8:01 /František Kučera
Spolek OpenAlt zve na 127. distribuovaný sraz příznivců svobodného softwaru a otevřených technologií (hardware, 3D tisk, SDR, DIY, makers…), který se bude konat ve čtvrtek 28. dubna od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

2.3.2016 22:41 /Ondřej Čečák
Letošní ročník konference InstallFest již tento víkend!
Přidat komentář

14.2.2016 16:39 /Redakce Linuxsoft.cz
O víkendu 5. a 6. března 2016 proběhne na pražském Strahově 8. ročník tradiční konference InstallFest. Celkem za dva dny uvidíte ​30 přednášek​ a ​6 workshopů.
Přidat komentář

   Více ...   Přidat zprávičku

> Poslední diskuze

12.8.2016 11:51 / Josef Zapletal
Jak udělat HTML/Javascript swiping gallery do mobilu?

8.8.2016 14:58 / Adams
fairies for hire

28.7.2016 15:51 / pepan
Re: NetBeans vs Eclipse

10.6.2016 21:10 / pavel riha
FreeBSD 10.3 a virtualizace

8.6.2016 21:56 / Milan Gallas
Nevalidní prefix m

Více ...

ISSN 1801-3805 | Provozovatel: Pavel Kysilka, IČ: 72868490 (2003-2016) | mail at linuxsoft dot cz | Design: www.megadesign.cz | Textová verze