fix(vscode): dipendenze installate da sole prima dell'avvio con F5
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>
This commit is contained in:
1 parent
52b0693185
commit
bce6cdabad
5 files changed
+82
-4
No files matched your search
Vendored
+7
-1
@@ -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",
|
||||
|
||||
Vendored
+13
@@ -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": []
|
||||
}
|
||||
]
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
Reference in new issue
Block a user