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

> SCONS - Nástroj pro sestavování software - 8

Pokračování autokonfigurace a psaní vlastních testů

30.8.2010 00:00 | Radim Kolář | Články autora | přečteno 3241×

Pokročilé testy při autokonfiguraci

Než se vrhneme na psaní vlastních testů tak se ještě podíváme na tři vestavěné testy, které se do minulého dílu nevešly. Nejsou to všechny vestavěné testy které SCons obsahuje ale já jsem je v seriálu nezmínil. Vynechám testy které už jsou pro pokročilé SCons uživatele protože nemám v úmyslu probírat zde SCons tak do hloubky. Po prostudování toho seriálu by jste se měli stát dostatečně zruční ve SCons, abyjste ho mohli bezproblémů začít používat ve svých projektech.

Všechny tři testy si jsou dost podobné. SCons jimi předhodíme program jako řetězec a necháme ho zpracovat. Jednotlivé testy se liší pouze v tom jak daleko v jeho zpracování dojdem. Nejjednoduším případem je test TryCompile. Ten přeloží námi zadaný text v jazyku, který určuje koncovka souboru. Test na úspěšnou kompilaci se obvykle používá při psaní vlastních testů, ale dá se také použít pokud chceme otestovat něco složitějšího. Dobrý trik je používat direktivu C preprocesoru #error na kterou když překladač narazí tak přeruší překlad s chybou. Druhý parametr funkce TryCompile je koncovka souboru, kterou musíme uvést včetně tečky.

Zde si všimněte použití r""" syntaxe pro snadné víceřádkové řetězce v Pythonu. Je to nejjednoduší způsob jak zadat testovací C program do SConscruct.

fbsd8:/tmp> cat SConstruct
env = Environment()
conf = Configure(env)

print conf.TryCompile(r"""
#include <stdlib.h>
#ifdef NULL
#else
#error "NULL not defined"
#endif
""",'.C')

env=conf.Finish()
fbsd8:/tmp> scons -Q
1
scons: `.' is up to date.

Dalším stupněm je funkce TryLink. Ta program nejen přeloží, jako to dělá TryCompile, ale i slinkuje oproti knihovnám které jsou nadefinované v proměnné prostředí LIBS. Nepoužívá se to moc často, protože CheckLib případně jeho zlepšená varianta CheckLibWithHeader obvykle úplně dostačuje.

TryLink funkce je vhodná na ověření funkčnosti prostředí kompilátoru a používá se zejména při tvorbě uzavřeného softwaru, kde neděláme autodetekci jednotlivých komponent zda jsou k dispozici, protože víme dopředu jaké komponenty máme nainstalované a jen si před začátkem buildu zjistíme zda jsou funkční a zda máme všechno nastavené správně. Testovací program pak obsahuje odkazy na funkce z námi používaných knihoven - z každé stačí jedna. Jelikož se testovací program bude jen kompilovat a nikoliv spouštět není potřeba dbát na správnou posloupnost volání funkcí.

Pokud používáte překladač Clang tak si při psaní testovacích programů dejte pozor na jeho optimalizaci volání funkcí případně IPO. Ve zkratce jde o to, že pokud volaná funkce nemá deklarován postranní efekt a vrací hodnotu s kterou se dál nepracuje tak Clang volání této funkce vyoptimalizuje - volání se neprovede a funkce se ani nepřilinkuje. V tomto případě pak nezjistíme nic, protože test bude vždy úspěšný.

V tomto příkladu nejprve pomocí CheckLib najdeme knihovnu OpenSSL a pak zkusíme přeložit testovací program.

fbsd8:/tmp> cat SConstruct
env = Environment()
conf = Configure(env)

conf.CheckLib('ssl','SSL_connect')

print conf.TryLink(r"""
#include <openssl/ssl.h>

int main(int argc, char* argv[]) {
        SSL_library_init();
}

""",'.C')

env=conf.Finish()
fbsd8:/tmp> scons
scons: Reading SConscript files ...
Checking for SSL_connect() in C library ssl... (cached) yes
1
scons: done reading SConscript files.
scons: Building targets ...
scons: `.' is up to date.
scons: done building targets.

Poslední z dnešní sady testovacích funkcí je TryRun. Ta je zajímavá a velmi užitečná. Tuto funkci ale nemůžeme použít pokud provádíme cross-kompilaci, protože testovaný program bude spuštěn na hostitelské, nikoliv cílové, platformě. Po zavolání této funkce dojde k přeložení, slinkování a spuštění programu. Pokud program skončí s návratovým kódem 0, tedy úspěšně, bude SCons frameworku předán jeho standardní výstup.

fbsd8:/tmp> cat SConstruct
env = Environment()
conf = Configure(env)

conf.CheckLib('ssl','SSL_connect')

print "Odpoved na otazku zivota, vesmiru a vubec je",conf.TryRun(r"""
#include <stdio.h>
#include <openssl/ssl.h>

int main(int argc, char* argv[]) {
        printf("%d",42*SSL_library_init());
		return 0;
}

""",'.C')[1]

env=conf.Finish()
fbsd8:/tmp> scons
scons: Reading SConscript files ...
Checking for SSL_connect() in C library ssl... (cached) yes
Odpoved na otazku zivota, vesmiru a vubec je 42
scons: done reading SConscript files.
scons: Building targets ...
scons: `.' is up to date.
scons: done building targets.

Vlastní testy

Naprogramovat si vlastní testy je v SCons velmi jednoduché. Stačí jen naprogramovat Python funkci, která bude zavolána s konfiguračním kontextem jako argumentem a pak SCons poučit o tom, že máme k dispozici nový test.

Pro programování vlastního testu můžeme použít dosavadní testy z kterých se nám obvykle hodí dnes probírané funkce z rodiny Try... Kromě toho máme k dispozici celý Python včetně rosáhlé standardní knihovny a pokud to stále nestačí můžeme si do Pythonu nainstalovat dodatečné knihovny za cenu menší přenositelnosti námi napsaných testů.

V testu je dobré používat funkce Message a Result, které uživatelsky příjemně vytisknou průběh a výsledek testu. Nulová hodnota předaná funkci Result značí neúspěch, jednička úspěšné zakončení testu. Stejnou hodnutu musíme z funkce vrátit pomocí return. Pokud budeme potřebovat přistupovat k prostředí, které pomocí testu nastavujeme, tak ho najdeme v položce konfiguračního kontextu s názvem env.

Jazyk Python má jednoprůchodový parser a tak je potřeba test definovat předtím než ho předáme funkci Configure. Podívejte se na jednoduchý příklad. Všimněte si že se jméno testu nemusí shodovat se jménem funkce.

env = Environment()

def jepondeli(conf):
   import time
   conf.Message("Testuji zda je dnes pondeli... ")
   dnes=time.localtime(time.time())
   if dnes[5] == 0:
      rc=1
   else:
      rc=0
   conf.Result(rc)
   return rc

conf = Configure(env, custom_tests={'jePondeli':jepondeli})
if conf.jePondeli():
   env.Append(CPPFLAGS = "-DPONDELI")

env=conf.Finish()

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ů

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ář

5.2.2016 17:38 /Petr Ježek
Utilitka z XFce "xfce4-power-manager" nejen umožňuje nastavení lhůty pro uspání či hybernaci, ale i zapínání a vypínání prezentačního módu pro nerušené sledování videí. Stačí ji nastavit v každém vybavenějším panelu a v jakémkoli nontiled WM/DE.
Přidat komentář

10.1.2016 11:32 /Pavel `Goldenfish' Kysilka
LinuxMarket změnil provozovatele. Nově jej provozuje Marek Pszczolka. Více info a detaily #1 a #2.
Přidat komentář

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

> Poslední diskuze

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

7.5.2016 14:58 / Teodor Komárek
Soubory

20.4.2016 0:07 / Jakub Cleing
Sázkový panel PHP FUSION

Více ...

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