Preparación antes de empezar

Date: 1 de noviembre de 2021

El Zen de Python

Active Recall

Notes:

Estos son los 20 principios de software más importantes que tiene este lenguaje de programación para poder escribir nuestra líneas de código de manera correcta y precisa. Estos principios fueron creados en 1999 por Tim Petters.

Podemos visualizar el Zen de Python dentro de su venta interactiva. Dentro de ella debemos colocar:

import this 

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/96dffbb2-8bae-4050-8f10-419a2735e8ef/Untitled.png

  1. Bello es mejor que feo. Si escribimos código es mejor que sea de forma limpia y estética.
  2. Explícito es mejor que implícito. Siempre que podamos expandirnos un poco más en nuestro código para que otras personas nos entiendan es mejor.
  3. Simple es mejor que complejo. Es mejor tener código más corto y entendible. Pero si tenemos que extendernos para que nuestro código se entienda no hay problema.
  4. Plano es mejor que anidado. Cada que tenemos un bloque de código hijo hay una indentación que se puede ampliar mucho.
  5. Espaciado es mejor que denso. Python nos obliga a tener una indentación obligatoria de 4 espacios.
  6. La legibilidad es importante. Que nosotros y otras personas puedan entender el código es fundamental.
  7. Los casos especiales no son lo suficientemente especiales como para romper las reglas.
  8. Sin embargo la practicidad le gana a la pureza. Siempre que podamos respetar las reglas estéticas de Python es mejor que lo hagamos así, pero si estamos luchando mucho por hacerlo y se rompe la legibilidad del código es mejor ir por la zona de la legibilidad de nuestro código.
  9. Los errores nunca deberían pasar silenciosamente.
  10. A menos que se silencien explícitamente. Los errores siempre van a aparecer, pero podemos elegir ignorarlo nosotros por voluntad propia o no.
  11. Frente a la ambigüedad, evitar la tentación de adivinar. Nuestro código debería tener solo una interpretación.
  12. debería haber una, y preferiblemente solo una manera obvia de hacerlo.
  13. A pesar de que esa manera no sea obvia a menos que seas holandés.
  14. Ahora es mejor que nunca.
  15. A pesar de que nunca es muchas veces mejor que "ahora" mismo.
  16. Si la implementación es difícil de explicar, es una mala idea.
  17. Si la implementación es fácil de explicar, puede que sea una buena idea. Debemos poder explicar nuestros conceptos de forma clara.
  18. Los espacios de nombres son una gran idea, ¡Tengamos más de esos!

<aside> 📌 SUMMARY: para usar Python su creador implemento 20 principios que nos ayudan a escribir código de forma correcta y precisa, ha estos principios se los conoce como el Zen de Python. Fueron escritos por Tim Petters en 1999 y vienen de forma nativa dentro del lenguaje de programación de Python, para acceder a ellos usamos desde consola import this.

</aside>

<aside> ☝ ACTIONS NEEDED: entrar a consola y escribir import this para visualizar el Zen de Python dentro de Python.

</aside>


Date: 1 de noviembre de 2021

¿Qué es la documentación?

Active Recall

Notes:

Cuando hablamos de lenguajes de programación y tecnologías en general para hacer desarrollo de software, la documentación es esa pequeña pieza de información que nos explica cómo funciona ese determinado lenguaje o tecnología.

Para poder acceder a la documentación de Python debemos entrar a:

3.9.5 Documentation

Referencia de la biblioteca y del lenguaje: nos muestra de forma detallada lo más técnico que existe dentro de Python (funciones internas).

Índice PEP: son las propuestas de mejoras de Python y son los documentos que conforman a toda la guía de estilos del lenguaje, es decir, son los que nos dicen a nostros cómo el lenguaje funciona y cómo deberíamos de escribirlo de manera correcta. El más importante es el PEP 8:

PEP 8 -- Style Guide for Python Code

La información está puesta de forma muy técnica y en ocasiones puede ser muy abrumadora, pero hay muy buena información.

<aside> 📌 SUMMARY: algo muy importante que nos permite distinguirnos de los programadores novatos y los más avanzados, es comenzar a leer la documentación de Python. Esta es cómo un manual de funcionamiento del lenguaje que nos indica todo sobre Python. Para acceder a el podemos ingresar a la página web de Python y dirigirnos a la sección docs. Un índice PEP muy importante dentro de Python es el PEP 8 ya que aquí se nos explica la forma correcta de escribir código dentro de Python.

</aside>

<aside> ☝ ACTIONS NEEDED: leer el PEP8.

</aside>


Entorno virtual

Date:

¿Qué es un entorno virtual?

Active Recall

Notes:

Para entender que es un entrono virtual, es importante recordar los módulos. Los módulos son trozos de código creado por otras personas que nos sirven para no tener que escribir código, un buen ejemplo es el módulo random.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6e3d9278-82bd-4c39-b7ec-ca6559f454f4/Untitled.png

Cuándo estamos trabajando dentro de python con nuestro proyectos, todos ellos están corriendo dentro de nuestro computador con el mismo sistema. Algo importante al usar módulos es saber que estos se pueden ir actualizando con el paso del tiempo y si se actualizan y nuestro módulo ya no tiene el mismo funcionamiento los proyectos que hayamos hecho con esos módulos dejaran de funcionar adecuadamente.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2ae00437-06ee-417c-9ffc-e9deac0b34bd/Untitled.png

Para resolver estos problemas usamos los entornos virtuales, con ellos lo que hacemos es poner un Python para cada uno de los proyectos. Es cómo si lo clonáramos de forma independiente para cada uno de los proyectos. Esto nos permite elegir en que proyecto queremos actualizar Python y sus módulos.

<aside> 💻 En ese sentido un entrono virtual es un Python aislado para un solo proyecto que tiene sus propios módulos y que esta pensado para funcionar solo con ese proyecto.

</aside>