Para poder contribuir, necesitarás configurar un entorno de desarrollo - un lugar donde se puede trabajar en el código donde puede comportarse igual que el entorno de los demás.
Muchas partes de BeeWare utilizan las mismas herramientas: una versión específica de Python, y controles de entorno virtual.
Python
Python es un lenguaje de scripting que está disponible en varios sistemas operativos. diferentes sistemas operativos. Sin embargo, dependiendo del sistema que la versión de Python será diferente. Por esta especificamos exactamente con qué versión de Python esperamos que funcione el código. funcione.
Para las siguientes instrucciones, vamos a asumir que usted sabe
exactamente qué versión de Python necesitas instalar. Normalmente
en el archivo README.md o en la información del tutorial. Nuestro
sistemas CI tienen que saber
exactamente qué versión de Python se requiere, también. Así que si usted está realmente
atascado, intenta mirar en el archivo .github/workflows/ci.yml para la
versión específica que necesitas.
Para contribuir a BeeWare, necesitará tener un intérprete de Python instalado en tu máquina. En macOS y Windows, recomendamos recomendamos usar el instalador oficial de Python.org installers; en Linux, recomendamos utilizar la versión de Python proporcionada por el gestor de paquetes de su distribución.
Entornos virtuales
Cuando se instala Python, proporciona un único entorno global. En paquete, se instalará en este entorno global. global.
Sin embargo, si estás trabajando en más de un proyecto Python, es totalmente probable que esos múltiples proyectos tengan diferentes - y y, en algunos casos, contradictorios. Lo que necesitas es una forma de aislar cada proyecto para que la instalación de un paquete para un proyecto no no obligue a instalar el mismo paquete en el segundo proyecto.
Para ello se utilizan Entornos Virtuales. Un Entorno Virtual, o
venv, es un entorno aislado que puede ser fácilmente creado, destruido
o recreado. Cualquier paquete instalado en el entorno virtual sólo es
accesible dentro de ese entorno virtual. Los entornos virtuales
una "caja de arena" - un lugar seguro para jugar, donde si cometes un
error, puedes derribar todo lo que has construido y empezar de nuevo.
y empezar de nuevo.
Python proporciona el módulo venv para crear nuevos entornos virtuales.
Cada entorno virtual tiene un nombre que se puede utilizar para identificar el
entorno. Para crear un nuevo entorno virtual llamado "my-venv", ejecute:
$ python -m venv mi-venv
La versión de Python que utilices para crear el entorno virtual
será la versión que se use por defecto dentro del entorno virtual.
virtual. Si tienes varias versiones de Python instaladas, o estás usando una herramienta como
herramienta como pyenv para gestionar las versiones de Python, asegúrese de que la versión de
versión de Python actualmente activa (o la versión a la que hace referencia
cuando invoques el comando -m venv) es la versión que pretendes. Una vez creado un
virtual ha sido creado, no puedes cambiar la versión de Python
que está utilizando. Para cambiar la versión de Python, necesitas
crear un nuevo entorno virtual.
Invocando -m venv se creará el entorno virtual, pero el
entorno aún no está activo. El entorno virtual es una colección
de archivos en disco, almacenados en un directorio que coincide con el nombre del
entorno. Para activar el entorno virtual, ejecute uno de los archivos
generados como parte del entorno:
$ source mi-venv/bin/activar
Esto hará que se añada un prefijo a su línea de comandos para que sepas que estás en un entorno virtual:
$
Mientras el entorno virtual esté activo, cualquier comando `pip install sólo afectará al entorno virtual. No importa si cambia directorios - si su prompt tiene un prefijo, ese entorno virtual está activo.
Si abre una segunda ventana de terminal, el entorno no estará activo. activo - tendrá que volver a activar el entorno en cada sesión sesión de terminal en la que desee utilizar el entorno. Si obtiene errores sobre librerías no disponibles que está seguro de haber instalado... comprueba si tu entorno virtual está activo.
Para desactivar el entorno virtual, ejecute:
(mi-venv) $ desactivar
Una vez desactivado, el prefijo desaparecerá de la consulta.