v1.0.1

Un utilitar CLI pentru compilarea mai multor fișiere SCSS într-un singur fișier CSS pentru a evita legarea unui milion de fișiere CSS în cadrul unui proiect. Compile SCSS utilizează Click pentru a-și construi interfața CLI.

Instalare

pip install compile_scss

Utilizare

Executare compile_scss

Dacă compile_scsseste executat fără opțiuni sau stegulețe, Compile SCSS va căuta în directorul rădăcină al proiectului un fișier numit compile_scss_config.json, care stochează un obiect JSON cu valorile de configurare predefinite de utilizator.

Dacă se găsește un fișier de configurare, Compile SCSS va rula folosind configurația găsită în fișierul JSON. Dacă nu se găsește niciun fișier de configurare, se va declanșa un Read, Evaluate, Print, Loop (R.E.P.P.L.) și utilizatorul va avea opțiunea de a seta noi valori de configurare cu ajutorul unei serii de solicitări.

Options

--root <PROJECT_ROOT_DIRECTORY>

Opțiunea --root permite utilizatorului să specifice directorul rădăcină al proiectului său. Compile SCSS va căuta în acel director fișierul compile_scss_config.json. >

Calea implicită către directorul rădăcină este ./, care se traduce prin orice director din care este apelat compile_scss.

--set-config

Dacă steagul --set-config este prezent, configurația R.E.P.P.L. va fi declanșată în mod implicit.

Dacă a fost găsit un fișier de configurare, utilizatorul va avea opțiunea de a crea un nou fișier de configurare sau de a continua cu valorile găsite în fișierul de configurare.

Dacă nu a fost găsit niciun fișier de configurare, utilizatorul va avea opțiunea de a crea un nou fișier de configurare.

--watch

Dacă steagul --watch este prezent, Compile SCSS va observa directorul SCSS specificat în fișierul de configurare pentru orice modificări și va actualiza fișierul CSS în consecință.

Configuration

În mod implicit, Compile SCSS va căuta în directorul rădăcină al proiectului un fișier numit compile_scss_config.json. Fișierul trebuie să fie prezent și să conțină un obiect de configurare valid pentru ca Compile SCSS să ruleze.

Fișierul de configurare trebuie să conțină cinci chei și valorile corespunzătoare:

• root – Directorul rădăcină al proiectului. Valoarea implicită pentru acesta este ./

• scss_dir – Directorul SCSS de nivel superior pentru proiect. Acest director poate conține subdirectoare și atâtea fișiere SCSS câte fișiere SCSS sunt necesare. Calea scss_dir trebuie să ducă la un director care conține cel puțin un fișier SCSS pentru a fi o cale SCSS validă.

• css_dir – Directorul CSS care conține fișierul CSS principal. Acesta este locul în care Compile SCSS va genera fișierul CSS de ieșire.

• css_filename – Numele dorit al fișierului CSS țintă.

  Numele fișierului nu trebuie să conțină caractere speciale, altele decât cratimele sau sublinierile care nu sunt în frunte/în urmă. Extensia fișierului trebuie să fie minusculă, dar numele de fișier poate conține litere majuscule.

  Vezi exemplele de mai jos pentru nume de fișiere valide și invalide.

• output_style – sass.compile() Libsass’ sass.compile() permite ca ieșirea CSS să fie compilată într-unul din cele patru stiluri:

  • compact

  • comprimat

  • expansionat

  • nested

.

Nume de fișiere CSS valide și invalide

Valide

Invalide

Exemplu de fișier de configurare

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

Compilați SCSS este încă în curs de dezvoltare. A fost testat cu succes, dar nu pe scară largă cu:

• Variabile
• @import statements
• Funcții (de bază)
• Mixuri (de bază)

.