1 Commits
Author SHA1 Message Date
Alby96andClaude Opus 5.5 bce6cdabad fix(vscode): dipendenze installate da sole prima dell'avvio con F5
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Successful in 6m36s
CI / Link esterni (non bloccante) (push) Successful in 1m55s
Nel checkout principale mancava node_modules: le configurazioni di avvio puntano a
node_modules/astro/bin/astro.mjs e fallivano subito. Ora un preLaunchTask («Sito:
dipendenze», scripts/ensure-deps.mjs) esegue npm ci solo se node_modules manca, se manca
una dipendenza diretta o se package-lock.json è più recente dell'ultima installazione;
altrimenti esce subito. Lo stesso controllo precede la build dell'anteprima. README e
CHANGELOG lo descrivono, con il messaggio di Astro quando un server è già avviato.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 11:43:16 +01:00
5 changed files with 82 additions and 4 deletions

No files matched your search

+7 -1
View File
@@ -8,12 +8,16 @@
//
// Il pattern riconosce la riga «Local http://…» di Astro anche quando è colorata: su Windows
// Astro scrive sempre i codici colore ANSI, che non devono finire nell'indirizzo aperto.
//
// Prima di ogni avvio il task «Sito: dipendenze» esegue npm ci se node_modules manca o è
// più vecchia di package-lock.json (clone appena fatto, pull con dipendenze nuove).
"version": "0.2.0",
"configurations": [
{
"name": "Sito: sviluppo (Edge)",
"type": "node",
"request": "launch",
"preLaunchTask": "Sito: dipendenze",
"program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs",
"args": ["dev"],
"cwd": "${workspaceFolder}",
@@ -33,6 +37,7 @@
"name": "Sito: sviluppo (Chrome)",
"type": "node",
"request": "launch",
"preLaunchTask": "Sito: dipendenze",
"program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs",
"args": ["dev"],
"cwd": "${workspaceFolder}",
@@ -49,7 +54,8 @@
"presentation": { "group": "sito", "order": 2 }
},
{
// Prima compila dist/ (task «Sito: build»), poi lo serve come in produzione.
// Prima controlla le dipendenze e compila dist/ (task «Sito: build»), poi lo serve come in
// produzione.
"name": "Sito: anteprima della build (Edge)",
"type": "node",
"request": "launch",
+13
View File
@@ -2,12 +2,25 @@
// Task usati da .vscode/launch.json (avviabili anche da Terminale → Esegui attività).
"version": "2.0.0",
"tasks": [
{
// Prima di ogni avvio: npm ci solo se node_modules manca o è più vecchia di
// package-lock.json (clone appena fatto, pull con dipendenze nuove); altrimenti è immediato.
"label": "Sito: dipendenze",
"detail": "installa le dipendenze (npm ci) solo se mancano o sono da aggiornare",
"type": "process",
"command": "node",
"args": ["scripts/ensure-deps.mjs"],
"options": { "cwd": "${workspaceFolder}" },
"presentation": { "reveal": "silent", "panel": "shared", "showReuseMessage": false },
"problemMatcher": []
},
{
"label": "Sito: build",
"detail": "astro build: genera il sito statico in dist/",
"type": "npm",
"script": "build",
"group": "build",
"dependsOn": ["Sito: dipendenze"],
"problemMatcher": []
}
]
+6
View File
@@ -4,6 +4,12 @@ Tutte le modifiche rilevanti a questo progetto sono documentate in questo file.
Il formato segue [Keep a Changelog](https://keepachangelog.com/it-IT/1.1.0/) e il progetto adotta il [Versionamento Semantico](https://semver.org/lang/it/).
## [Non rilasciato]
### Corretto
- Avvio da VS Code (F5): prima di ogni avvio il nuovo task «Sito: dipendenze» (`scripts/ensure-deps.mjs`) esegue `npm ci` se `node_modules` manca o è più vecchia di `package-lock.json`. Prima, su un clone senza dipendenze installate, l'avvio falliva perché `node_modules/astro/bin/astro.mjs` non esisteva.
## [1.1.0] - 2026-11-13
### Modificato
+4 -3
View File
@@ -26,14 +26,14 @@ npm run package # crea lo zip di rilascio in release/
### Avvio in debug con VS Code
Dopo `npm ci`, aprire il pannello **Esegui e debug** (Ctrl+Maiusc+D), scegliere una configurazione e premere **F5**:
Aprire la cartella del repository in VS Code, poi il pannello **Esegui e debug** (Ctrl+Maiusc+D), scegliere una configurazione e premere **F5**. Prima di ogni avvio il task «Sito: dipendenze» (`scripts/ensure-deps.mjs`) esegue `npm ci` se `node_modules` manca o è più vecchia di `package-lock.json`, per esempio su un clone appena fatto o dopo un pull che ha cambiato le dipendenze; altrimenti è immediato.
| Configurazione | Cosa fa |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Sito: sviluppo (Edge)` / `(Chrome)` | `astro dev` con il debugger di Node; quando il server è pronto apre il browser con il debugger collegato (punti di interruzione negli script di `src/scripts/`) |
| `Sito: anteprima della build (Edge)` | esegue `npm run build` e serve `dist/` come in produzione su <http://127.0.0.1:4321> |
Maiusc+F5 ferma il server e chiude il browser quando è selezionata la sessione del server, come all'avvio. Dopo una pausa su un punto di interruzione nel browser è selezionata la sessione del browser, e Maiusc+F5 chiude solo quella: premerlo una seconda volta, oppure usare Stop sulla sessione «Sito: sviluppo» nel pannello dello stack di chiamate. Le configurazioni sono in [`.vscode/launch.json`](.vscode/launch.json) e [`.vscode/tasks.json`](.vscode/tasks.json). Astro avvia un solo server di sviluppo per progetto: se `npm run dev` è già aperto in un terminale, chiuderlo prima di premere F5.
Maiusc+F5 ferma il server e chiude il browser quando è selezionata la sessione del server, come all'avvio. Dopo una pausa su un punto di interruzione nel browser è selezionata la sessione del browser, e Maiusc+F5 chiude solo quella: premerlo una seconda volta, oppure usare Stop sulla sessione «Sito: sviluppo» nel pannello dello stack di chiamate. Le configurazioni sono in [`.vscode/launch.json`](.vscode/launch.json) e [`.vscode/tasks.json`](.vscode/tasks.json). Astro avvia un solo server di sviluppo per progetto: se `npm run dev` è già aperto in un terminale, chiuderlo prima di premere F5 (altrimenti l'avvio si ferma con «Another astro dev server is already running»; `npx astro dev stop` chiude quello rimasto aperto).
## Comandi
@@ -71,7 +71,8 @@ src/pages/ una pagina per file; servizi/[slug].astro genera le 6 pagine
src/styles/ tokens.css (colori, tipografia, spaziature), global.css, fonts.css, print.css
src/scripts/ piccoli script: menu, mappa su consenso, modulo, ancore del vecchio sito
public/ .htaccess, favicon e immagini statiche (copiati così come sono)
scripts/ script di test, pacchetto, icone, note di rilascio, upload della release
scripts/ script di test, pacchetto, icone, note di rilascio, upload della release,
dipendenze prima dell'avvio da VS Code (ensure-deps.mjs)
tests/ e2e/ e a11y/ (Playwright), helpers/
deploy/ nginx.conf.example, optional-php-form/contact.php, gitea-deploy.yml.example
(esempio di deploy automatico, disattivato)
+52
View File
@@ -0,0 +1,52 @@
#!/usr/bin/env node
/**
* Installa le dipendenze con `npm ci` solo se servono: node_modules manca, manca una delle
* dipendenze dirette di package.json, oppure package-lock.json è più recente dell'ultima
* installazione (per esempio dopo un pull che ha aggiornato le dipendenze). Altrimenti esce
* subito. Lo usa VS Code prima di ogni avvio (.vscode/tasks.json, «Sito: dipendenze»), così
* F5 funziona anche su un clone appena fatto.
*/
import { spawnSync } from 'node:child_process';
import { existsSync, readFileSync, statSync } from 'node:fs';
import { join, resolve } from 'node:path';
const root = resolve(process.argv[2] ?? join(import.meta.dirname, '..'));
const lockFile = join(root, 'package-lock.json');
// npm scrive questa copia del lockfile a ogni installazione completata
const installedLock = join(root, 'node_modules', '.package-lock.json');
function reason() {
if (!existsSync(installedLock)) return 'node_modules assente o incompleta';
const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
const direct = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
const missing = direct.filter(
(name) => !existsSync(join(root, 'node_modules', name, 'package.json')),
);
if (missing.length > 0) return `dipendenze mancanti: ${missing.join(', ')}`;
if (statSync(lockFile).mtimeMs > statSync(installedLock).mtimeMs) {
return 'package-lock.json è cambiato dopo l’ultima installazione';
}
return null;
}
const why = reason();
if (!why) {
console.log('Dipendenze già installate.');
process.exit(0);
}
console.log(`Installo le dipendenze (${why}): npm ci`);
// su Windows npm è npm.cmd, che Node avvia solo attraverso la shell (e con la shell il
// comando va passato come stringa unica: argomenti separati sono deprecati, DEP0190)
const npmCi = 'npm ci --no-audit --no-fund';
const result =
process.platform === 'win32'
? spawnSync(npmCi, { cwd: root, stdio: 'inherit', shell: true })
: spawnSync('npm', npmCi.split(' ').slice(1), { cwd: root, stdio: 'inherit' });
if (result.status !== 0) {
console.error(
'npm ci non è riuscito. Se il sito è già avviato (F5 o npm run dev), fermarlo e riprovare: ' +
'su Windows i file in uso non si possono sostituire.',
);
process.exit(result.status ?? 1);
}