576 liens privés
Règle 4
Aucune fonction ne doit être plus longue que ce qui peut être imprimé sur une seule feuille de papier, dans un format de référence standard, avec une ligne par instruction et une ligne par déclaration. En règle générale, cela signifie qu’il n’y a pas plus de 60 lignes de code par fonction.
Ayant parfois affaire à des fichiers Excel de quelques centaines de lignes, et parfois plusieurs dizaines de colonne, ça me rend fou.
Donc j'aime bien cette règle : maximum 60 lignes. À cela on peut ajouter une des règles du PEP-8 Python qui préconise pas + de 79 caractères par ligne.
Voir aussi la RFC 2223 qui indique :
3a. ASCII Format Rules
[…]
Each page must be limited to 58 lines followed by a form feed on a
line by itself.
Each line must be limited to 72 characters followed by carriage
return and line feed.
Cela donne un formatage un peu surprenant mais cela donne une bonne idée de ce qui est humainement révisable.
Édition 2024-09-26
Finalement ces « 10 règles pour écrire du code sécurisé » s'inspire/a inspiré les règles de codage du JPL de la NASA 👇
- Éviter les constructions de flux complexes, telles que goto et récursivité .
- Toutes les boucles doivent avoir des limites fixes. Cela évite de créer involontairement des boucles infinis.
- Éviter d'allouer de la mémoire sur la heap.
- Limiter les fonctions à une seule page affichable sur un écran.
- Utiliser un minimum de deux assertions par fonction.
- Limiter la portée des variables au plus petit possible.
- Vérifier la valeur de retour de toutes les fonctions non-void ou transformer en void pour indiquer que la valeur de retour est inutile.
- Utiliser le préprocesseur avec parcimonie.
- Limiter l'utilisation du pointeur à un seul déréférencement et ne pas utiliser de pointeur de fonction.
- Compiler avec tous les avertissements possibles actifs ; tous les avertissements doivent alors être pris en compte avant la publication du logiciel.
