Développer

Cette partie s’adresse aux contributeurs de pyrucast. Elle décrit l’organisation du code, les conventions à respecter, le modèle mémoire sous-jacent, comment documenter, compiler et tester, et les deux extensions les plus courantes (ajouter une physique, ajouter un élément fini).

• Arborescence — la carte des sources : où vit chaque morceau (containers/, ops/, models/, py/, viz/…).
• Conventions & philosophie — méthode vs fonction libre, erreurs, Display/Debug/dump, sérialisation, Definition of Done.
• Documentation et tests — les types de test et ce que chacun prouve, où vit un exemple, la règle « aucune page ne possède de code », et ce qui n’est pas vérifié.
• Modèle mémoire — les objets derrière un Handle, les guards, le compteur par nœud de Coords, et la mécanique de l’archive.
• Parallélisme — rayon porté au-dessus des noyaux, zéro-copie, déterminisme, et ce qui reste séquentiel.
• Compilation et tests — installation détaillée, features Cargo, génération du stub .pyi, script « tout-en-un », dépannage.
• Ajouter une physique — le coût en O(1) fichier d’une nouvelle variante de SubModel / SubModelKind.
• Ajouter un élément fini — un nouveau ElementType, son interpolation et sa quadrature.
• Interrompre une fonction — le jeton Cancel : un Ctrl+C ou un timeout qui arrête une boucle longue.