85

Documentación con Docstring en Python [85]

En este tutorial vamos a analizar la documentación con docstring en Python:

La documentación de nuestro software siempre a sido un dolor de cabeza para los desarrolladores pero esto no tiene que ser siempre así (al menos no en python) ya que este lenguaje nos ofrece un mecanismo documentación intrínseco al codigo (osea que la documentación es parte del código).

Python no ofrece la herramienta docstring que se encarga de leer los comentarios que coloquemos en nuestro código (comentarios estratégicamente colocados) y nos retornara esos comentarios como documentación, algunos métodos de docstring encontramos:
__name__
__doc__

Documentación con Docstring en Python

Codigo: https://github.com/programadornovato/curso-python/commit/1d273af4f3f51d335a280d4a0f990675e51dc7bd

def funcionQueHacealgo():
    '''Esta funcion por ahora no hace nada pero va hacer algo muy importante que va a cambiar el mundo'''
    pass
def funcionQueHacealgo2():
    '''Esta otra funcion por ahora no hace nada pero va hacer algo muy importante que va a cambiar el mundo'''
    pass
def funcionQueHacealgo3():
    '''Esta otra funcion por ahora no hace nada pero va hacer algo muy importante que va a cambiar el mundo'''
    pass
'''
print("NOMBRE DE NUESTRA FUNCION:",funcionQueHacealgo2.__name__)
print("DOCUMENTACION DE NUESTRA FUNCION:",funcionQueHacealgo2.__doc__)
'''

https://www.youtube.com/watch?v=GjeXCFbT988&list=PLCTD_CpMeEKRppvi86Dy8CPYZ8-XzN2qu&index=87&t=339s

🎦Curso de Java Netbeans Completo☕ [62.- Documentación automática con java y netbeans]: https://www.youtube.com/watch?v=mT6HL9Wdwjc 🎦[CURSO] PYTHON PARA PRINCIPIANTES🐍: https://www.youtube.com/playlist?list=PLCTD_CpMeEKRppvi86Dy8CPYZ8-XzN2qu

🔗 Gracias por apoyar este canal: https://www.patreon.com/programadornovato
🔗 Facebook: https://facebook.com/ProgramadorNovatoOficial
🔗 Twitter: https://twitter.com/programadornova
🔗 Linkedin: https://www.linkedin.com/in/programadornovato/
🔗 Instagram: https://www.instagram.com/programadornovato/
🔗 Pagina oficial: https://www.programadornovato.com
🎦 Canal de youtube: https://www.youtube.com/c/programadornovato

Siguiente tutorial >>

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Información básica sobre protección de datos Ver más

  • Responsable: Eugenio Chaparro.
  • Finalidad:  Moderar los comentarios.
  • Legitimación:  Por consentimiento del interesado.
  • Destinatarios y encargados de tratamiento:  No se ceden o comunican datos a terceros para prestar este servicio. El Titular ha contratado los servicios de alojamiento web a digitalocean.com que actúa como encargado de tratamiento.
  • Derechos: Acceder, rectificar y suprimir los datos.
  • Información Adicional: Puede consultar la información detallada en la Política de Privacidad.

Esta web utiliza cookies propias y de terceros para su correcto funcionamiento y para fines analíticos y para mostrarte publicidad relacionada con sus preferencias en base a un perfil elaborado a partir de tus hábitos de navegación. Contiene enlaces a sitios web de terceros con políticas de privacidad ajenas que podrás aceptar o no cuando accedas a ellos. Al hacer clic en el botón Aceptar, acepta el uso de estas tecnologías y el procesamiento de tus datos para estos propósitos. Más información
Privacidad