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

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ů

16.7.2018 1:05 /František Kučera
Červencový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 19. 7. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát bude přednáška na téma: automatizační nástroj Ansible, kterou si připravil Martin Vicián.
Přidat komentář

18.6.2018 0:43 /František Kučera
Červnový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 21. 6. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát na téma: F-Droid, aneb svobodný software do vašeho mobilu. Kromě toho budou k vidění i vývojové desky HiFive1 se svobodným/otevřeným čipem RISC-V.
Přidat komentář

23.5.2018 20:55 /Ondřej Čečák
Od pátku 25.5. proběhne na Fakultě informačních technologií ČVUT v Praze openSUSE Conference. Můžete se těšit na spostu zajímavých přednášek, workshopů a také na Release Party nového openSUSE leap 15.0. V na stejném místě proběhne v sobotu 26.5. i seminář o bezpečnosti CryptoFest.
Přidat komentář

20.5.2018 17:45 /Redakce Linuxsoft.cz
Ve čtvrtek 31. května 2018 připravuje webový magazín BusinessIT ve spolupráci s Best Online Média s.r.o. pátý ročník odborné konference Firemní informační systémy 2018. Akce proběhne v kongresovém centru Vavruška (palác Charitas), Karlovo náměstí 5, Praha 2 (u metra Karlovo náměstí) od 9:00 hod. dopoledne do cca 15 hod. odpoledne. Konference je zaměřena na efektivní využití firemních informačních systémů a na to, jak plně využít jejich potenciál. Podrobnější informace na webových stránkách konfrence.
Přidat komentář

14.5.2018 7:28 /František Kučera
Květnový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 17. 5. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát na téma: Audio – zvuk v GNU/Linuxu.
Přidat komentář

7.5.2018 16:20 /František Kučera
Na stránkách spolku OpenAlt vyšla fotoreportáž Pražské srazy 2017 dokumentující srazy za uplynulý rok. Květnový pražský sraz na téma audio se bude konat 17. 5. 2018 (místo a čas ještě upřesníme).
Přidat komentář

17.4.2018 0:46 /František Kučera
Dubnový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 19. 4. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tématem tohoto srazu bude OpenStreetMap (OSM) aneb svobodné mapy.
Přidat komentář

16.3.2018 22:01 /František Kučera
Kulatý OpenAlt sraz v Praze oslavíme klasicky: u limonády a piva! Přijďte si posedět, dát si dobré jídlo a vybrat z mnoha piv do restaurace Kulový blesk, který najdete v centru Prahy nedaleko metra I. P. Pavlova na adrese Sokolská 13, Praha 2. Sraz se koná ve čtvrtek 22. března a začínáme v 18:00. Heslo: OpenAlt. Vezměte s sebou svoje hračky! Uvítáme, když si s sebou na sraz vezmete svoje oblíbené hračky. Jestli máte nějaký drobný projekt postavený na Arduinu, nějakou zajímavou elektronickou součástku, či třeba i pěkný úlovek z crowdfundingové akce, neváhejte. Oslníte ostatní a o zábavu bude postaráno.
Přidat komentář

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

> Poslední diskuze

20.2.2018 18:48 / Ivan Majer
portal

20.2.2018 15:57 / Jan Havel
Jak využíváte služby cloudu v podnikání?

16.1.2018 1:08 / Ivan Pittner
verejna ip od o2 ubuntu

15.1.2018 17:26 / Mira Harvalik
Re: Jak udělat HTML/Javascript swiping gallery do mobilu?

30.12.2017 20:16 / Michal Knoll
odmocnina

Více ...

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