Kode-stilguide

Denne vejledning indeholder oplysninger og retningslinjer for skrivning af kode til BeeWare.

Kodestil

BeeWare følger PEP 8 i vores kodebase, bortset fra at linjelængden er udvidet fra 79 til 88 tegn. Vi bruger Ruff til at håndhæve PEP 8-konventioner, hvor det er muligt. Når du committer din kode, kører pre-commit nogle kontroller, herunder Ruff. Hvor det er muligt, vil dette automatisk formatere din kode for at sikre, at den overholder vores formaterings- og stilstandarder. Du kan indstille nogle IDE'er til automatisk at køre Ruff ved gemning, hvilket kan hjælpe med processen.

Husk, at det vigtigste i PEP 8 er Afsnit 0: En tåbelig konsistens er små sinders mareridt. Der er situationer, hvor det ikke giver mening at være konsistent med PEP 8, og det er vigtigt at forstå, at det i visse tilfælde er acceptabelt og undertiden at foretrække at skrive kode, der ikke er i overensstemmelse med de anførte regler. At vide, hvornår man skal være inkonsekvent med disse regler, er lige så vigtigt som at opretholde konsistens i de fleste situationer.

Vi følger amerikansk stavning for API-navngivning, variabler osv.

Ting, man bør undgå

Vi forsøger at undgå utils moduler så meget som muligt, men er klar over, at det nogle gange er uundgåeligt. Det foretrukne alternativ er at finde en anden placering for funktionen i kildekoden i stedet for at bruge et utils modul.

Som hovedregel forsøger vi at undgå eller udskyde dyr initialiseringskode for at opnå hurtigere opstart af appen. For eksempel er moduler i toga-core-pakken "lazy loaded" — de importeres kun, når der anmodes om det, i stedet for på forhånd. Dette fremskynder opstarten og bruger kun tid på det, appen faktisk bruger.