Ej. 45 : Creando mi juego…

Tengo que empezar a aprender a caminar por mí misma…Siiii. Ya he aprendido en que toda la información está en Internet (curiosamente lo he aprendido en un libro…y porque no han parado de repetírmelo, ejem).

En éste post lucharé con un gran proyecto, e intentaré hacerlo funcionar…

Éstos son algunos requisitos:

  1. Crear un juego diferente al único que he hecho.
  2. Utilizar import para usar más de un fichero.
  3. Usar una clase por habitación y dar a las clases nombres adecuados a sus funciones.
  4. Mi programa necesita saber que existen esas habitaciones, así que debo crear una clase que las ejecute y sepa de su existencia. Hay muchas maneras de hacerlo, pero hay que tener en cuenta que cada habitación devuelve la habitación siguiente o asigna a una variable cuál es la habitación siguiente.

El objetivo de éste post es aprender cómo estucturar las clases que necesitan otras clases dentro de otros archivos.

(…)

EVALUANDO MI JUEGO

(…)

NORMAS DE ESTILO EN LAS FUNCIONES

Todas las reglas que he aplicado sobre cómo hacer una buena función, se siguen aplicando, pero añadiré alguna más.

  • Por diversas razones, lo programadores llama métodos a las funciones que forman parte de las clases. Cada vez que diga función, me corregirán diciendo «método»…
  • Cuando se trabaja con clases, se dedica mucho tiempo a hablar de crear la clase «hacer cosas» …
  • Simplificar las funciones y hacerlas pequeñas. Cuando se avanza con las clases, no hay que olvidar ésto.

NORMAS DE ESTILO EN LAS CLASES

  • Mi clase debería usar el estilo llamado «camel case», como en SuperGoldFactory, en lugar de super_gold_factory.
  • No escribir demasiado en las funciones __init__, ya que eso las hace más difíciles de usar.
  • Las otras funciones deben utilizar el «formato de subrayado». Así, escribo mi_pelo_rubio en lugar de mipelorubio o MiPeloRubio.
  • Ser constante en la forma de organizar los argumentos de las funciones. Si la clase tiene user, dog y cat, mantener el orden en todo, a menos que realmente no tenga sentido. Si tengo una función que toma los parámetros (dog, cat, user) y otra que los toma (user, cat, dog), será muy difícil usarlas.
  • Tratar de no usar las variables que vienen del módulo o globales. Éstas deben de ser bastante autónomas.
  • Siempre siempre siempre usar el formato class Nombre(object) o de lo contario surgirán problemas.

NORMAS DE ESTILO EN EL CÓDIGO

  • Añadir espacios entre algunas líneas de código para facilitar la lectura.
  • Si no se puede leer en voz alta, probablemente resulte difícil de leer. Intentar hacerlo lo más legible posible.
  • Copia un estilo, hasta que encuentres el tuyo.
  • Cuando crea que he encontrado mi propio estilo, todavía se podrá mejorar. XD Trabajar con el código de otras personas es parte de la tarea de un programador y otras personas tienen muy mal gusto…
  • Si encuentro un estilo que me guste, intentar imitarlo.

BUENOS COMENTARIOS

  • Hay quien dice que el código debe de ser lo suficientemente legible para no necesitar comentarios…ergo ¿no hay que escribir comentarios? Ni caso.
  • Lo mejor es describir por qué hago lo que hago. El código dice cómo.
  • Es ideal crear comentarios pensando en el lector que use mi código. Añadir una buena frase sobre qué puede hacer alguien con una función, puede ayudar mucho.
  • Comentarios breves y concisos.
  • Si se cambia código, revisar los cometarios. Obvio.

EVALUANDO MI CÓDIGO

(…)