Použití dortu v CoffeeScriptu

CoffeeScript je jazyk, který nám umožňuje psát lepší kód JavaScript, který jej sjednocuje a rámuje pod stejnou strukturou, kde si budeme jisti, že kód JavaScript vytvořený CoffeeScript od jiného vývojáře bude identický s naším.
Ale to není vše, co nabízí CoffeeScript, navíc má nástroj s názvem Dort, podobně jako Grunt, který nám umožňuje definovat jednoduché úkoly, které nám pomohou s našimi projekty, protože je možné, že potřebujeme úkol pro spuštění testů nebo jednoduše jeden pro vytvoření našich souborů a to vše můžeme provést pomocí Dort prostřednictvím souboru s názvem Dortový soubor.
PožadavkyK dokončení tohoto kurzu musíme mít funkční instalaci CoffeeScript, potřebujeme také oprávnění k zápisu souborů a spouštění CoffeeScript na počítači, kde provádíme tutoriál. Potřebujeme textový editor jako Vznešený text umět napsat kód našich příkladů a nikdy neuškodí podívat se na minulé návody k jazyku.
Před spuštěním je důležité zmínit, že nemusíme instalovat Dort, v době naší první instalace CoffeeScript nástroj je nainstalován stejným způsobem, takže nemusíme dělat nic dalšího, abychom s ním mohli začít pracovat.
S tímto vědomím můžeme začít pracovat Dort, ale musíme pochopit, že všechny úkoly, které vytváříme, musí být umístěny v souboru s názvem Cakefile, který musí mít od té doby přesně stejný název koláčový soubor bude to úplně jiný soubor a nebude kompilátorem rozpoznán.
Tento soubor musí být kořenem našeho projektu a je nesmírně důležité, aby jeho obsah byl pouze kód CoffeeScript. Když jsme to vyjasnili, pojďme se podívat, jak vytvořit náš první úkol pomocí Dort.
Vytvoříme složku s názvem dortový_soubor_příklad a tam vytvoříme soubor s názvem Cakefile.coffee a bude obsahovat následující obsah:

 úkol „pozdrav“, „Pojďme pozdravit velkou solvétskou komunitu“, -> console.log „Ahoj, světe!“

Před vysvětlením našeho kódu jej zkompilováme a uvidíme obsah vygenerovaný v JavaScriptu, není to nutné, protože tento kód nikdy neuvidíme, ale tentokrát bychom jej mohli použít k lepšímu porozumění tomu, co dělá CoffeeScript, podívejme se na výstup:

ZVĚTŠIT

Protože jsme v kontextu, můžeme vysvětlit náš kód, nejprve definujeme úkol pomocí funkce úkol který se automaticky přidá do každého souboru Cakefile. Prvním argumentem funkce je název úkolu, v tomto případě ano Pozdrav a použijeme jej v příkazové konzole k provedení úkolu, druhý argument může být volitelný a je popisem úkolu, který se objeví v seznamu našich dostupných úkolů. Poslední argument, který ve funkci posíláme úkol je to další funkce, kterou bude úkol provádět, a tam bude uložena většina naší logiky.
Předchozí příklad měl jen zkontrolovat, co kompilátor dělá, ale náš soubor Cakefile nesmí mít žádné rozšíření. Navíc můžeme pomocí příkazu vidět, jaké úkoly máme k dispozici dort V příkazové konzole se podívejme, jak to vypadá:

Jak vidíme, vidíme název našeho úkolu i popis. Nyní ke spuštění konkrétního úkolu použijeme příkaz dort a za ním název úkolu. Pro dokončení se podívejme na výstup z konzoly:

Už víme, jak vytvořit úkol a spustit ho, ale co když mu chceme předat nějaké argumenty? Co když například chceme, aby byl náš pozdrav zcela přizpůsoben hodnotě, kterou posíláme? To je docela snadné, uvidíme.
První věc, kterou musíme v našem úkolu udělat, je definovat možnost, uděláme to pomocí funkce volba dostupný Dort. Tato funkce má tři argumenty, první je krátká forma možnosti, druhá je dlouhá forma a poslední je popis toho, co tato možnost dělá, něco důležitého, pokud se vyvíjíme jako tým a chceme dokumentovat své úkoly. Poté provedeme úpravy v našem úkolu, abychom definovali možnost:

 volba '-n', '--name [NAME]', 'name to pozdrav' úkol "pozdrav", "Pozdravujeme někoho", (možnosti)-> zpráva = "Dobrý den", pokud options.name? message + = options.name else message + = "World" console.log message

Jak vidíme před definicí úkol máme svoji funkci volba, následuje krátký tvar, který by byl -n, pak máme dlouhý tvar, který by byl -name určující, že bude očekávat hodnotu a nakonec popis. Spustíme příkaz dort a uvidíme výstup v naší konzole:

Jak vidíme, máme název našeho úkolu, popis a pod ním máme k dispozici možnosti, krátké a dlouhé možnosti a také popis. Spustíme náš úkol pomocí krátké možnosti a uvidíme výstup z konzoly:

Chcete -li spustit úkol s možnostmi, je důležité, abychom nejprve zadali argumenty a poté název úkolu, protože pokud nenarazíme na chybu, nevypovídá to o tom, co se může stát s naším souborem Cakefile, pak se podívejme, jak provedení používá druhou možnost:

Zde se děje něco zvláštního, a to je, že před spuštěním úkolu použijeme možnost s jediným skriptem, což nám dává chybu a je to správná věc, protože v našem úkolu jsme definovali možnost jako --- název místo -name, což dokazuje účinnost CoffeeScript pro provoz úkolů.
Kromě toho můžeme definovat, zda je požadována možnost, a provedeme to v definici úlohy, která kontroluje, zda hodnota existuje, a pokud nevyhodíme chybu, podívejme se, jak tento kód vypadá:

 možnost '-n', '--name [NAME]', 'jméno, které chcete pozdravit' úkol "pozdrav", "Ověřit, že tato možnost existuje", (možnosti)-> vyvolat novou chybu ("[NAME] je požadovaná hodnota "), pokud options.name? console.log "Dobrý den, # {options.name}"

Pojďme tedy spustit náš úkol, ale tentokrát tuto možnost ignorujeme jako argument a uvidíme odpověď z konzoly:

Jak vidíme, byla zobrazena chyba, kterou jsme zahrnuli do souboru, takže jsme mohli ověřit, že možnosti našich úkolů jsou v případě potřeby předávány jako argumenty.
Když jsme již viděli, jak vytvářet naše úkoly a definovat pro ně možnosti, je důležité zjistit, jak můžeme provádět úkoly, které se nacházejí v rámci ostatních. Například můžeme mít dva společné úkoly v projektu, kde jeden z úkolů má na starosti čištění adresářů, které jsme pro projekt vytvořili, a druhý má na starosti sestavování a vytváření, podívejme se, jak tyto dva úkoly, které právě jsme vypadali. popište:

 úkol "vyčistit", "Tento úkol provádí čištění adresářů", -> console.log "čištění adresáře …" úkol "build", "Sestavit a zkompilovat soubory pro projekt", -> console.log "budova …"

Chystáme se provést příkaz dort a podívejme se na odpověď prostřednictvím konzoly:

Kromě toho ke spuštění obou úkolů společně můžeme použít příkaz dort, za kterým následují oba názvy našich úkolů:

Jak vidíme, na našich úkolech není nic divného, ​​ale pokud jsme pozorovatelé, uvědomujeme si, že nejprve musíme provést úklid vždy před naším stavebním úkolem, ale co když chceme třetí úkol nazvaný balení, který pak zabalí projekt pro nás? Nejprve to tedy musíme postavit, ujistit se, že jsou adresáře čisté a nakonec sestavit.
Problém je v tom, že toto řešení není optimální, pokud z nějakého důvodu zapomeneme zavolat čistý úkol nebo ještě hůře, náš úkol sestavení bude mít problémy s naším třetím úkolem, naštěstí nám dort umožňuje zavolat jeden úkol v rámci druhého pomocí funkce vyvolat, pak se podívejme, jak náš soubor vypadá Dortový soubor s novým úkolem a úpravami:

 úkol "vyčistit", "Tento úkol provádí čištění adresářů", -> console.log "čištění adresáře …" úkol "build", "Sestavit a zkompilovat soubory pro projekt", -> console.log "building …" task "pack", "clean, build and pack our project", -> vyvolat "clean" vyvolat "build" console.log "packing …"

Nyní musíme zavolat naše obaly a tímto způsobem zajistíme, aby další dva požadované úkoly byly volány bez problémů, podívejme se na výstup v příkazové konzole:

Je důležité zmínit, že úkoly, které používají funkci vyvolat jsou prováděny asynchronně, takže nemáme žádnou záruku, že úklidová úloha bude provedena před sestavením a zabalením, takže musíme být opatrní při jejich používání.
Tímto ukončujeme tento tutoriál, kde jsme se naučili vytvářet naše úkoly, spouštět je, dávat jim možnosti a dokonce i to, jak vyvolat další úkoly v rámci ostatních, čímž rozšiřujeme své znalosti v tomto efektivním jazyce, který přispívá k osvědčeným postupům jakéhokoli vývoje.Líbil se vám tento návod a pomohl mu?Autora můžete odměnit stisknutím tohoto tlačítka, čímž mu dáte kladný bod