CodeBlock-Manager für VS Code

Tauscht PowerShell-Bloecke (function, filter, workflow, configuration, class, enum) live im Editor aus der Zwischenablage aus – mit Diff-Vorschau, Kommentar-Erhalt, automatischer Einrückung und Sicherung.

📖 Anleitung

Grundlegende Verwendung

1. PowerShell-Datei (.ps1, .psm1) im Editor öffnen.
2. Einen Block kopieren – z. B. eine ganze Funktion mit Strg+C.
3. Strg+Alt+V drücken (oder Befehlspalette → „CodeBlock: Funktion aus Zwischenablage einfügen").

Das Plugin:

• Erkennt den Block (Name, Klammern, Kommentare)
• Sucht nach einem gleichnamigen Block in der geöffneten Datei
• Zeigt ein Diff-Fenster (alt ↔ neu) mit „Übernehmen / Verwerfen"
• Ersetzt den Block inklusive vorherigem Kommentarblock (z. B. <# .SYNOPSIS … #>)
• Passt die Einrückung automatisch an die Zieltiefe an
• Erstellt eine .bak-Sicherung der Datei
• Springt zur geänderten Stelle und markiert sie farbig
• Blendet die Markierung nach 5 Sekunden (oder bei Tasteneingabe) aus

Tipp: Du kannst auch mehrere Blöcke auf einmal kopieren – alle werden nacheinander ersetzt bzw. angehängt.

Live-Modus

Schaltet die Statusleiste auf „Live AN" (Klick auf das Auge-Symbol). Das Plugin überwacht dann die Zwischenablage sekündlich und ersetzt automatisch, sobald ein PowerShell-Block erkannt wird. Ideal beim Arbeiten mit mehreren Editoren oder Remote-Sitzungen.

Anhängen neuer Blöcke

Wenn ein Block in der aktuellen Datei noch nicht existiert, wird er ans Ende der Datei angehängt (einstellbar). So kannst du schnell mehrere neue Funktionen aus dem Clipboard sammeln.

---

⚙️ Alle Funktionen (Feature-Übersicht)

#	Funktion	Beschreibung
🔄	Block ersetzen	Erkennt function, filter, workflow, configuration, class, enum aus der Zwischenablage
👀	Diff-Vorschau	Zeigt alt ↔ neu vor dem Ersetzen; „Übernehmen" oder „Verwerfen" per Klick
💬	Kommentar-Erhalt	Vorangehende <# .SYNOPSIS … #> und #-Zeilen werden mit ersetzt
📐	Einrückung anpassen	Eingefügter Code übernimmt die Einrückungstiefe der Zielstelle
🎯	Sprung zur Änderung	Cursor springt nach dem Ersetzen direkt zur ersten geänderten Stelle
💾	Auto-Backup	Vor jeder Ersetzung wird eine .bak-Datei neben der Originaldatei erstellt
🟡🟢	Farbige Markierung	Gelb = ersetzt, Grün = angehängt; blendet nach X s oder bei Eingabe aus
📚	Mehrfach-Modus	Beliebig viele Blöcke auf einmal kopieren und ersetzen/anhängen
➕	Anhängen	Neue Blöcke werden ans Ende der Datei angehängt
👁️	Live-Überwachung	Überwacht die Zwischenablage und ersetzt automatisch
↩️	Undo-fähig	Alle Änderungen sind ein einziger Undo-Schritt (Strg+Z)

---

⚙️ Einstellungen

Öffnen über: Datei → Einstellungen → Erweiterungen → CodeBlock-Manager oder settings.json:

Einstellung	Standard	Beschreibung
codeblockManager.vorschauDiff	true	Diff-Fenster (alt ↔ neu) vor dem Ersetzen anzeigen
codeblockManager.autoBackup	true	Automatische .bak-Sicherung vor jeder Ersetzung
codeblockManager.kommentareEinbeziehen	true	Kommentarblock / Comment-Based-Help oberhalb mit-ersetzen
codeblockManager.markierungTimeoutSek	5	Sekunden bis Markierung ausgeblendet wird (0 = nie)
codeblockManager.neueFunktionenAnhaengen	true	Unbekannte Blöcke ans Dateiende anhängen
codeblockManager.liveUeberwachung	false	Zwischenablage automatisch überwachen (auch beim Start)

---

⌨️ Befehle & Tastenkürzel

Befehl	Tastenkürzel	Beschreibung
codeblockManager.funktionErsetzen	Strg+Alt+V	Block aus Zwischenablage einfügen/ersetzen
codeblockManager.liveToggle	Statusleiste (Klick)	Live-Überwachung ein-/ausschalten
codeblockManager.markierungenLoeschen	—	Gelbe/grüne Markierungen manuell entfernen

---

🛡️ Sicherheit

• Keine Netzwerkzugriffe – das Plugin arbeitet rein lokal
• Keine Dateimanipulation ohne Bestätigung – Diff-Vorschau verhindert versehentliches Überschreiben
• Backup vor jeder Änderung – die .bak-Datei liegt neben der bearbeiteten Datei

---

💡 Anwendungsbeispiele

Beispiel 1: Funktion aktualisieren

# Alte Funktion in der Datei:
function Get-Info { return "alt" }

# Neue Version kopiert:
function Get-Info { return "neu" }

# Strg+Alt+V → Diff prüfen → Übernehmen → fertig

Beispiel 2: Comment-Based-Help ersetzen

<#
.SYNOPSIS
  Alte Beschreibung
#>
function Do-Something { ... }

# Kopierte Version (Help + Code):
<#
.SYNOPSIS
  Neue Beschreibung
#>
function Do-Something { ... }

# Strg+Alt+V → beides wird ersetzt, keine doppelten Hilfetexte

Beispiel 3: Klasse ersetzen

class Person {
    [string]$Name
}
# Kopierte Version → Strg+Alt+V
class Person {
    [string]$Name
    [int]$Age
}

---

🔧 Entwicklung

npm install       # Abhängigkeiten installieren
npm run compile   # TypeScript kompilieren
npm run package   # VSIX-Paket bauen
F5                # Extension Development Host starten

Das VSIX-Paket kann manuell über die Extensions-Ansicht („Aus VSIX installieren…") oder via Marketplace bezogen werden.

---

📦 Release-Workflow (GitHub Actions)

Bei Push eines Tags v* wird automatisch:

1. Die Extension kompiliert
2. Ein VSIX-Paket gebaut
3. Ein GitHub-Release mit VSIX erstellt
4. (optional) Im VS Code Marketplace veröffentlicht

git tag v1.0.3
git push origin v1.0.3