Cerca in Documentazione: Seleziona del testo nel codice ed esegui il comando per cercarlo direttamente nella documentazione.
Generazione Documentazione da Commit: Seleziona uno degli ultimi commit per inviare una richiesta all'integrazione AI che genera la documentazione. Al termine apre automaticamente il link del risultato.
🔧 Git & Collaborazione (Ambienti Condivisi)
Aggiungi Modifiche Utente: Esegue lo stage (git add) intelligente dei file.
In ambienti Remote SSH/Linux: Filtra e aggiunge ESCLUSIVAMENTE i file di proprietà dell'utente OS corrente (utile se più sviluppatori lavorano sulla stessa cartella).
In locale (Windows): Aggiunge tutte le modifiche rilevate.
Commit Modifiche Utente: Aggiunge le modifiche dell'utente ed esegue il commit richiedendo un messaggio.
🐛 Debugging COBOL
Snippet Debug: Inserimento rapido di chiamate trace! e CALL "fu_shcb_debug".
Inserimento Debug Massivo: Aggiunge automaticamente righe di trace su tutte le LABEL, CALL e PERFORM all'interno di un blocco *> START-DEBUG e *> END-DEBUG.
Rimozione Debug: Pulisce velocemente tutte le righe di trace generate.
⚙️ Configurazione
Puoi personalizzare l'estensione nelle impostazioni di VS Code:
ID Impostazione
Descrizione
Default
openDocumentation.urlBase
URL base per apertura e ricerca documentazione.
https://gsdoc.genesyssoftware.eu/search?term=
docs.generationEndpoint
Endpoint API (POST) a cui inviare l'hash del commit per generare la doc.
http://127.0.0.1:8000/api/git/commit-hook
docs.resultUrlBase
URL base a cui viene appeso il risultato dell'API per visualizzare la documentazione generata.
(vuoto)
git.userEmail
Email specifica per filtrare i commit nella ricerca (se diversa dalla config globale di git).
(automatico da git config)
📦 Installazione e Requisiti
L'estensione richiede un workspace inizializzato come repository Git.
Per le funzionalità di debug, è ottimizzata per file .COB e .DD.
Development
Per contribuire o modificare l'estensione:
Modificare src/extension.ts.
Compilare con npm run compile.
Pubblicare con vsce publish (o npx vsce publish).
Nota sul Token: Per pubblicare è necessario un Personal Access Token (PAT) di Azure DevOps collegato all'organizzazione GenesysSoftware.
Se il token è scaduto o non configurato, effettuare il login con:
npx vsce login GenesysSoftware
Inserendo il token quando richiesto.
