Una buena documentación puede hacer la diferencia entre un programador bueno y uno malo, pues es la manera de dejar "notas " en tu código para que otra persona pueda entender el objetivo del mismo
Primeros pasos con Python
¿Por qué aprender Python?
Herramientas del curso
Tu primer programa
Playgrounds: Te doy la bienvenida a los ejercicios interactivos
Variables
Playgrounds: Modifica el valor de una variable
Tipos de datos en Python
Tipos de datos
Strings
Numbers
Booleans
Transformación de tipos
Playgrounds: Imprime el formato adecuado
Operadores y condicionales
Operadores aritméticos
Operadores de comparación
Comparación de números flotantes
Operadores lógicos: and y or
Operador lógico not
Condicionales
Proyecto: condicionales
Playgrounds: Identifica si un número es par o impar
Listas y diccionarios
String recargado
Indexing y slicing
Listas
Métodos de listas
Playgrounds: Agrega, modifica y elimina elementos de una lista
Tuplas
Proyecto: tuplas
Diccionarios: definición y lectura
Diccionarios: inserción y actualización
Playgrounds: Agrega, modifica y elimina elementos de un diccionario
Ciclos
Loops: While
Loops: For
Playgrounds: Agrega solo los números positivos de una lista
Ciclos anidados
¡Es tu turno: crea un tutorial!
Cierre
¡Conoce otros proyectos de este curso!
Proyecto: aplicando ciclos
No tienes acceso a esta clase
¡Continúa aprendiendo! Únete y comienza a potenciar tu carrera
Aportes 111
Preguntas 18
Una buena documentación puede hacer la diferencia entre un programador bueno y uno malo, pues es la manera de dejar "notas " en tu código para que otra persona pueda entender el objetivo del mismo
Dato rápido: si quieres comentar varias líneas solo selecciónalas y luego presiona ctrl + / y para des comentarla hacen el mismo proceso. :]
Hasta aquí mi reporte Joaquin.
Pequeño tip: Pueden ejecutar el código con el siguiente atajo de teclado: Ctrl + Enter
colegas les recomiendo que averigüen lo siguiente
un forma de documentar una funcion compleja es la siguiente:
""" definición : que hace la funcion
parámetros : los parámetros que usa y si ve necesario el tipo de cada parámetro
return : se indica si devuelve algo ya sea un valor,una lista , una tupla, diccionario etc."""
Un ejemplo puede de la documentación de una función
podría ser :
def funcionSuma (a,b):
"""
target : suma dos valores a,b y guarada el valor en c
parámetros ; a -> float ,b- > float
return : c -> resultado de la suma
"""
c= a+b
return c
espero que les sirva
Dentro del entorno encontraremos los archivos con la extensión .py en donde se encuentra nuestro codigo de Python a ejecutar y también encontraremos 2 archivos: poetry.lock y pyproject.toml, en los cuales se encuentran las dependencias del proyecto.
En la consola se mostrará la salida o resultado de nuestro programa.
Para imprimir utilizamos el comando print:
print(“Hola mundo!”)
print(2+20)
print(50-10)
print(3*2)
print(10/5)
Para agregar comentarios que permiten documentar nuestro programa podemos hacerlos de 2 formas:
# Este es una operación matemática
“”” comentario mas
Largo ”””
''' Otro comentario
largo'''
Mi contribución, espero les ayude.
En la pestañita de shell se puede ejecutar también el archivo
ejecutando en la terminal
python3 main.py
En sus marcas!! jaja
Cuando deseen que un parrafo quede comentado, pueden usar el short cut
ctrl + }
print("Hello there")
print("Another world")
""" Super comment """
'''ANother super comment'''
# One line comment
a = 100
b = 52
print("Just some calculations:")
print("""Given these values
a = 100
b = 52
""")
print("+", a + b)
print("-", a - b)
print("*", a * b)
print("/", a / b)
Aquí hay algunos consejos para alguien que está aprendiendo a programar con Python:
¡Ya se que es de ChatGPT! pero me estos conejos me estan ayudando mucho y espero que también te ayuden.
Otra operación muy interesante que podemos agregar a las operaciones básicas es la potenciación, la cual la podemos representar de la siguiente forma;
print(4 ** 2)
16
👩🏻💻 En shell si ponemos python + solo del numero + tab ⌨️ , se autocompleta el nombre y no será necesario escribirlo todo. Tip muy dummie pero a mi me ha funcionado y me ahorra tiempo a la hora de ejecutar.
Es nuevo este curso o me equivoco y con este maestro tan bueno 😃
Hola. les dejo mis apuntes de la clase
Gracias profesor muy bien comienzo de programa, solo como sugerencia considero que falto enseñar a guardar el archivo dentro de replit para que se valla teniendo un orden dentro de los procesos de aprendizaje del curso.
Hoja de trucos para principiantes de Python: 19 palabras clave que todo programador debe conocer
Download
una alternativa al tipico formato print("me llamo " + nombre + “.”) es usar String Formateado, agregando una ´f´ antes de las comillas, puede ser más comodo y legible.
Ejemplo Maconidano (ejemplo con string pero se puede hacer con valores numericos y otros datos):
lugar = "frente al pelotón de fusilamiento"
nombre_coronel = "Aureliano Buendía"
cosa_en_feria = “el hielo”
primera_frase = (
f"Muchos años después, {lugar}, "
f"el coronel {nombre_coronel} había de recordar aquella tarde remota “
f"en que su padre lo llevó a conocer {cosa_en_feria}.”
)
print(primera_frase)
Tip cómo programador, si quieren escribir o borrar lo mismo en varias lineas pueden oprimir alt+click en la linea que quieran modificar
if __name__ == "__main__":
run()
En extremo decepcionado de que el primer print no haya sido (“Hola mundo”)
“”“
varias líneas
de
comentario
”""
yo creo que es bueno desde un inicio comenzar a acostumbrarnos a comentar que ya sea como lavarnos los dientes
Lastimosamente en algunas empresas no aceptan que se hagan comentarios en el código, de manera tal que cuando tienes que revisar el código de alguien más casí que tienes que empezar a adivinar qué está haciendo y para qué es esta linea
No dejen de comentar muchachos, piensen en el projimo!
En el curso de lógica dijeron que es mejor borrar los comentarios jajaj no se la profe por dice eso más si estamos aprendiendo.
Tal vez para una entrega final dejarle los mínimos comentarios más por temas de bytes.
Aporte:
Extensión Python: .py
Cuidado con la identacion: No puede existir un espacio antes del comando.
print: Imprimir algo en la consola, texto, o realización de operaciones matemáticas.
# Comentario, no se muestra en consola, sirve para documentar nuestro codigo.
""" o ‘’’: Comentarios de varias líneas
wow uno de los mejores cursos sin duda platzi es mi lugar seguro amo aqui
Este programa esta muy interesante super
Los comentarios son cartas para uno mismo en el futuro. 😶🌫️
print(“Eesta es la Suma de 12 + 5 =”,12+5)
print(“Esta es la Resta de 10 - 5 =”,10-5)
print(“Esta es la Multiplicación de 2 * 3 =”,2*3)
print(“Esta es la Division de 2 / 3 =”,8/2)
La coma realiza la separación de los caculos dentro de un solo campo y mostrar dos mensajes
muy emocionado por el curso!
Por si alguno desea comentar varias lineas de manera simultánea puede hacer seleccionando las lineas y posteriormente presionando ‘Ctrl + Ç’ .
“”“
print(12+5) #Suma
”""
Excelente ejemplos de comentarios
Lo único malo de replit es que su memoria se llena muy rápido en las ejecuciones y pide comprar el plan.
12+5 es 17, en este caso y en todos los casos.
Excelente clase!
si yo realizo una division como 10 / 2 me da 5.0 en python toda division asi de un numero entero el type del resultado es un double pero con 10 // 2 --> 5 asi puedo sacar solo el entero.
En Python no se usa indentación
print("Hola esto es python") #La función print() sirve para mostrar un mensaje en la pantalla. La función print() recibe como argumento una cadena de texto, que es una secuencia de caracteres entre comillas
print(“Hola esto es python”)
#La función print() sirve para mostrar un mensaje en la pantalla. La función print() recibe como argumento una cadena de texto, que es una secuencia de caracteres entre comillas
Soy un ingeniero de empaque tratando de aprender a programar. Deséenme suerte, en este camino de aprendizaje en una nueva herramienta.
muchas veces una buena declaracion de variables y un buen uso de controles de flujo puede ser mejor que comentarios, hay cometarios que pueden llegar a ser innesesarios si el codigo es lo suficientemente claro en lo que hace ^ ^
Comentarios con Python
#comentario una sola linea
" " " Comentario de
varias lineas de codigo " " "
’ ’ 'Comentario de
varias lineas de codigo ’ ’ ’
me gusta esta herramienta
Cada vez más hacker
# Soy un comentario de una linea
print("El problema de los 3 cuerpos")
"""
Soy un comentario de varias lineas.
Podemos comentar varias lineas a la vez.
Su uso principal es la documentación del programa.
"""
Aunque me confunde el color de los comentarios de una solo y la de varias lineas, aunque supongo que va a depender del ide o del editor de texto que estemos usando.
Primer programa
Los comentarios que se dejan (documentación) son para dejar notas y hacer la documentación del programa, dejando anotaciones que nos dicen para que sirve la función o que hace el programa que estas realizando.
Es importante ser muy explícitos en cuanto a la documentación sobre los bloques de código haciendo una descripción de todo lo que hace sin dar información seguridad importante, dejando también explicado el que hace sino el porque lo hace.
Los comentarios que se dejan (documentación) son para dejar notas y hacer la documentación del programa, dejando anotaciones que nos dicen para que sirve la función o que hace el programa que estas realizando. Es importante ser muy explícitos en cuanto a la documentación sobre los bloques de código haciendo una descripción de todo lo que hace sin dar información seguridad importante, dejando también explicado el que hace sino el porque lo hace.
Buenas tardes,
no conocia replit y me parece fantastico para las personas que estan conociendo del tema o quizas los que ya saben, yo utilizo Jupiter Notebook. 😃
se fue el hola mundo :C ajajaj
Python es un lenguaje muy facil de escribir y de entender
Si usan VS CODE para comentar una linea (en la que tengan en el cursor) o para comentar multiples lineas (una selección previa) pueden utilizar
“Ctrl” + “/” (Windows 10, Windows 11)
“Cmnd” + “/” (Mac Os X, Big Sur, Ventura, Sonoma)
En mi ejercicio profesional con shell script, mi equipo tiene por regla evitar los comentarios, pues en general no aportan más información, en cambio se prefiere una programación más clara y bien estructurada.
print("Hola,esto es python")
print("Hola,Soy Angelo y tengo 15 años")
#Operaciones Matematicas
print(12 + 5)
print(10 - 5)
print(2 * 3)
print(8 / 2)
# Esto es un comentario
"""
Varias
Lineas
"""
'''
Varias
Lineas
'''
print(“Hola, esto es python”)
print(“Hola estoy curiosa”)
‘’‘Estos son las operaciones aritmeticas’’’
print(9+9)
print(10-5)
print(7*8)
print(300/30)
#Asi se escriben los comentarios
Explica muy bien.
.
print(“excelente”)
Muy buen curso
Una buena observación a respecto de las indentaciones xD cuantas veces he tenido frustraciones con eso.
Excelente
print (" hola mundo ")
print (" hola soy camilo y tengo: 22 años");
print ( 12 + 5 )
print ( 10 - 5 )
print ( 2 * 3 )
print ( 8 / 2 )
“”“
para
comentarios
largos
”""
Acabo de crear un tema para replit, ahi iles dejo el enlace, es modo oscuro asi no cansara la vista
entonces en cada proyecto debo hacer comentarios , por buena practica , para orientacion con mis colaboradores
<print("Python is Awesome!!")>
Les comparto un artículo sobre el uso de comillas dobles o simples para los texto en Python: https://recursospython.com/guias-y-manuales/comillas-dobles-o-simples/
Whooouu! Mi primer programa en Python
prendí que python puede hacer operaciones matemàticas y el uso de comentarios (usar preferentementwe ’ en lugar de " )
Los comentarios son a mi código lo que los mensajes en los commits son a mi historia de Git (?)
Excelente, no sabia lo de las triple comillas.
print(“esto es python”,“hola soy alberto”,“tengo”, 12+24)
print(“la suma de 12+12 es”,12+12)
Otra opcion para anadir comentarios en tu codigo es utilizando tres comillas (simple o dobles) en vez de usar el numeral.
Buena clase. Lastimosamente Replit me corre muy lento. Cuando ejecuto el código se congela, se queda conectando y trabajando y solo después de un tiempo me muestra el out en la consola.
Una de la primera sintaxis que usamos es la función print que sirve para mostrar por terminal información
print("Hola, esto es phython")
print("Hola, soy Angel Quintero")
print(12+5)
Para realizar comentarios existen tres formas:
Me salve spyder funciona, voy a utilizarlo por ahora hasta que deba cambiarlo la interfaz es bastante parecida y se encuentra en el centro de software de ubuntu, voy a revisar geany a ver si también resulta adecuado.
Esto me recuerda a cuando hacia analisis numérico en scilab.
Dentro de la interfaz de VS se pueden personalizar los atajos
Por ejemplo yo modifique el de ejecutar codigo y cerrar la terminal activa
usando los comandos
ctrl + Enter = Ejecutar
Ctrl + Backspace = cerrar terminales
Los comentarios en programación son anotaciones que se incluyen en el código fuente de un programa con el propósito de proporcionar una explicación o contexto adicional sobre lo que el código está haciendo. Los comentarios son ignorados por el compilador o intérprete de código y no tienen ningún impacto en la ejecución del programa.
Hay varias razones por las que es importante utilizar comentarios en la programación:
<# Esta función toma dos números como argumentos y devuelve su suma
def sumar(a, b):
# Calculamos la suma de a y b
resultado = a + b
# Devolvemos el resultado
return resultado
>
En este ejemplo, hemos utilizado dos comentarios. El primer comentario proporciona una descripción general de la función y el segundo comentario explica lo que hace la línea de código debajo de él.
Si no pueden comentar con varias líneas de código seleccionadas con ctrl + / pueden ocupar Alt + Shift + A
es muy bueno dejar notas con comentarios para cuando trabajamos con otras personas
Me agrada que el curso use replit, esta plataforma es muy intuitiva y completa
Pueden observar mis apuntes de este curso aquí
La identación te permite tener el código organizado y ver de manera más clara algún error.
print(“hola, esto es python”)
print(“hola, soy rolando juan”)
print(10 + 10)
print(10 - 9)
print(10 * 10)
print(10 / 5)
“”“
esto es un comentario
de varias
lineas
”""
‘’‘
esto tambien es un comentario
de varias
lineas
’’’
Cuando señalas todas las líneas que quieres comentar y utilizas las teclas control + } comentaras todo lo que señalaste.
print("Hola esto es python")
print("Hola soy Alexander Jaramillo y tengo 27 años")
b = 5
c = 3
a = b + c
print(a)
print(45 * 850)
print(b / c)
#This is a comment
"""This is a
Super comment
"""
Que amigable es lenguaje con las operaciones básicas!
Hpta que chimba, holaaa mundo !! aqui les voy !
Para obtener información mas detallada sobre alguna función o clase, pueden usar la función “help”.
Ex:
"""
Imprimir definición y parametros que acepta la función 'print'
"""
help("print")
¿Quieres ver más aportes, preguntas y respuestas de la comunidad?
o inicia sesión.