Génie logiciel readability

4

Faut-il renommer des méthodes surchargées?

Supposons une interface contenant ces méthodes: Car find(long id); List<Car> find(String model); Est-il préférable de les renommer comme ça? Car findById(long id); List findByModel(String model); En effet, tout développeur qui utilise cette API n'aura pas besoin de regarder l'interface pour connaître les arguments possibles des find()méthodes initiales . Ma question …

14 design naming readability method-overloading

4

Existe-t-il des inconvénients réels au chaînage de méthodes autoréférentielles?

J'ai récemment suggéré qu'une méthode de chaînage soit implémentée pour une certaine classe dans un certain projet afin que la lisibilité du code puisse être améliorée. J'ai obtenu une réponse «les interfaces fluides ne devraient pas être implémentées uniquement pour des raisons de commodité, mais pour la sémantique» et ma …

14 architecture coding-standards readability method-chaining

4

Comment dois-je écrire un test pour une méthode pure qui ne renvoie rien?

J'ai un tas de classes qui traitent de la validation des valeurs. Par exemple, une RangeValidatorclasse vérifie si une valeur se situe dans la plage spécifiée. Chaque classe de validateur contient deux méthodes is_valid(value):, qui renvoie Trueou en Falsefonction de la valeur, et ensure_valid(value)qui vérifie une valeur spécifiée et soit …

13 unit-testing exceptions readability

4

Quelle est la meilleure façon de terminer la boucle de lecture?

Lorsque vous devez répéter un lecteur dont le nombre d'éléments à lire est inconnu, et la seule façon de le faire est de continuer à lire jusqu'à la fin. C'est souvent l'endroit où vous avez besoin d'une boucle sans fin. Il y a toujours truequi indique qu'il doit y avoir …

13 c# code-quality readability

6

Les sigils facilitent-ils la lecture du code source?

Dans la plupart des langages de programmation, les variables n'ont pas de caractères d'identification comme elles le font en PHP. En PHP, vous devez préfixer une variable avec le $caractère. Exemple; var $foo = "something"; echo $foo; Je développe un nouveau langage de script pour une application métier, et mes …

13 programming-languages readability

1

Comment écrire du code Clojure lisible?

Je suis nouveau à Clojure. Je peux comprendre le code que j'écris mais il devient trop difficile de le comprendre plus tard. Il devient difficile de faire correspondre les parenthèses. Quelles sont les conventions génériques à suivre concernant les conventions de dénomination et l'indentation dans diverses situations? Par exemple, j'ai …

13 readability clojure

4

Mettre l'accent sur la négation

J'étais en train d'écrire une instruction if avec des noms de propriétés assez longs et je suis tombé sur ce problème. Disons que nous avons une instruction if comme celle-ci: if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) { //Do something } La deuxième propriété est de type booléen et cela n'a aucun …

13 readability

5

Lisibilité de la programmation fonctionnelle [fermé]

Fermé . Cette question doit être plus ciblée . Il n'accepte pas actuellement les réponses. Voulez-vous améliorer cette question? Mettez à jour la question afin qu'elle se concentre sur un problème uniquement en modifiant ce message . Fermé il y a 2 ans . Je suis curieux de cela parce …

13 object-oriented functional-programming readability

4

Est-ce mal d'utiliser des drapeaux pour «grouper» les énumérations?

Ma compréhension est que les [Flag]énumérations sont généralement utilisées pour des choses qui peuvent être combinées, où les valeurs individuelles ne s'excluent pas mutuellement . Par exemple: [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, } Où toute …

12 c# .net readability enum

5

Répétition de code vs méthode multi-responsable

J'essaie de suivre le principe de responsabilité unique (PRS) et aussi d'omettre les répétitions de code. Cependant, il y a souvent des endroits où il y a des répétitions de code qui ne sont rien d'autre que des blocs de code d'invocations qui résistent à les extraire dans au moins …

11 refactoring readability single-responsibility code-reuse

3

«Statique» comme indice sémantique sur l'apatridie?

J'ai récemment entrepris une refactorisation d'un projet de taille moyenne en Java pour revenir en arrière et ajouter des tests unitaires. Quand j'ai réalisé à quel point c'était pénible de se moquer des singletons et de la statique, j'ai finalement «compris» ce que j'avais lu à leur sujet tout ce …

11 coding-standards readability coding-style static-methods

6

Quelle est la plus maintenable - l'affectation booléenne via if / else ou l'expression booléenne?

Laquelle serait considérée comme plus maintenable? if (a == b) c = true; else c = false; ou c = (a == b); J'ai essayé de chercher dans Code Complete, mais je ne trouve pas de réponse. Je pense que le premier est plus lisible (vous pouvez littéralement le lire …

11 .net code-quality readability maintainability clean-code

6

Besoin de rendre mon code plus lisible pour les autres programmeurs de mon équipe

Je travaille un projet à delphi et je crée un installateur pour l'application, il y a trois parties principales. Installation / désinstallation de PostgreSQL myapplication (la configuration de myapplication est créée à l'aide de nsi) installation / désinstallation. Création de tables dans Postgres via script (fichiers batch). Tout se passe …

11 code-quality readability logging

10

Les fonctions «mathématiques» devraient-elles suivre la notation mathématique?

Je suppose que cette question sera immédiatement signalée comme subjective, mais laquelle pensez-vous est la meilleure: double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } ou double volume(double P, double n, double T) { return n*R*T/P; } En d'autres termes, les fonctions …

11 math coding-style readability

12

Maintenabilité de la logique booléenne - L'imbrication est-elle nécessaire si des instructions sont nécessaires?

Lequel de ceux-ci est le meilleur pour la maintenabilité? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable OU if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable Je préfère lire et écrire le second, mais je me souviens avoir lu dans le …

11 programming-practices coding-standards maintenance readability

Questions marquées «readability»