v1.0.1

Un’utilità CLI per compilare più file SCSS in un singolo file CSS per evitare di collegare un milione di file CSS in un progetto. Compile SCSS utilizza Click per costruire la sua interfaccia CLI.

Installazione

pip install compile_scss

Usage

Run compile_scss

Se compile_scss viene eseguito senza alcuna opzione o flag, Compile SCSS cercherà nella directory principale del progetto un file chiamato compile_scss_config.json, che contiene un oggetto JSON con i valori di configurazione predefiniti dall’utente.

Se viene trovato un file di configurazione, Compile SCSS verrà eseguito utilizzando la configurazione trovata nel file JSON. Se non viene trovato alcun file di configurazione, verrà attivato un Read, Evaluate, Print, Loop (R.E.P.L.) e l’utente avrà la possibilità di impostare nuovi valori di configurazione con una serie di richieste.

Options

--root <PROJECT_ROOT_DIRECTORY>

L’opzione --root permette all’utente di specificare la directory principale del proprio progetto. Compile SCSS cercherà in quella directory il file compile_scss_config.json. >

Il percorso predefinito della directory principale è ./, che si traduce in qualsiasi directory da cui viene chiamato compile_scss.

--set-config

Se il flag --set-config è presente, la configurazione R.E.P.L. sarà attivata per default.

Se è stato trovato un file di configurazione, l’utente avrà la possibilità di creare un nuovo file di configurazione o continuare con i valori trovati nel file di configurazione.

Se non è stato trovato alcun file di configurazione, l’utente avrà la possibilità di creare un nuovo file di configurazione.

--watch

Se il flag --watch è presente, Compile SCSS osserverà la directory SCSS specificata nel file di configurazione per eventuali modifiche e aggiornerà il file CSS di conseguenza.

Configurazione

Di default, Compile SCSS cercherà nella directory principale del progetto un file chiamato compile_scss_config.json. Il file deve essere presente e contenere un oggetto di configurazione valido affinché Compile SCSS possa essere eseguito.

Il file di configurazione deve contenere cinque chiavi e valori corrispondenti:

• root – La directory principale del progetto. Il valore predefinito è ./

• scss_dir – La directory SCSS di primo livello per il progetto. Questa directory può contenere sottodirectory e tutti i file SCSS necessari. Il percorso scss_dir deve portare ad una directory contenente almeno un file SCSS per essere un percorso SCSS valido.

• css_dir – La directory CSS contenente il file CSS principale. Questo è dove Compile SCSS genererà il suo file di output CSS.

• css_filename – Il nome desiderato del file CSS di destinazione.

  Il nome del file non deve contenere caratteri speciali diversi da trattini o underscore non iniziali/finali. L’estensione del file deve essere minuscola, ma il nome del file può contenere lettere maiuscole.

  Vedi gli esempi qui sotto per nomi di file validi e non validi.

• output_style – Libsass’ sass.compile() permette di compilare l’output CSS in uno dei quattro stili:

  • compatto

  • compresso

  • espanso

  • nidificato

Nomi di file CSS validi e non validi

Validi

Invalidi

File di configurazione di esempio

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

Compile SCSS è ancora in sviluppo. È stato testato con successo ma non estensivamente con:

• Variabili
• dichiarazioni @import
• Funzioni (base)
• Mixins (base)