Conventions de dénomination pour les méthodes/classes/packages

Question

Quelles conventions de dénomination utilisez-vous pour le code quotidien? Je réfléchis à cela parce que j'ai actuellement un projet en Python qui contient 3 paquets, chacun avec un but unique. Maintenant, j'ai mis des méthodes «utilitaires» générales dans le premier paquet que j'ai créé pour le projet, mais j'envisage de déplacer ces méthodes dans un paquet séparé. La question est de savoir comment je l'appelle? Utilitaire, Collection, Assorties?

Y a-t-il des conventions de nommage standard que vous ne jurent pas, et si oui pouvez-vous s'il vous plaît fournir des liens? Je suis conscient que chaque langue a ses propres conventions de nommage, mais y en a-t-il une particulière que vous trouvez la plus utile, que vous recommanderiez de commencer à utiliser?

Answer 1

En général, vous devez respecter la convention de dénomination de la langue que vous utilisez. Peu importe si vous aimez ou préférez les normes d'une autre langue. La cohérence dans le contexte de la langue permet de rendre votre code plus lisible, maintenable et utilisable par d'autres. En Python, cela signifie que vous utilisez PEP 8.

l'aide d'un exemple personnel:

En Python, je dirais que le paquet « utils » - ou si je comptais sur la redistribution, « coryutils » ou quelque chose de similaire pour éviter les collisions d'espace de noms.

En Java ou en ActionScript, j'appellerais le paquet "net.petosky.utils", que je le souhaite ou non en redistribution.

Answer 2

À moins d'avoir de bonnes raisons de ne pas le faire, vous devez suivre les directives présentées au PEP 8. Voir, en particulier, "Prescriptive: Naming Conventions".