v1.0.1

Určení CLI pro kompilaci více souborů SCSS do jediného souboru CSS, aby se zabránilo propojení milionu souborů CSS v rámci projektu. Compile SCSS využívá ke konstrukci svého rozhraní CLI funkci Click.

Instalace

pip install compile_scss

Použití

Spustit compile_scss

Pokud je compile_scssspuštěn bez jakýchkoli voleb nebo příznaků, Compile SCSS vyhledá v kořenovém adresáři projektu soubor s názvem compile_scss_config.json, který uchovává objekt JSON s předdefinovanými hodnotami konfigurace uživatele.

Jestliže je konfigurační soubor nalezen, Compile SCSS se spustí s použitím konfigurace nalezené v souboru JSON. Pokud není nalezen žádný konfigurační soubor, bude spuštěno čtení, vyhodnocení, tisk, smyčka (R.E.P.L.) a uživatel bude mít možnost nastavit nové konfigurační hodnoty pomocí řady výzev.

Options

--root <PROJECT_ROOT_DIRECTORY>

Volba --root umožňuje uživateli určit kořenový adresář svého projektu. Compile SCSS bude v tomto adresáři hledat soubor compile_scss_config.json. >

Výchozí cesta ke kořenovému adresáři je ./, což znamená ten adresář, z něhož je volán compile_scss.

--set-config

Pokud je příznak --set-config přítomen, konfigurace R.E.P.L. bude standardně spuštěn.

Pokud byl nalezen konfigurační soubor, bude mít uživatel možnost buď vytvořit nový konfigurační soubor, nebo pokračovat s hodnotami nalezenými v konfiguračním souboru.

Pokud nebyl nalezen žádný konfigurační soubor, bude mít uživatel možnost vytvořit nový konfigurační soubor.

--watch

Je-li příznak --watch přítomen, bude Compile SCSS sledovat adresář SCSS uvedený v konfiguračním souboru, zda nedošlo ke změnám, a podle toho aktualizovat soubor CSS.

Konfigurace

Ve výchozím nastavení bude Compile SCSS hledat v kořenovém adresáři projektu soubor s názvem compile_scss_config.json. Tento soubor musí být přítomen a musí obsahovat platný konfigurační objekt, aby se Compile SCSS spustil.

Konfigurační soubor musí obsahovat pět klíčů a odpovídající hodnoty:

• root – Kořenový adresář projektu. Výchozí hodnota je ./

• scss_dir – Adresář nejvyšší úrovně SCSS pro projekt. Tento adresář může obsahovat podadresáře a libovolný počet souborů SCSS. Aby byla cesta scss_dir platnou cestou SCSS, musí vést do adresáře obsahujícího alespoň jeden soubor SCSS.

• css_dir – Adresář CSS obsahující hlavní soubor CSS. Zde Compile SCSS vygeneruje svůj výstupní soubor CSS.

• css_filename – Požadovaný název cílového souboru CSS.

  Název souboru nesmí obsahovat jiné speciální znaky než neúvodní/koncové pomlčky nebo podtržítka. Přípona souboru musí být psána malými písmeny, ale název souboru může obsahovat velká písmena.

  Příklady platných a neplatných názvů souborů najdete níže.

• output_style – Libsass‘ sass.compile() umožňuje sestavit výstup CSS v jednom ze čtyř stylů:

  • kompaktní

  • komprimovaný

  • rozšířený

  • vložený

Platné a neplatné názvy souborů CSS

Platné

Neplatné

Příklad konfiguračního souboru

{ "root": ".", "scss_dir": "./static/scss", "css_dir": "./static/css", "css_filename": "index.css", "output_style": "expanded"}

Kompilace SCSS je stále ve vývoji. Byl úspěšně testován, ale ne ve velkém rozsahu s:

• Proměnné
• @importní příkazy
• Funkce (základní)
• Mixiny (základní)

.