diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..8682b19 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,4 @@ +// 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"] +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..a309826 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,4 @@ +// Impostazioni di VS Code condivise per Febe: solo ciò che vale per tutti (guida: docs/guida/Sviluppo.md). +{ + "dotnet.defaultSolution": "Febe.slnx" +} diff --git a/.vscode/tasks.json b/.vscode/tasks.json new file mode 100644 index 0000000..ecdff2a --- /dev/null +++ b/.vscode/tasks.json @@ -0,0 +1,200 @@ +// 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", + "type": "process", + "command": "dotnet", + "args": [ + "build", + "${workspaceFolder}/Febe.slnx", + "-warnaserror", + "-nologo", + "-tl:off", + "-clp:ForceNoAlign" + ], + "group": { "kind": "build", "isDefault": true }, + "problemMatcher": "$msCompile", + "presentation": { "clear": true } + }, + { + "label": "prove", + "detail": "dotnet test tests/Febe.Tests: tutte le prove (senza Chromium e Xvfb quelle con il browser vero risultano saltate)", + "type": "process", + "command": "dotnet", + "args": [ + "test", + "${workspaceFolder}/tests/Febe.Tests", + "-nologo", + "-tl:off", + "-clp:ForceNoAlign" + ], + "group": { "kind": "test", "isDefault": true }, + "problemMatcher": "$msCompile", + "presentation": { "clear": true } + }, + { + "label": "prove con filtro", + "detail": "dotnet test tests/Febe.Tests --filter …: una prova o un gruppo, per nome", + "type": "process", + "command": "dotnet", + "args": [ + "test", + "${workspaceFolder}/tests/Febe.Tests", + "--filter", + "${input:filtroDelleProve}", + "-nologo", + "-tl:off", + "-clp:ForceNoAlign" + ], + "group": "test", + "problemMatcher": "$msCompile", + "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", + "type": "process", + "command": "dotnet", + "args": [ + "run", + "--project", + "${workspaceFolder}/tools/Febe.SitoDiProva", + "--", + "--porta", + "8481", + "--porta-cdn", + "8482" + ], + "isBackground": true, + "problemMatcher": { + "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://" + } + }, + "presentation": { "panel": "dedicated", "clear": true } + }, + { + "label": "pubblica Febe.exe", + "detail": "dotnet publish di Febe.Desktop in un file solo, come installer/costruisci.sh: out/pubblicazione/Febe.exe (Release, win-x64)", + "type": "process", + "command": "dotnet", + "args": [ + "publish", + "${workspaceFolder}/src/Febe.Desktop/Febe.Desktop.csproj", + "-c", + "Release", + "-r", + "win-x64", + "--self-contained", + "true", + "-p:PublishSingleFile=true", + "-p:IncludeNativeLibrariesForSelfExtract=true", + "-p:EnableCompressionInSingleFile=true", + "-nologo", + "-o", + "${workspaceFolder}/out/pubblicazione", + "-tl:off", + "-clp:ForceNoAlign" + ], + "group": "build", + "problemMatcher": "$msCompile", + "presentation": { "clear": true } + }, + { + "label": "immagine Docker (serve Docker Desktop)", + "detail": "docker build -f docker/Dockerfile -t febe .: compilazione e prove dentro l'immagine; serve un demone Docker avviato", + "type": "process", + "command": "docker", + "args": ["build", "-f", "docker/Dockerfile", "-t", "febe", "."], + "group": "build", + "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'è)", + "dependsOrder": "sequence", + "dependsOn": ["compila", "sito di prova"], + "hide": true, + "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»", + "type": "process", + "command": "echo", + "args": ["${input:fermaIlSitoDiProva}"], + "windows": { "command": "cmd.exe", "args": ["/d", "/c", "echo", "${input:fermaIlSitoDiProva}"] }, + "hide": true, + "problemMatcher": [], + "presentation": { "reveal": "never", "echo": false, "close": true } + }, + { + "label": "solo su Linux", + "detail": "Ferma una configurazione che gira solo su Linux", + "type": "process", + "command": "sh", + "args": [ + "-c", + "echo 'Questa configurazione gira solo su Linux: il browser di Febe Server è Chromium su Xvfb.' >&2; exit 1" + ], + "windows": { + "command": "powershell.exe", + "args": [ + "-NoProfile", + "-NonInteractive", + "-Command", + "Write-Host 'Questa configurazione gira solo su Linux: il browser di Febe Server è Chromium su Xvfb. Su Windows usa «Febe per Windows · sito di prova».'; exit 1" + ] + }, + "hide": true, + "problemMatcher": [] + }, + { + "label": "solo su Windows", + "detail": "Ferma una configurazione che gira solo su Windows", + "type": "process", + "command": "sh", + "args": [ + "-c", + "echo 'Questa configurazione gira solo su Windows: Febe per Windows è WPF e WebView2. Su Linux usa «Febe Server · sito di prova (solo Linux)».' >&2; exit 1" + ], + "hide": true, + "problemMatcher": [] + } + ], + "inputs": [ + { + "id": "filtroDelleProve", + "type": "promptString", + "description": "Filtro di dotnet test, per esempio FullyQualifiedName~Febe.Tests.Docs (oppure solo una parte del nome: IconTests)", + "default": "FullyQualifiedName~Febe.Tests.Docs" + }, + { + "id": "fermaIlSitoDiProva", + "type": "command", + "command": "workbench.action.tasks.terminate", + "args": "sito di prova" + } + ] +}