d8bc578055
Se traducen partes de los códigos del ejemplo dados para explicar como comentar en Python
2.2 KiB
title, localeTitle
| title | localeTitle |
|---|---|
| Python Commenting Code | Código de comentarios de Python |
Los comentarios se utilizan para anotar, describir o explicar códigos que son complejos o difíciles de entender. Python ignorará intencionalmente los comentarios cuando compile el bytecode por el intérprete. PEP 8 tiene una sección que trata con los comentarios. También aumentan la legibilidad del código al agregar un lenguaje fácil y descriptivo para una mejor comprensión.
Los comentarios en bloque y en línea comienzan con un # , seguido de un espacio antes del comentario:
# Esto es un bloque de comentarios.
print('Hello world!') # Este un comentario de una sola linea .
Python no incluye una forma formal de escribir comentarios de varias líneas. Cada línea de un comentario que abarca varias líneas debe comenzar con # y un espacio:
# Este es la primer linea de un comentario multinlinea.
# Esta es la segunda linea.
Otro tipo de comentario es el docstring , documentado en PEP 257 . Las cadenas de texto son un tipo específico de comentario que se convierte en el atributo __doc__ .
Para que una cadena literal sea una cadena de documentación, debe comenzar y terminar con \"\"\" y ser la primera declaración del módulo, función, clase o definición de método que está documentando:
class SomeClass():
"""Linea de resumen que explica una clase.
Descripciones más elaborada puede requerir usar un docstring
multilinea.
"""
def method_a(self):
"""Comentario de una linea del method_a."""
pass
Los literales de cadena que comienzan y terminan con """ que no son cadenas de documentación (no la primera instrucción), se pueden usar para cadenas de __doc__ . No se convertirán en atributos __doc__ . Si no están asignados a una variable, no generarán un __doc__ . Hay una discusión sobre su uso como comentarios de varias líneas que se encuentran aquí .