VS Code Extension

Die VS-Code-Extension bringt vollwertigen Editor-Support für die CodeGuard-DSL mit. Wenn ihr eigene .cgr-Regeln schreibt, bekommt ihr Syntax-Highlighting, Snippets und Autovervollständigung der Schema-Properties.

Installation

1. Hol codeguard-X.Y.Z.vsix aus den Portal-Downloads.
2. In VS Code: Kommandopalette → "Extensions: Install from VSIX..." → die heruntergeladene Datei auswählen.

Alternativ per CLI:

code --install-extension codeguard-X.Y.Z.vsix

Der Windows-Installer macht das automatisch, wenn er code im PATH findet.

Features

• Syntax-Highlighting für .cgr-Files mit eigenem Tokenizer.
• Snippets für die typischen Regel-Skelette.
• Autovervollständigung der Schema-Properties (Methoden auf TypeModel, MethodModel und Co.) über einen integrierten Language Server.
• Inline-Validierung der Regel-Syntax. Tippfehler in Property-Namen oder fehlende Pflicht-Header markiert der Editor sofort.

Commands in der Kommandopalette

• CodeGuard: Validate current rule file
• CodeGuard: Analyze workspace (.sln/.csproj)
• CodeGuard: Restart language server
• CodeGuard: Show language server output

Analyze workspace startet die CodeGuard-CLI auf der Solution oder dem Projekt im VS Code Terminal. Die Findings erscheinen dort als Konsolen-Output.

Konfiguration

Settings unter codeguard.* in den VS Code Einstellungen:

Troubleshooting

Wenn der Language Server nicht startet:

1. Output-Panel öffnen (View → Output), CodeGuard im Dropdown wählen.
2. CLI-Pfad prüfen. Wenn die CLI nicht im PATH ist, setz codeguard.serverPath explizit auf den vollen Pfad.
3. Rechte prüfen auf Linux und macOS. Das Binary muss ausführbar sein (chmod +x codeguard).

Mehr unter VS-Code-Extension hängt.