Refactorización de Juegos en Python: Uso de Funciones

Clase 15 de 44 • Curso de Python: Comprehensions, Funciones y Manejo de Errores

Resumen

¿Cómo refactorizar un juego utilizando funciones?

Has llegado al momento de poner a prueba tus conocimientos de Python y funciones a través de un proyecto práctico: la refactorización del clásico juego de "piedra, papel o tijera". Al eliminar el uso de variables globales y organizar mejor el código, logramos hacerlo más legible y mantenible. Ahora nos sumergiremos en cómo aplicar funciones para mejorar este juego y su estructura.

¿Cuál es el primer paso para aplicar funciones al juego?

El primer paso es identificar responsabilidades en el código. Por ejemplo, podemos crear una función cuya única responsabilidad sea elegir las opciones tanto del usuario como de la computadora. Esta función simplifica la lectura del código y asegura que cada parte del mismo solo se encargue de una tarea específica.

def choose_options():
    # Código que selecciona opciones del usuario y la computadora
    # y valida si son válidas.
    # Si no son válidas, retorna None.

¿Cómo separar las reglas del juego en otra función?

Otra buena práctica es extraer la lógica que define las reglas del juego en función separada. Esto ayuda a aislar la lógica compleja y hace que el código principal sea más fácil de entender.

def check_rules(user_options, computer_options):
    # Código que valida las reglas y retorna los puntajes actualizados.

¿Cómo crear la función principal del juego?

La función principal debería ser un punto de entrada claro para el juego, ejecutando todas las otras funciones necesarias para correr el juego adecuadamente.

def run_game():
    user_wins = 0
    computer_wins = 0
    rounds = 0
    while True:
        # Llamadas a funciones y lógica del ciclo
        user_options, computer_options = choose_options()
        user_wins, computer_wins = check_rules(user_options, computer_options, user_wins, computer_wins)

¿Cómo mejorar la mantenibilidad del código con funciones?

Refactorizar el código usando funciones reduce errores y simplifica futuras modificaciones o añadidos. Es importante siempre mantener cada función enfocada en una única responsabilidad, lo cual promueve un diseño de código más limpio y profesional. Al final, las funciones actúan como bloques independientes pero interconectados, cada uno resolviendo una parte del problema de programación total.

Utiliza este enfoque para todos tus proyectos futuros. Te hará un mejor programador y te facilitará el trabajo en equipo, ya que otros podrán entender tu código de manera más rápida y clara. Sigue practicando y atrévete a modificar el código de maneras distintas para encontrar la que mejor se adapte a ti. ¡No dudes en seguir adelante porque el aprendizaje nunca se detiene cuando se trata de programación!

Mariano Coto

student•

Re armar el programa en base a un proyecto anterior termina siendo confuso. Era mejor empezar desde cero, uno se pasa mas tiempo tratando de seguir el armado de este ++Frankestein++ que aplicando lo aprendido hasta ahora.

Diego Jurado

student•

De acuerdo Mariano, la verdad me perdi con la aplicación de funciones

Federico Martinez

student•

Es verdad

Brayan Avendaño

student•

Mi aporte:

import random 

print("""
      [ 🤖 Bienvenido al juego Piedra, Papel o tijera 🙋]
                  >>> Ingresa una opción <<<
      """)


def choose_options():
    options = ('piedra', 'papel', 'tijera')
    user_option = input('>>> Piedra, papel o tijera => ').lower()
   
    if not user_option in options:
        print('Esa opción no es valida')
        #continue
        return None, None 
    
    computer_option = random.choice(options)

    print('User option => ', user_option)
    print('Computer option => ', computer_option)
    return user_option, computer_option


def check_rules(user_option, computer_option, user_wins, computer_wins):
    if user_option == computer_option:
        print('Empate!\n')
    elif user_option == 'piedra':
        if computer_option == 'tijera':
            print('🪨 Piedra gana a tijera ✂️')
            print('¡User gana!\n')
            user_wins += 1
        else:
            print('📄 Papel gana a piedra 🪨')
            print('¡Computer gana!\n')
            computer_wins += 1
    elif user_option == 'papel':
        if computer_option == 'piedra':
            print('📄 Papel gana a piedra 🪨')
            print('¡User gana!\n')
            user_wins += 1
        else:
            print('✂️ Tijera gana a papel 📄')
            print('¡Computer gana!\n')
            computer_wins += 1
    elif user_option == 'tijera':
        if computer_option == 'papel':
            print('✂️ Tijera gana a papel 📄')
            print('¡User gana!\n')
            user_wins += 1
        else:
            print('🪨 Piedra gana a tijera ✂️')
            print('¡Computer gana!\n')
            computer_wins += 1
            
    return user_wins, computer_wins


def check_winner(user_wins, computer_wins):
    
    print(f'''
    🤖 Computer wins: {computer_wins}
    🙋 User wins: {user_wins}
            ''')
    
    if user_wins == 3:
        print('🎖️ El ganador es User 🎖️')
        exit()
        
    if computer_wins == 3:
        print('🎖️ El ganador es Computer 🎖️')
        exit()


def run_game():
    
    computer_wins = 0 
    user_wins = 0
    rounds = 1

    while True:
        print('***' * 10)
        print('Round ', rounds)
        print('***' * 10)

        rounds += 1
              
        user_option, computer_option = choose_options()
        user_wins, computer_wins = check_rules(user_option, computer_option,user_wins, computer_wins)
        check_winner(user_wins, computer_wins) 
        
                    
run_game()

Nicolas Molina

teacher•

Los emojis mejoran el proyecto 10x, grenial!

Felipe Vidal

student•

hice una pequeña modificacion a tu respuesta para reducir un poco de codigo aplicando temas anteriores :D


import random 

print("[ 🤖 Bienvenido al juego Piedra, Papel o tijera 🙋] >>> Ingresa una opción <<<\n")
result = {
          'piedra' : { 'tijera' : 1, 'papel' : 0 },
          'papel' : { 'tijera' : 0, 'piedra' : 1 },
          'tijera' : { 'papel' : 1, 'piedra' : 0 }
}
def choose_options():
    options = ('piedra', 'papel', 'tijera')
    user_option = input('>>> Piedra, papel o tijera => ').lower()
   
    if not user_option in options:
        print('Esa opción no es valida')
        #continue
        return None, None 
    
    computer_option = random.choice(options)

    print('User option => ', user_option)
    print('Computer option => ', computer_option)
    return user_option, computer_option


def check_rules(user_option, computer_option, user_wins, computer_wins):
    if user_option == computer_option:
        print('Empate!\n')
    
    else:
      ganador = result[user_option][computer_option]
      if ganador:
          print("{} gana a {}".format(user_option, computer_option))
          print('¡User gana!\n')
          user_wins += 1
      else:
          print("{} gana a {}".format(computer_option,user_option))
          print('¡Computer gana!\n')
          computer_wins += 1
            
    return user_wins, computer_wins


def check_winner(user_wins, computer_wins):
    
    print(f'''
    🤖 Computer wins: {computer_wins}
    🙋 User wins: {user_wins}
            ''')
    
    if user_wins == 3:
        print('🎖️ El ganador es User 🎖️')
        exit()
        
    if computer_wins == 3:
        print('🎖️ El ganador es Computer 🎖️')
        exit()


def run_game():
    
    computer_wins = 0 
    user_wins = 0
    rounds = 1

    while True:
        print('***' * 10)
        print('Round ', rounds)
        print('***' * 10)

        rounds += 1
              
        user_option, computer_option = choose_options()
        user_wins, computer_wins = check_rules(user_option, computer_option,user_wins, computer_wins)
        check_winner(user_wins, computer_wins)
run_game()

con esto se reduce un poco la cadena de if para obtener el resultado

Cristian Moreno

student•

Extraño a Facundo, este men no sabe explicar bien.

Salvador Bustamante Garnica

student•

Cruel pero real

Gorka Gallardo Castany

student•

Considero que no es un muy buen feedback, es decir, en vez de simplemente quejarte, podrias comentar que aspectos en su comunicacion echas en falta o mejorarías. Buen dia!

Iván Alejandro Lozano González

student•

Aquí les dejo otra opción. Ejemplo de como las matemáticas nos pueden ayudar a reducir código

Sergio Alejandro Prieto Cano

student•

Ivan me parece maravilloso tu codigo, sin embargo, tengo una duda que no he podido solucionar, ¿como puedes hacer para que el jugador elija la cantidad de rondas y ademas que al final diga quien fue el ganador?

Miguel Gomez

student•

Esta brutal tu código, entiendo entonces que en una funcion de peuden declarar como argumentos otras funciones que posean sus propios argumentos, como en la función ¨resultado¨ya se esta declarando la funcion cambio a numeros el solo ejecutar esta ejecuta ambas

Daniel Montoya Restrepo

student•

Los cursos anteriores con el profe Facundo, eran excelentes, pero estos están increiblemente aun mejor! maravilloso, excelente muestra de que Platzi implementa mejora ocntinua.

Federico Martinez

student•

Que pasó con esos cursos? los sacaron? no encuentro el Curso Profesinal de Python del profe Facundo

Carlos Rivas

student•

En respuesta al compañero federico, Facundo ya no forma parte de Platzi y como esta armando su propia academia seria como hacerle publicidad. y totalmente de acuedo, este curso esta exelente!

José Fabián Beltrán Meza

student•

Con algo de Art ASCII:

MARIBEL CORDOBA MENA

student•

Excelente!

GERMAN GARCIA

student•

ponte el código para copiar art ASCII

Iván Alejandro Lozano González

student•

Me gusta hacer los ejercicios que propone el maestro antes de ver el video.

Si me sale igual que a él, confirmo mi conocimiento. Si me sale distinto, aprendo algo nuevo. Si no me sale, no me frustro y veo la clase para ver como se resolvía el problema que no me dejó avanzar.

En cualquier caso, salgo ganando 😁. 100% recomendado 👌

Edinson Rojas

student•

Walter Ochoa

student•

jajjajajaj

Wilson Montenegro

student•

Es muy feo refactorizar, pero mas vale acostumbrarse, es parte del trabajo. Les dejo la función que faltaba al reto

def check_wins(user_wins, computer_wins):
  if computer_wins == 2:
    print('El ganador es la computadora')
    exit()
  
  if user_wins == 2:
    print('El ganador es el usuario')
    exit()

Esli Ittai Rincón Guillén

student•

Al fin encuentro la forma de cerrar el ciclo, gracias por tu aporte.

Sara María Mejia Sánchez

student•

Estoy de acuerdo, refactorizar no resulta tan cómodo, pero al final es necesario tener otro pensamiento.

Diego Urrea

student•

Esta clase se fue de las manos :S

Leonardo Hurtado Valverde

student•

Parece confuso, el inconveniente es que toma un código de un curso anterior, pero si te tomas el tiempo ya sea para revisar el código o si revisas el otro curso (Fundamentos de Python) verás que no es tan complicado.

Lo que hizo fue refactorizar (agrupar el código en funciones), sirve mucho para hacer que un código sea más sostenible tanto para trabajar como para darle mantenimiento si se llegase a necesitar.

Joel Salazar López

student•

Te entiendo, igual me bugguié al principio que vi todo el código ya hecho pero lo que hice fue pausar el video al principio y final del codigo inicial para copiarlo. Y asi, mientras copiaba parte por parte, iba entendiendo qué hacía cada línea de código. Igual parece que el codigo está en archivos de la clase, pero el hecho de que TÚ lo copies te beneficia más. Después de copiarlo lo ejecuté para cerciorarme que estuviera bien y que hiciera lo que debía. Por último procedes a hacer los cambios del instructor.

Juan Sebastian Alvarez Yaguara

student•

Sin duda la identación es un tema a tener muy en cuenta a la hora de realizar nuestros códigos.

Joaly Canul Interian

student•

Mi aportación agregando el def check_winner:

import random


def choose_options():
  options = ('piedra', 'papel', 'tijera')
  user_option = input('piedra, papel o tijera =>')
  user_option = user_option.lower()
  
  if not user_option in options:
    print('No es una opcion valida')
    # continue
    return None, None

  computer_option = random.choice(options)

  print('User option => ', user_option)
  print('Computer option => ', computer_option)
  return user_option, computer_option

def check_rules(user_option, computer_option, user_wins, computer_wins):
  if user_option == computer_option:
    print('Empate!')
  elif user_option == 'piedra':
    if computer_option == 'tijera':
      print('piedra gana a tijera')
      print('user gano!')
      user_wins += 1
    else:
      print('Papel gana a piedra')
      print('Computer gano!')
      computer_wins +=1
  elif user_option == 'papel':
    if computer_option == 'piedra':
      print('papel gana a piedra')
      print('user gano!')
      user_wins += 1
    else:
      print('Tijera gana a papel')
      print('Computer gano!')
      computer_wins +=1
  elif user_option == 'tijera':
    if computer_option == 'papel':
      print('Tijera gana a papel')
      prin('User gano')
      user_wins +=1
    else:
      print('piedra gana a tijera')
      print('Computer gano!')
      computer_wins +=1
  return user_wins, computer_wins

def check_winner(user_wins, computer_wins):
    if computer_wins == 2:
      print('El ganador es la computadora')
      exit()
    if user_wins == 2:
      print('El ganador es el usuario')
      exit()

def run_game():
  computer_wins = 0
  user_wins = 0
  rounds = 1
  while True:
    print('*' * 10)
    print('ROUND', rounds)
    print('*' * 10)
  
    print('computer_wins', computer_wins)
    print('user_wins', user_wins)
    rounds += 1

    user_option, computer_option = choose_options()
    user_wins, computer_wins = check_rules(user_option, computer_option,user_wins, computer_wins)
    check_winner(user_wins, computer_wins)
run_game()

Sara María Mejia Sánchez

student•

Que buen aporte! 💚

Nelson Ricardo Ramírez García

student•

Muy bien 👍

Javi Ruiz

student•

No me había tocado alguna clase con tantas quejas, recuerden que el inglés es indispensable para crecer en este ámbito (Yo diría que ya es indispensable para cualquier profesión en este mundo globalizado); re-factorizar es necesario para trabajar en cualquier empresa con software existente (se llama dar mantenimiento al código) no siempre se podrá empezar desde cero ya que implica costos elevados y tiempo; adaptarse y eliminar esos sesgos cognitivos que impiden nuestro crecimiento (Si pueden inviertan en su salud mental).

Aquí les dejo un articulo que les puede ayudar. (https://www.psiquion.com/blog/sesgos-cognitivos#:~:text=Los%20sesgos%20cognitivos%20son%20un,hora%20de%20interpretar%20la%20realidad.)

No se desanimen, y piensen positivo (pero no se excedan que también hace daño jajaja)

Rigoberto Maldonado

student•

exacto campeon.

Francisco Garcia [C6]

student•

A mi pareció bien, muy ajustado a la realidad en cuento a lo que corresponde a retomar código y refactorizar.

En muchas ocasiones tenemos que hacer cambios a código que hemos hecho meses atrás y eso es difícil.

Diego Jurado

student•

Y pensaba que en el curso anterior ya habiamos logrado lo máximo cno el juego de piedra papel o tijera

Juan Pablo Veloza Chaves

student•

Esta clase es la primera que no me gustó, es mejor cuando se empieza desde 0 los códigos, hay cosas que uno no recuerda del todo bien y al modificar un código viejo, uno se pierde más ;(

Alejandro López

student•

El 90 % de programar es leer código y pensar durante horas para agregar alguna modificación, es doloroso pero hay que hacerlo.

Eduardo Peña Ramos

student•

Por supuesto que es mejor desde cero: es más claro y fácil de entender. Lástima que en el mundo real toca refactorizar. Ánimo. :D

Angie paola Acuña fonseca

student•

no se podia hacer ese ejemplo desde cero? porque no entendi nada nada, quitar poner modificar asi no entendi

Miguel Angel Reyes Moreno

student•

En el curso anterior se hizo este proyecto, ¿te aseguraste de haberlo tomado? :)

Angie paola Acuña fonseca

student•

este curso y con todo en ingles queda uno loco

SERGIO SAUL ROJAS VELASQUEZ

student•

que está en ingles?

Miguel Angel Reyes Moreno

student•

El código está escrito en inglés porque en el mundo laboral, todo el código lo escribes en este idioma. Es una buena práctica.

Sara María Mejia Sánchez

student•

Todo un reto esto de refactorizar pero ayuda a tener otra perspectiva ✔

Les comparto mi código refactorizado, incluí una validación para que no muestre como Empate las opciones no válidas (que retornan None, None) y la función check_winner

# Refactor game

import random

def choose_options():

  # Creamos una tupla de opciones
  options = ("piedra", "papel", "tijera")

  # Solicitamos la opcion al usuario
  user_option = input("Piedra, Papel o Tijera => ")
  
  # Convertimos a minúscula el texto ingresado por el usuario
  user_option = user_option.lower()
   #print(user_option)
  
  if user_option not in options:
    print(f"La opcion {user_option} no es válida")
    #continue
    return None, None
  
  # Seleccionamos la opción de manera aleatoria
  computer_option = random.choice(options)
  print("computer => ", computer_option)

  # La funcion retorna multiples valores
  return user_option, computer_option

def check_rules(user_option, computer_option, user_wins, computer_wins):
  if user_option == computer_option and (user_option != None and computer_option != None):
    print("Empate!")
  elif user_option == "piedra":
    if computer_option == "tijera":
      print(f"{user_option} gana a {computer_option}. User ganó!")
      user_wins += 1
    else:
      print(f"{computer_option} gana a {user_option}. Computer ganó!")
      computer_wins += 1
  elif user_option == "papel":
    if computer_option == "piedra":
      print(f"{user_option} gana a {computer_option}. User ganó!")
      user_wins += 1
    else:
      print(f"{computer_option} gana a {user_option}. Computer ganó!")
      computer_wins += 1
  elif user_option == "tijera":
    if computer_option == "papel":
      print(f"{user_option} gana a {computer_option}. User ganó!")
      user_wins += 1
    else:
      print(f"{computer_option} gana a {user_option}. Computer ganó!")
      computer_wins += 1
  
  return user_wins, computer_wins

def check_winner(user_wins, computer_wins):
  if computer_wins == 2:
      print("El ganador es la computadora!")
      exit()
  if user_wins == 2:
      print("El ganador es el usuario!")
      exit()

def run_game():
  # Contadores de rondas ganadas
  computer_wins = 0
  user_wins = 0
  # Contador de rondas
  rounds = 1
  
  while True:

    print("*" * 10)
    print("ROUND", rounds)
    print("*" * 10)
  
    print("computer_wins =>", computer_wins)
    print("user_wins =>", user_wins)

    # Incrementamos el contador de rondas
    rounds += 1
  
    # Almacenamos los valores retornados por la funcion
    user_option, computer_option = choose_options()
  
    user_wins, computer_wins = check_rules(user_option, computer_option, user_wins, computer_wins)

    check_winner(user_wins, computer_wins)

run_game()

Emmanuel Reyes Flores

student•

No entendi nada

Omar Gabriel Orjuela Martínez

student•

No te desanimes no entender nada también es parte del proceso. "Divide y vencerás" toma las partes que no entiendes y profundiza mas en ello, es la manera mas eficiente de entender que cosas necesitas reforzar. 🔥