Real-time VS Code linter and automated fixer for the Epitech C Coding Style (C-*).
Designed for Epitech students and C developers, EpiCancelMarvin (ECM) inspects your .c and .h source files in real time, flags norm violations (Banana / Marvin rules), and provides instant automatic fixes with a single shortcut or click.
✨ Features
Real-Time Linting: Instant feedback as you type (debounced by 250 ms), on file open, and on save for .c and .h files.
Inline Error Annotations & Red Gutter Arrow: Problematic lines are clearly highlighted with a red arrow in the editor gutter and an inline description right after the line (← [C-*] description).
Magic "Fix All" Action: Click the sparkle icon $(sparkle) in the editor title bar or use the dedicated shortcut to instantly resolve all fixable Coding Style violations in the active file.
Dedicated Shortcut: Press Ctrl+Alt+E (or Cmd+Alt+E on macOS) in any C file to trigger Fix All immediately.
Status Bar Toggle: Turn the linter on or off with a single click in the status bar ($(check) ECM / $(circle-slash) ECM).
Interactive Quick Fixes: Hover over any diagnostic or press Ctrl+. to review and apply individual fixes or the global Fix All action.
Official Modern Epitech Header: Validate, insert, and update standard headers conforming to current Epitech standards.
Zero External Dependencies: Pure native TypeScript implementation. Runs directly in VS Code without requiring Docker, Python, or external scripts installed on your system.
📋 Supported Coding Style Rules
Rule
Description
Auto-Fix
C-G1
Missing or invalid Epitech standard file header
✅ Yes
C-G2
Function implementations must be separated by exactly one blank line
✅ Yes
C-A3
Trailing line break at end of file required (\n)
✅ Yes
C-G6
UNIX line endings (\n) required / trailing backslash forbidden
✅ Yes
C-G7
Trailing spaces at the end of the line
✅ Yes
C-F6
Functions taking no parameters must explicitly declare (void)
✅ Yes
C-F8
Comments inside function bodies are forbidden
✅ Yes
C-L1
Only one statement per line
✅ Yes
C-L2
Indentation must use multiples of 4 spaces (tabs forbidden)
✅ Yes
C-L3
Spacing around operators, keywords, commas, and parentheses
✅ Yes
C-L4
Curly brace placement (nextLine for functions, same-line for control blocks)
✅ Yes
C-L5
Variable declarations must be placed at the beginning of the function (one per statement)
✅ Yes
C-L6
Blank lines: exactly one blank line after declarations, none between statements
✅ Yes
C-V3
Pointer asterisk attached to the variable name (char *str)
✅ Yes
C-F3
Line length exceeds 80 columns
❌ Manual
C-F4
Function body exceeds 20 lines
❌ Manual
C-F5
More than 4 parameters in a function
❌ Manual
C-O3
More than 10 functions in a single file
❌ Manual
C-C1
Conditional branching has > 3 branches or nesting > 2
❌ Manual
C-C3
Forbidden use of goto
❌ Manual
🚀 Usage
One-Click Fix All
Open any C file (.c or .h): a sparkle icon $(sparkle) appears in the top-right editor action bar. Click it to immediately fix all repairable violations.
Shortcuts & Commands
Direct Keyboard Shortcut: Press Ctrl+Alt+E (or Cmd+Alt+E on macOS) in any focused C file to run Fix All.
Command Palette (Ctrl+Shift+P / Cmd+Shift+P): Type ECM: to access commands:
ECM: Fix all CodingStyle errors in this file
ECM: Toggle on / off
ECM: Insert the Epitech file header
ECM: Show problems for this file
ECM: Convert the file to UNIX line endings
Right-Click Context Menu: Right-click anywhere in a C file to access Fix All, Insert Header, and Show Problems.
Quick Fix Bulb: Press Ctrl+. on any highlighted error to see its specific quick fix.
⚙️ Configuration
Customize the extension behavior in VS Code Settings (Ctrl+, / Cmd+,):
epicancelMarvin.enabled: Master switch to enable or disable linting (synchronized with status bar).
epicancelMarvin.inlineAnnotations: Toggle inline error messages and red gutter arrows on error lines (default: true).
epicancelMarvin.braceStyle.function: Function opening brace placement (nextLine by default for Epitech C-L4, or sameLine).
epicancelMarvin.header.project: Project name inserted in the header (default: my_project).
epicancelMarvin.header.description: File description inserted in the header (default: File description).
epicancelMarvin.rules.*: Toggle any specific Coding Style rule on or off.
👤 Author
Created by Nathan Kyo (QUIX) for the Epitech community.
Distributed under the MIT License.