Reglas del diseño simple

4 reglas del diseño simple

1. El código pasa correctamente los test.
2. Revela la intención del diseño. El código debe autoexplicarse.
3. Respeta el principio DRY: “don’t repeat yourself”, no repitas código.
4. Tiene el menor número posible de elementos. 1 función = 1 acción.

Clase 2: 4 reglas del diseño simple

• El código pasa correctamente los test. -> Buenos test ayuda al código a garantizar la seguridad en funcionamiento
• Revela la intención del diseño. El código debe autoexplicarse. -> Tu código tiene que hablar por sí mismo, revelando cuál es la intensión de ese método, esa variable, esa función. Etc.
• Respeta el principio DRY: “don’t repeat yourself”, no repitas código. -> No te repitas a ti mismo, no repitas fragmentos de códigos
• Tiene el menor número posible de elementos. 1 función = 1 acción. -> Mas simple sea tu código es mejor

Mantener la regla de DRY (Don’t Repeat Yourself), NO siempre es sencillo. En muchos blogs he visto, esto casi siempre se refiere a modularización del código (dividir nuestro código en funciones más especificas). Y aunque esto es correcto, es solo la primera parte de esta regla.
.
Existen muchas otras variantes para aplicar esta regla que no son siempre “obvias” al momento de escribir código. Por ejemplo, considera las siguientes funciones:
.

function sortNumArr(arr, asc = 1) {
  return arr.sort((a, b) => {
    let result = 0;

    if (a > b) result = asc ? -1 : 1
    if (b > a) result = asc ? 1 : -1

    return result;
  });
}

function sortPeopleArr(peopleArr, asc = 1) {
  // Arr of person obj
  // { name: string, age: number }
  return peopleArr.sort((a, b) => {
    let result = 0;

    if (a.age > b.age) result = asc ? -1 : 1
    if (b.age > a.age) result = asc ? 1 : -1

    return result;
  });
}

.
Hace exactamente lo mismo, estan ordenando un array de datos, ya sea de primitivos o de objetos. En este caso, no se esta respetando la regla de DRY.
.

¿Cómo lo solucionamos? Con una abstracción

Vamos a crear una función que haga el algoritmo de ordenamiento, mientras que en uno de los argumentos le vamos a pasar el detalle, dependiendo del tipo de dato, al final queda algo como esto:
.

function sortGeneralArr(comparator, asc = 1) {
  return function (arr) {
    return arr.sort((a, b) => {
      let result = 0;

      if (comparator(a, b)) result = asc ? -1 : 1;
      if (comparator(b, a)) result = asc ? 1 : -1;

      return result;
    });
  };
}

const sortNumArr = sortGeneralArr((a, b) => a > b);
const numSortedArr = sortNumArr(numArr);

const sortPeopleArr = sortGeneralArr((a, b) => a.age > b.age);
const peopleArrSorted = sortPeopleArr(peopleArr);

Para mi sería revela la intención del diseño, de esta manera cualquier desarrollador que lea el código pueda entender de la mejor manera lo que hace ese fragmento de código

yo pienso que es el de test

Puede ser muy teórico lo que menciona, pero a la hora de hacer un proyecto es sumamente importante tener en cuenta estos puntos.
Así que esto va para: #developers #softwareengineers

Feedback
Pareces una robot we, por fa mejora tus habilidades de oratoria, se nota desde la esquina que estás leyendo, esto por ende se le quita calidad y credibilidad al curso, te tienes que apropiar de tus palabras y de los conocimientos que tienes afianzados.

Para mi sin dudas, la regla mas importante, sin quitarle el mérito a las demás es “Respeta el principio DRY (don’t repeat yourself)”. Al reutilizar código dentro de nuestro proyecto desde un método, estamos haciendo que este sea mas estable y mantenible.

hay profes demasiado geniales !!

Pienso que cada regla del diseño simple aporta demasiado como para definir una más importante que otra porque están muy ligadas entre sí. Revelar la intención del diseño se logra de una manera eficaz a menor cantidad de elementos contenga y procesos simples existan, para ello se debe respetar el principio DRY. A su vez, un código que no pueda ser probado eficientemente puede conducir a una equivoca interpretación de la intención.

Uy, esta difícil decidir la mas importante, diría que la separación de responsabilidad

Revela la intención del diseño.