DressCode

DressCode kontroluje a opravuje styl PHP kódu nad bezztrátovým syntaktickým stromem: pravidlo změní jen to, na co sáhne, a zbytek souboru zůstane bajt po bajtu stejný. Nemá vlastní styl, jen presety PER, PSR-12 a Nette.

Používal jsem roky PHP CS Fixer i PHP_CodeSniffer a považoval je za hotovou věc: nástroj, který se jednou nastaví a pak se o něm nemluví. Pak jsem si přečetl, jak vypadá pravidlo v DressCode, a pochopil, kolik času jsem trávil ne stylem, ale obcházením toho, že nástroj vidí jen seznam tokenů. Tahle dokumentace je psaná z pohledu někoho, kdo ho od té doby nasadil na všechno, co má; kde je něco jinak než jinde, řeknu to, a kde je něco jinde lepší, taky.

Kudy dál

• Začínáme instalace, první kontrola a první oprava.
• Přechod na DressCode pokud dnes používáte PHP CS Fixer, PHP_CodeSniffer, Slevomat nebo ECS.
• Vlastní pravidlo pokud vám v katalogu něco chybí.

Používání

• Jak DressCode přemýšlí mentální model: strom, pravidla, presety, průchody.
• Konfigurace soubor, presety a vrstvy, pravidla a volby, cesty.
• Potlačení a baseline výjimky na řádku, v souboru a v projektu.
• Příkazová řádka příkazy, volby, formáty výstupu, exit kódy.

Reference

• Pravidla všechna vestavěná pravidla s příklady a volbami.
• Presety co který preset zapíná.
• Uzly stromu pro autory pravidel a uživatele PhpSyntax.

Rozšíření a integrace

• Jak se DressCode rozšiřuje, pravidla hry, pravidla o mezerách, testování.
• PhpSyntax parser jako samostatná knihovna.
• Editory a IDE, průběžná integrace, Git hooky a agenti.