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 7706×

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ů

14.11.2017 16:56 /František Kučera
Máš rád svobodný software a hardware nebo se o nich chceš něco dozvědět? Zajímá tě DIY, CNC, SDR nebo morseovka? Přijď na sraz spolku OpenAlt – tradičně první čtvrtek před třetím pátkem v měsíci: 16. listopadu od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

12.11.2017 11:06 /Redakce Linuxsoft.cz
PR: 4. ročník odborné IT konference na téma Datová centra pro business proběhne již ve čtvrtek 23. listopadu 2017 v konferenčním centru Vavruška, v paláci Charitas, Karlovo náměstí 5, Praha 2 (u metra Karlovo náměstí) od 9:00. Konference o návrhu, budování, správě a efektivním využívání datových center nabídne odpovědi na aktuální a často řešené otázky, např Jaké jsou aktuální trendy v oblasti datových center a jak je využít pro vlastní prospěch? Jak zajistit pro firmu či jinou organizaci odpovídající služby datových center? Podle jakých kritérií vybrat dodavatele služeb? Jak volit součásti infrastruktury při budování či rozšiřování vlastního datového centra? Jak efektivně spravovat datové centrum? Jak eliminovat možná rizika? apod.
Přidat komentář

13.9.2017 8:00 /František Kučera
Máš rád svobodný software a hardware nebo se o nich chceš něco dozvědět? Zajímá tě DIY, CNC, SDR nebo morseovka? Přijď na sraz spolku OpenAlt – tentokrát netradičně v pondělí: 18. září od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

3.9.2017 20:45 /Redakce Linuxsoft.cz
PR: Dne 21. září 2017 proběhne v Praze konference "Mobilní řešení pro business". Hlavní tématy konference budou: nejnovější trendy v oblasti mobilních řešení pro firmy, efektivní využití mobilních zařízení, bezpečnostní rizika a řešení pro jejich omezení, správa mobilních zařízení ve firmách a další.
Přidat komentář

15.5.2017 23:50 /František Kučera
Máš rád svobodný software a hardware nebo se o nich chceš něco dozvědět? Zajímá tě DIY, CNC, SDR nebo morseovka? Přijď na sraz spolku OpenAlt, který se bude konat ve čtvrtek 18. května od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5).
Přidat komentář

12.5.2017 16:42 /Honza Javorek
PyCon CZ, česká konference o programovacím jazyce Python, se po dvou úspěšných ročnících v Brně bude letos konat v Praze, a to 8. až 10. června. Na konferenci letos zavítá např. i Armin Ronacher, známý především jako autor frameworku Flask, šablon Jinja2/Twig, a dalších projektů. Těšit se můžete na přednášky o datové analytice, tvorbě webu, testování, tvorbě API, učení a mentorování programování, přednášky o rozvoji komunity, o použití Pythonu ve vědě nebo k ovládání nejrůznějších zařízení (MicroPython). Na vlastní prsty si můžete na workshopech vyzkoušet postavit Pythonem ovládaného robota, naučit se učit šestileté děti programovat, efektivně testovat nebo si v Pythonu pohrát s kartografickým materiálem. Kupujte lístky, dokud jsou.
Přidat komentář

2.5.2017 9:20 /Eva Rázgová
Putovní konference československé Drupal komunity "DrupalCamp Československo" se tentokrát koná 27. 5.2017 na VUT FIT v Brně. Můžete načerpat a vyměnit si zkušenosti z oblasti Drupalu 7 a 8, UX, SEO, managementu týmového vývoje, využití Dockeru pro Drupal a dalších. Vítáni jsou nováčci i experti. Akci pořádají Slovenská Drupal Asociácia a česká Asociace pro Drupal. Registrace na webu .
Přidat komentář

1.5.2017 20:31 /Pavel `Goldenfish' Kysilka
PR: 25.5.2017 proběhne v Praze konference na téma Firemní informační systémy. Hlavními tématy jsou: Informační systémy s vlastní inteligencí, efektivní práce s dokumenty, mobilní přístup k datům nebo využívání cloudu.
Přidat komentář

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

> Poslední diskuze

5.12.2017 11:50 / Thomas
kitchen renovations

18.9.2017 14:37 / Rojas
high security vault

15.9.2017 7:33 / Wilson
new zealand childcare jobs

31.8.2017 12:11 / Jaromir Obr
Re: ukůládání dat ze souboru

30.7.2017 11:12 / Jaromir Obr
Národní znaky

Více ...

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