.vscode in JSON rigido: senza commenti, le spiegazioni nella guida
Il controllo «File JSON» della CI legge ogni *.json tracciato con JSON.parse: con i commenti // dei quattro file di .vscode il lavoro «controlli» sarebbe fallito a ogni push dopo l'unione con il ramo della CI, e con lui tutta la verifica. VS Code legge anche il JSON rigido, quindi i commenti si tolgono e le spiegazioni passano nella guida («Da VS Code»), nei campi detail delle attività e in docs/decisioni.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
1b5a8d4dcd
commit
7bcb9f5f5a
6 files changed
+9
-44
No files matched your search
Vendored
-1
@@ -1,4 +1,3 @@
|
||||
// Estensioni consigliate per Febe: C# Dev Kit (soluzione, prove) e C# (linguaggio e debugger «coreclr» di launch.json).
|
||||
{
|
||||
"recommendations": ["ms-dotnettools.csdevkit", "ms-dotnettools.csharp"]
|
||||
}
|
||||
Vendored
-22
@@ -1,18 +1,7 @@
|
||||
// Configurazioni di debug di Febe (guida: docs/guida/Sviluppo.md, «Da VS Code»). Tipo «coreclr» dell'estensione C#.
|
||||
// - Prima di partire compilano tutta la soluzione con l'attività «compila» (.vscode/tasks.json).
|
||||
// - Febe per Windows di sviluppo tiene dati e libreria in %USERPROFILE%\FebeSviluppo: mai in %LOCALAPPDATA%\Febe.
|
||||
// - Nessuna configurazione contatta Instagram tranne l'ultima, «⚠ Febe per Windows · Instagram vero (dati veri)»:
|
||||
// è per le prove dal vivo di Alberto (regola 1) e chiede conferma prima di partire.
|
||||
// - VS Code non sa nascondere una configurazione per sistema operativo: quelle che non possono girare su un sistema
|
||||
// lì si fermano subito con un messaggio (attività «solo su Windows» e «solo su Linux»).
|
||||
// - Tutte usano la Console di debug («internalConsole»), mai il terminale integrato: il terminale carica il profilo di
|
||||
// PowerShell, che può mettere davanti un altro .NET (per esempio quello di un ambiente conda, con il solo .NET 8, e
|
||||
// il programma non parte). La Console di debug usa l'ambiente di VS Code.
|
||||
{
|
||||
"version": "0.2.0",
|
||||
"configurations": [
|
||||
{
|
||||
// Il sito di prova parte come attività di sfondo (porte 8481 e 8482) e a fine debug si ferma.
|
||||
"name": "Febe per Windows · sito di prova",
|
||||
"type": "coreclr",
|
||||
"request": "launch",
|
||||
@@ -39,8 +28,6 @@
|
||||
"presentation": { "group": "1-windows", "order": 1 }
|
||||
},
|
||||
{
|
||||
// Il sito di prova nel debugger; quando scrive «Sito di prova: http://…» parte anche Febe per Windows
|
||||
// (configurazione nascosta qui sotto), che si ferma insieme al sito.
|
||||
"name": "Sito di prova + Febe per Windows",
|
||||
"type": "coreclr",
|
||||
"request": "launch",
|
||||
@@ -84,9 +71,6 @@
|
||||
"presentation": { "hidden": true }
|
||||
},
|
||||
{
|
||||
// L'interfaccia viene da src/Febe.Web/wwwroot (FEBE_INTERFACCIA): modifichi un file e ricarichi la pagina.
|
||||
// Fermata dal debugger, la dimostrazione non cancella la sua cartella temporanea: su Windows finisce in
|
||||
// %USERPROFILE%\FebeSviluppo\temporanei, che si svuota quando vuoi.
|
||||
"name": "Febe Server · dimostrazione (--demo)",
|
||||
"type": "coreclr",
|
||||
"request": "launch",
|
||||
@@ -133,8 +117,6 @@
|
||||
"presentation": { "group": "2-strumenti", "order": 3 }
|
||||
},
|
||||
{
|
||||
// Il server vero contro il sito di prova, con Chromium su Xvfb (specifica §11): solo su Linux. Come root serve
|
||||
// anche --senza-sandbox; se Chromium non è nel PATH, FEBE_CHROMIUM. Interfaccia su 127.0.0.1:8480, password «prova».
|
||||
"name": "Febe Server · sito di prova (solo Linux)",
|
||||
"type": "coreclr",
|
||||
"request": "launch",
|
||||
@@ -170,15 +152,11 @@
|
||||
},
|
||||
"checkForDevCert": false,
|
||||
"logging": { "moduleLoad": false },
|
||||
// Su Windows e macOS si ferma con un messaggio; anche con «Esegui comunque il debug» stampa solo l'aiuto.
|
||||
"windows": { "preLaunchTask": "solo su Linux", "postDebugTask": "", "args": ["--aiuto"] },
|
||||
"osx": { "preLaunchTask": "solo su Linux", "postDebugTask": "", "args": ["--aiuto"] },
|
||||
"presentation": { "group": "3-linux", "order": 1 }
|
||||
},
|
||||
{
|
||||
// Instagram vero, con l'account e i dati veri (%LOCALAPPDATA%\Febe, Immagini\Febe): solo per le prove dal vivo di
|
||||
// Alberto. Chiede conferma (Esc annulla). Una versione di sviluppo può aggiornare il database vero. Se Febe
|
||||
// installato è aperto, prima esci da lui (menu dell'icona ▸ Esci): un solo Febe per cartella dei dati.
|
||||
"name": "⚠ Febe per Windows · Instagram vero (dati veri)",
|
||||
"type": "coreclr",
|
||||
"request": "launch",
|
||||
|
||||
Vendored
-1
@@ -1,4 +1,3 @@
|
||||
// Impostazioni di VS Code condivise per Febe: solo ciò che vale per tutti (guida: docs/guida/Sviluppo.md).
|
||||
{
|
||||
"dotnet.defaultSolution": "Febe.slnx"
|
||||
}
|
||||
Vendored
+3
-17
@@ -1,14 +1,9 @@
|
||||
// Attività di VS Code per Febe (guida: docs/guida/Sviluppo.md, «Da VS Code»).
|
||||
// Sono i comandi della guida. Le due opzioni in più di compilazione e prove (-tl:off, -clp:ForceNoAlign) danno il
|
||||
// registro classico, come nella CI: ogni errore su una riga sola, che $msCompile porta nel pannello Problemi.
|
||||
// Tutte sono di tipo «process»: nessuna shell, quindi nessun profilo di PowerShell che metta davanti un altro .NET.
|
||||
// Nessuna attività contatta Instagram: il sito di prova è locale (regola 1).
|
||||
{
|
||||
"version": "2.0.0",
|
||||
"tasks": [
|
||||
{
|
||||
"label": "compila",
|
||||
"detail": "dotnet build Febe.slnx -warnaserror: tutta la soluzione, gli avvisi sono errori",
|
||||
"detail": "dotnet build Febe.slnx -warnaserror: tutta la soluzione, gli avvisi sono errori; con -tl:off -clp:ForceNoAlign ogni errore sta su una riga e finisce nel pannello Problemi",
|
||||
"type": "process",
|
||||
"command": "dotnet",
|
||||
"args": [
|
||||
@@ -58,10 +53,8 @@
|
||||
"presentation": { "clear": true }
|
||||
},
|
||||
{
|
||||
// In sfondo: VS Code lo considera pronto quando il sito scrive «Sito di prova: http://…». Il «CDN» ascolta su
|
||||
// 127.0.0.2:8482, l'indirizzo che Febe si aspetta con --sito-di-prova http://127.0.0.1:8481.
|
||||
"label": "sito di prova",
|
||||
"detail": "dotnet run --project tools/Febe.SitoDiProva: http://127.0.0.1:8481, CDN su 127.0.0.2:8482, dati sintetici del seme 13",
|
||||
"detail": "dotnet run --project tools/Febe.SitoDiProva: http://127.0.0.1:8481, CDN su 127.0.0.2:8482 (dove Febe lo cerca), dati sintetici del seme 13; in sfondo, pronto alla riga «Sito di prova: http://…»",
|
||||
"type": "process",
|
||||
"command": "dotnet",
|
||||
"args": [
|
||||
@@ -79,8 +72,6 @@
|
||||
"base": "$msCompile",
|
||||
"owner": "sito-di-prova",
|
||||
"background": {
|
||||
// Al lavoro dall'avvio (activeOnStart) fino alla riga di endsPattern, poi pronto per sempre: «(?!)» non trova
|
||||
// mai nulla, quindi nessuna riga successiva lo rimette «al lavoro».
|
||||
"activeOnStart": true,
|
||||
"beginsPattern": "(?!)",
|
||||
"endsPattern": "^Sito di prova: http://"
|
||||
@@ -125,8 +116,6 @@
|
||||
"problemMatcher": [],
|
||||
"presentation": { "clear": true }
|
||||
},
|
||||
|
||||
// Attività di servizio delle configurazioni di debug (.vscode/launch.json): non compaiono nell'elenco.
|
||||
{
|
||||
"label": "compila e avvia il sito di prova",
|
||||
"detail": "Prima del debug contro il sito di prova: compila, poi avvia il sito (se è già aperto, lo usa così com'è)",
|
||||
@@ -136,11 +125,8 @@
|
||||
"problemMatcher": []
|
||||
},
|
||||
{
|
||||
// VS Code non ha un'attività che ne chiuda un'altra: lo fa l'input «fermaIlSitoDiProva», che esegue il comando
|
||||
// workbench.action.tasks.terminate mentre VS Code prepara questa attività. Il comando non restituisce un testo,
|
||||
// quindi l'argomento resta com'è e «echo» lo stampa e basta. Un processo e non una shell: niente profilo da caricare.
|
||||
"label": "ferma il sito di prova",
|
||||
"detail": "A fine debug: chiude l'attività «sito di prova»",
|
||||
"detail": "A fine debug: chiude l'attività «sito di prova» con l'input fermaIlSitoDiProva (comando workbench.action.tasks.terminate); echo stampa solo il suo argomento",
|
||||
"type": "process",
|
||||
"command": "echo",
|
||||
"args": ["${input:fermaIlSitoDiProva}"],
|
||||
|
||||
+2
-1
@@ -229,9 +229,10 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15).
|
||||
| 2026-10-20 | VS Code: configurazione condivisa in `.vscode/` (`launch.json`, `tasks.json`, `extensions.json`, `settings.json` con la sola `dotnet.defaultSolution`); debug con il tipo `coreclr` dell'estensione C#, senza file `launchSettings.json` | Il tipo `dotnet` del C# Dev Kit accetta solo il progetto e un profilo di `launchSettings.json`: niente argomenti, variabili d'ambiente, attività prima e dopo, `serverReadyAction`. Con `coreclr` tutto sta in un file solo |
|
||||
| 2026-10-20 | Febe per Windows di sviluppo da VS Code con `--dati %USERPROFILE%\FebeSviluppo\dati` e `--libreria %USERPROFILE%\FebeSviluppo\libreria`; il debug avvia `Febe.exe`, non `dotnet Febe.dll` | Mai la cartella vera `%LOCALAPPDATA%\Febe`; fuori dal repository perché profilo del browser e libreria crescono e non devono finire in un commit. Con `Febe.exe` il percorso del processo è quello di Febe e non di `dotnet.exe` (lo usa l'avvio con il computer) |
|
||||
| 2026-10-20 | Attività di compilazione, prove e pubblicazione con `-tl:off -clp:ForceNoAlign` oltre al comando della guida | Registro classico, come nella CI: ogni errore su una riga sola, senza le righe che il terminal logger ridisegna nel terminale; `$msCompile` lo porta nel pannello Problemi (provato con un errore voluto) |
|
||||
| 2026-10-20 | Il sito di prova è un'attività di sfondo, pronta alla riga «Sito di prova: http://»; a fine debug la ferma un input che esegue `workbench.action.tasks.terminate` | VS Code non ha un'attività che ne chiuda un'altra: un input di tipo `command` è l'unico modo per farlo da `postDebugTask` |
|
||||
| 2026-10-20 | Il sito di prova è un'attività di sfondo, pronta alla riga «Sito di prova: http://» (`activeOnStart`, con `beginsPattern` «(?!)», che non trova mai nulla); a fine debug la ferma un input che esegue `workbench.action.tasks.terminate` | VS Code legge `activeOnStart`, non `activeBegins`: senza, il debug aspettava il sito per sempre. Con «(?!)» nessuna riga successiva rimette l'attività «al lavoro». VS Code non ha un'attività che ne chiuda un'altra: un input di tipo `command` è l'unico modo per farlo da `postDebugTask` |
|
||||
| 2026-10-20 | «Sito di prova + Febe per Windows» non è un compound: la configurazione del sito avvia Febe con `serverReadyAction` (`startDebugging`, `killOnServerStop`) quando il sito scrive di essere pronto | Un compound avvia tutto insieme e senza ordine: Febe con `--accesso-di-prova` poteva cercare il sito prima che ascoltasse |
|
||||
| 2026-10-20 | Le configurazioni legate a un sistema (Febe per Windows; Febe Server con il sito di prova, cioè Chromium su Xvfb) sugli altri sistemi si fermano con un messaggio (attività «solo su Windows» e «solo su Linux»; il server riceve anche solo `--aiuto`) | VS Code non sa nascondere una configurazione per sistema operativo: le proprietà `windows`, `linux` e `osx` contano solo all'avvio |
|
||||
| 2026-10-20 | «⚠ Febe per Windows · Instagram vero (dati veri)» chiede conferma prima di compilare e partire (una scelta sola, Esc annulla) | Regola 1: le prove dal vivo le lancia Alberto; un F5 distratto non deve aprire Instagram con l'account e il database veri |
|
||||
| 2026-10-20 | Tutte le configurazioni di debug scrivono nella Console di debug (`internalConsole`), mai nel terminale integrato; le attività sono di tipo `process`, senza shell | Il terminale integrato e le attività `shell` caricano il profilo di PowerShell: su questo PC il profilo attiva l'ambiente conda di Pinokio, che mette in testa al `PATH` e in `DOTNET_ROOT` un .NET senza SDK e con il solo runtime 8. Lì `dotnet build` non trova l'SDK e Febe (net10.0) non parte («You must install or update .NET»), né come `febe.dll` né come `febe.exe`. Console di debug e attività `process` usano l'ambiente di VS Code |
|
||||
| 2026-10-20 | La dimostrazione da VS Code serve l'interfaccia dai sorgenti (`FEBE_INTERFACCIA`), apre da sola il browser (`serverReadyAction`) e su Windows tiene la cartella temporanea in `%USERPROFILE%\FebeSviluppo\temporanei` (`TEMP`, `TMP`) | Si modifica `wwwroot` e si ricarica senza ricompilare. Fermata dal debugger, la dimostrazione non può cancellare la sua cartella (una trentina di MB): così resta fra i dati di sviluppo invece di accumularsi in `%TEMP%` |
|
||||
| 2026-10-20 | I file di `.vscode/` sono JSON rigido, senza commenti: le spiegazioni stanno nella guida (pagina «Sviluppo», «Da VS Code»), nei campi `detail` delle attività e in queste righe | Il controllo «File JSON» della CI legge ogni `*.json` tracciato con `JSON.parse`, e con i commenti `//` il lavoro «controlli» falliva a ogni push dopo l'unione. VS Code legge anche il JSON rigido, così il ramo non dipende da come la CI tratta i commenti |
|
||||
@@ -59,8 +59,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev
|
||||
| Febe Server · dimostrazione (--demo) | La dimostrazione su `http://127.0.0.1:8480`, che si apre da sola nel browser; l'interfaccia viene da `src/Febe.Web/wwwroot` (`FEBE_INTERFACCIA`): modifichi un file e ricarichi la pagina |
|
||||
| Sito di prova | Solo il sito di prova, nel debugger |
|
||||
| Simulazione 30 giorni (prudente) | `--simula 30g --profilo prudente`, con il resoconto nella Console di debug |
|
||||
| Febe Server · sito di prova (solo Linux) | Il server vero, con Chromium su Xvfb, contro il sito di prova: interfaccia su `127.0.0.1:8480`, password `prova` (come root serve anche `--senza-sandbox`). Su Windows e macOS si ferma con un messaggio |
|
||||
| ⚠ Febe per Windows · Instagram vero (dati veri) | Febe senza opzioni: Instagram vero, `%LOCALAPPDATA%\Febe` e `Immagini\Febe`. Solo per le prove dal vivo di Alberto: chiede conferma, e una versione di sviluppo può aggiornare il database vero |
|
||||
| Febe Server · sito di prova (solo Linux) | Il server vero, con Chromium su Xvfb, contro il sito di prova: interfaccia su `127.0.0.1:8480`, password `prova` (come root serve anche `--senza-sandbox`, e `FEBE_CHROMIUM` se Chromium non è nel `PATH`). Su Windows e macOS si ferma con un messaggio; anche con «Esegui comunque il debug» stampa solo l'aiuto |
|
||||
| ⚠ Febe per Windows · Instagram vero (dati veri) | Febe senza opzioni: Instagram vero, `%LOCALAPPDATA%\Febe` e `Immagini\Febe`. Solo per le prove dal vivo di Alberto: chiede conferma, e una versione di sviluppo può aggiornare il database vero. Se Febe installato è aperto, prima esci da lui (menu dell'icona ▸ Esci): un solo Febe per cartella dei dati |
|
||||
|
||||
- **Dati di sviluppo.** Febe per Windows di sviluppo tiene dati e libreria in `%USERPROFILE%\FebeSviluppo\dati` e
|
||||
`%USERPROFILE%\FebeSviluppo\libreria` (il server su Linux in `~/FebeSviluppo`): fuori dal repository e mai nella
|
||||
@@ -80,6 +80,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev
|
||||
- Attività (Terminale ▸ Esegui attività): `compila`, `prove` (`dotnet test tests/Febe.Tests`), `prove con filtro`
|
||||
(chiede il filtro, per esempio `FullyQualifiedName~Febe.Tests.Docs`), `sito di prova`, `pubblica Febe.exe` (un file
|
||||
solo in `out/pubblicazione/`, come `installer/costruisci.sh`) e `immagine Docker (serve Docker Desktop)`.
|
||||
- I file di `.vscode/` sono JSON senza commenti, così li legge anche un lettore rigido come quello dei controlli della
|
||||
CI: le spiegazioni stanno in questa sezione, nei campi `detail` delle attività e in `docs/decisioni.md`.
|
||||
|
||||
## Dimostrazione
|
||||
|
||||
|
||||
Reference in new issue
Block a user