Tutorial 0 - ¡Preparémonos!

Antes de crear nuestra primera aplicación BeeWare, tenemos que asegurarnos de que tenemos todos los requisitos previos para ejecutar BeeWare.

Instalar Python

Lo primero que necesitaremos es un intérprete de Python que funcione.

Si utilizas macOS, con Xcode o las herramientas de desarrollo de línea de comandos se incluye una versión reciente de Python. Para comprobar si ya la tienes, ejecuta el siguiente comando:

$ python3 --version

Si Python está instalado, verás su número de versión. Si no, se te pedirá que instales las herramientas de desarrollo de la línea de comandos.

Si estás en Windows, puedes obtener el instalador oficial desde the Python website. Puedes usar cualquier versión estable de Python desde la 3.8 en adelante. Te aconsejamos que evites las versiones alphas, betas y release candidates a menos que realmente sepas lo que estás haciendo.

Distribuciones alternativas de Python

Hay muchas formas diferentes de instalar Python. Puedes instalar Python a través de homebrew. Puedes usar pyenv para gestionar múltiples instalaciones de Python en la misma máquina. Los usuarios de Windows pueden instalar Python desde la Windows App Store. Los usuarios con experiencia en ciencia de datos pueden utilizar Anaconda o Miniconda.

Si usas macOS o Windows, no importa cómo has instalado Python - sólo importa que puedas ejecutar python3 desde el símbolo del sistema/terminal de tu sistema operativo, y obtener un intérprete de Python que funcione.

Si usas Linux, deberías usar el Python de sistema proporcionado por tu sistema operativo. Podrás completar la mayor parte de este tutorial usando un Python que no sea de sistema, pero no podrás empaquetar tu aplicación para distribuirla a otros.

Instalar dependencias

A continuación, instale las dependencias adicionales necesarias para su sistema operativo:

Construir aplicaciones BeeWare en macOS requiere:

  • Git, un sistema de control de versiones. Esto se incluye con Xcode o las herramientas de línea de comandos para desarrolladores, que instaló anteriormente.

Crear un entorno virtual

Ahora vamos a crear un entorno virtual - una «caja de arena» que podemos utilizar para aislar nuestro trabajo en este tutorial de nuestra instalación principal de Python. Si instalamos paquetes en el entorno virtual, nuestra instalación principal de Python (y cualquier otro proyecto Python en nuestro ordenador) no se verá afectado. Si hacemos un completo desastre de nuestro entorno virtual, podremos simplemente borrarlo y empezar de nuevo, sin afectar a ningún otro proyecto Python en nuestro ordenador, y sin necesidad de reinstalar Python.

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

Si esto ha funcionado, tu prompt debería haber cambiado - debería tener un prefijo (beeware-venv). Esto te permite saber que estás actualmente en tu entorno virtual BeeWare. Siempre que estés trabajando en este tutorial, debes asegurarte de que tu entorno virtual está activado. Si no lo está, vuelve a ejecutar el último comando (el comando activate) para reactivar tu entorno.

Entornos virtuales alternativos

Si estás usando Anaconda o miniconda, puede que estés más familiarizado con el uso de entornos conda. También puedes haber oído hablar de virtualenv, un predecesor del módulo venv de Python. Al igual que con las instalaciones de Python - si estás en macOS o Windows, no importa cómo creas tu entorno virtual, siempre y cuando tengas uno. Si estás en Linux, deberías usar venv y el sistema Python.

Siguientes pasos

Ya hemos configurado nuestro entorno. Estamos listos para crear nuestra primera aplicación BeeWare.