Comprensión de Instrucciones, Sangría y Comentarios en Python

Este tutorial proporciona una comprensión fundamental de las sentencias, la sangría y los comentarios en Python, elementos cruciales para escribir código limpio, eficiente y mantenible.

Tabla de contenido

1. Sentencias Python
2. Sangría en Python
3. Comentarios en Python

Sentencias Python

En Python, una sentencia es una única instrucción ejecutada por el intérprete. Si bien normalmente ocupa una sola línea, las sentencias largas pueden abarcar varias líneas utilizando la continuación de línea (barra invertida o paréntesis ()). Las sentencias abarcan asignaciones, llamadas a funciones, bucles y sentencias condicionales.

Ejemplos:

• Asignación: x = 10 (asigna 10 a x)
• Llamada a función: print("¡Hola!")
• Sentencia condicional:

  
  if x > 5:
      print("x es mayor que 5")
  else:
      print("x no es mayor que 5")
  

• Sentencia de bucle:

  
  for i in range(5):
      print(i)
  

Sangría en Python

A diferencia de los lenguajes que utilizan llaves {} para definir bloques de código, Python utiliza la sangría. Esto determina la agrupación de sentencias dentro de bloques (if, else, for, while, funciones, clases). La sangría consistente es obligatoria; las inconsistencias causan un IndentationError.

Sangría correcta:

if x > 5:
    print("x es mayor que 5")
    y = x * 2
else:
    print("x no es mayor que 5")

Sangría incorrecta:

if x > 5:
print("x es mayor que 5")  # IndentationError
y = x * 2
else:
print("x no es mayor que 5") # IndentationError

Utilice 4 espacios para la sangría; evite las tabulaciones.

Comentarios en Python

Los comentarios son notas explicativas ignoradas por el intérprete. Mejoran la legibilidad y la comprensión del código. Python ofrece dos tipos:

• Comentarios de una sola línea: Comienzan con #. Todo lo que sigue a # en la misma línea es un comentario.
• Comentarios multilínea (docstrings): Encerrados entre comillas triples (''' o """). Se utilizan con frecuencia para documentar funciones, clases y módulos.

Ejemplos:

x = 10  # Comentario de una sola línea

'''
Este es un
comentario multilínea.
'''

def mi_funcion():
    """Este es un docstring."""
    pass

La escritura eficaz de comentarios es crucial para un código limpio y mantenible. Mantenga los comentarios concisos y relevantes; evite explicaciones redundantes.