Natuurlijk! Hieronder vind je stapsgewijze instructies om in Sublime Text een systeem op te zetten voor het volgen en visualiseren van codekwaliteitsmetriek zoals cyclomatische complexiteit, code coverage en code geuren voor je Python-project. Stap 1: Vereiste tools installeren 1. **Python packages installeren** Open een terminal of command prompt en installeer de benodigde Python-pakketten: ```bash pip install radon coverage pylint ``` - **radon**: voor cyclomatische complexiteit en code geuren. - **coverage**: voor code coverage rapportages. - **pylint**: voor statische code analyse en extra metrics. 2. **Optioneel: pytest en pytest-cov voor uitgebreide coverage** ```bash pip install pytest pytest-cov ``` Stap 2: Scripts schrijven voor metriekrapportage Maak een Python-script (bijvoorbeeld `metrics.py`) in je projectmap om de metriek te genereren: ```python import subprocess def run_radon(): print("Cyclomatische complexiteit:") subprocess.run(["radon", "cc", "-s", "je_code_map"], check=True) print("\nCode geuren (code smells):") subprocess.run(["radon", "mi", "-s", "je_code_map"], check=True) def run_coverage(): print("Code coverage:") subprocess.run(["coverage", "run", "-m", "pytest"], check=True) subprocess.run(["coverage", "report"], check=True) subprocess.run(["coverage", "html"], check=True) print("HTML rapport gegenereerd in htmlcov/index.html") def run_pylint(): print("Pylint rapport:") subprocess.run(["pylint", "je_code_map"]) if __name__ == "__main__": run_radon() run_coverage() run_pylint() ``` Pas `'je_code_map'` aan naar je projectmap. Stap 3: Visualisatie binnen Sublime Text Omdat Sublime Text zelf geen ingebouwde metriekvisualisatie heeft, kun je het beste: - **Gebruik build systems**: Maak een custom build systeem om het script uit te voeren en de output in de console te zien. **Create een build systeem:** 1. Ga naar `Tools` > `Build System` > `New Build System...` 2. Voeg de volgende inhoud toe: ```json { "shell_cmd": "python path/naar/metrics.py" } ``` Vervang `path/naar/metrics.py` door het werkelijke pad. 3. Sla dit op als bijvoorbeeld `Metrics.sublime-build`. **Gebruik:** - Selecteer je nieuwe build systeem via `Tools` > `Build System` > `Metrics`. - Druk op `Ctrl+B` om het script uit te voeren. - Bekijk de output in het output paneel van Sublime Text. Stap 4: Geavanceerde visualisatie (optioneel) Voor meer visuele feedback: - **Gebruik Sublime Text plugins** zoals **SublimeLinter** met aangepaste linters voor Python. - **Integreer externe dashboards**: exports van de metriek naar HTML of JSON en gebruik tools zoals Jupyter Notebooks of dashboards (Grafana, etc.) voor uitgebreide visualisatie. Stap 5: Automatisering en herhaalde checks - Maak een shell-script of batchbestand dat je metriekrapporten automatisch bij elke commit of op geplande tijden uitvoert. - Overweeg CI/CD integratie voor automatische kwaliteitscontroles. **Samenvatting** - Installeer benodigde Python-pakketten. - Schrijf een Python-script dat alle metriek-commands uitvoert. - Maak een Sublime Text build systeem om het uit te voeren. - Bekijk resultaten direct in Sublime Text. - Voor verdere visualisatie kun je resultaten exporteren en externe tools gebruiken. Door deze aanpak heb je een geïntegreerd systeem binnen Sublime Text dat je codekwaliteit snel en gemakkelijk kan monitoren en visualiseren.

Hier is een gedetailleerde handleiding voor het opzetten van een codekwaliteitssysteem in Sublime Text voor Python: ## 1. Vereiste Tools Installeren ### Package Control (als je deze nog niet hebt): - Open Sublime Text - Druk `Ctrl + `` om de console te openen - Plak de installatiecode van [Package Control](https://packagecontrol.io/installation) ### Essentiële Packages Installeren: 1. **Terminus** (voor geïntegreerde terminal): - `Ctrl + Shift + P` → "Package Control: Install Package" - Zoek naar "Terminus" 2. **SublimeLinter** (basis framework): - Installeer via Package Control - Voeg deze specifieke linters toe: ```bash pip install flake8 pylint radon coverage bandit ``` ## 2. Linters en Analyzers Configureren ### Flake8 Configuratie: Maak een `.flake8` bestand in je projectroot: ```ini [flake8] max-complexity = 10 ignore = E203, W503 exclude = .git,__pycache__,build,dist max-line-length = 88 ``` ### Radon voor Cyclomatische Complexiteit: ```bash pip install radon ``` ### Coverage.py voor Code Coverage: ```bash pip install coverage ``` ## 3. Sublime Text Packages voor Visualisatie ### Installeren via Package Control: 1. **SublimeLinter-flake8** 2. **SublimeLinter-pylint** 3. **Anaconda** (Python IDE features) 4. **GitGutter** (wijzigingen tracking) ### Anaconda Configuratie: Voeg toe aan je gebruikersinstellingen (`Preferences > Package Settings > Anaconda > Settings - User`): ```json { "anaconda_linting": true, "anaconda_linting_behaviour": "load-save", "anaconda_gutter_theme": "blue", "anaconda_linter_marks": "fill", "python_interpreter": "/pad/naar/je/python" } ``` ## 4. Project-specifieke Setup ### Projectbestand maken: `Project > Save Project As...` en voeg toe: ```json { "folders": [ { "path": ".", "file_exclude_patterns": ["*.pyc", "__pycache__"], "folder_exclude_patterns": [".git", "venv"] } ], "settings": { "SublimeLinter.linters.flake8.python": "/pad/naar/python", "SublimeLinter.linters.pylint.python": "/pad/naar/python" }, "build_systems": [ { "name": "Code Quality Check", "shell_cmd": "python -m flake8 . && python -m radon cc . -a && python -m coverage run -m pytest && python -m coverage report" } ] } ``` ## 5. Automatisering met Build Systems ### Custom Build System maken: `Tools > Build System > New Build System`: ```json { "cmd": [ "python", "-m", "flake8", "${file}" ], "name": "Python Code Quality", "file_regex": "^(.+?):(\\d+):(\\d+): (\\w\\d+) (.*)$", "working_dir": "${project_path:${folder}}" } ``` ## 6. Real-time Metriek Weergave ### Side Bar Enhancements: - Installeer "SideBarEnhancements" - Rechtsklik op bestanden voor snelle analyses ### Key Bindings voor Snelle Checks: Voeg toe aan `Preferences > Key Bindings`: ```json [ { "keys": ["ctrl+shift+q"], "command": "exec", "args": { "cmd": ["python", "-m", "radon", "cc", "${file}", "-a"] } }, { "keys": ["ctrl+shift+c"], "command": "exec", "args": { "cmd": ["python", "-m", "coverage", "run", "${file}"] } } ] ``` ## 7. Dashboard voor Code Kwaliteit ### Python Script voor Samenvatting: Maak `code_quality_dashboard.py`: ```python #!/usr/bin/env python3 import subprocess import json def get_code_metrics(): metrics = {} # Cyclomatische complexiteit result = subprocess.run(['radon', 'cc', '-s', '-a', '.'], capture_output=True, text=True) metrics['complexity'] = result.stdout # Code coverage result = subprocess.run(['coverage', 'report'], capture_output=True, text=True) metrics['coverage'] = result.stdout # Code smells (flake8) result = subprocess.run(['flake8', '--statistics', '.'], capture_output=True, text=True) metrics['smells'] = result.stdout return metrics if __name__ == "__main__": print(json.dumps(get_code_metrics(), indent=2)) ``` ## 8. Workflow Integratie ### Dagelijkse Routine: 1. Open project in Sublime Text 2. Gebruik `Ctrl + Shift + Q` voor complexiteitscheck 3. Gebruik `Ctrl + B` voor build met kwaliteitsmetriek 4. Bekijk gutter marks voor real-time feedback 5. Gebruik Terminus voor gedetailleerde reports ### Automatische Checks: - SublimeLinter geeft real-time feedback - GitGutter toont wijzigingen - Anaconda biedt code completion met kwaliteitshints ## 9. Geavanceerde Visualisatie ### Color Schemes voor Complexiteit: Pas je color scheme aan om complexe code te highlighten via `Preferences > Color Scheme` ### Custom Gutter Icons: Configureer SublimeLinter om verschillende icons te tonen voor verschillende issue types Deze setup geeft je een uitgebreid kwaliteitsmonitoringssysteem direct in je editor, met zowel real-time feedback als gedetailleerde rapportage mogelijkheden.