Configuración de un entorno de desarrollo¶
Contribuir a BeeWare requiere que configures un entorno de desarrollo.
Requisitos previos¶
Necesitarás instalar los siguientes requisitos previos.
{{ nombre_formal }} requiere Python 3.10+. También
necesitarás un método para gestionar entornos virtuales (como venv).
Puede verificar la versión de Python que tiene instalada ejecutando:
$ python3 --version
Si tiene más de una versión de Python instalada, es posible que tenga que
sustituir python3 por un número de versión específico (por ejemplo,
python{{ versión_python_reciente }}).
Recomendamos evitar las versiones recientes de Python (es decir, las versiones que tienen un micro número de versión ".0" o ".1", como por ejemplo, 3.14.0). Esto se debe a que las herramientas necesarias para soportar Python en macOS a menudo no están disponibles para las versiones estables de Python publicadas recientemente.
{{ nombre_formal }} requiere Python 3.10+. También
necesitarás un método para gestionar entornos virtuales (como venv).
Puede verificar la versión de Python que tiene instalada ejecutando:
$ python3 --version
Si tiene más de una versión de Python instalada, es posible que tenga que
sustituir python3 por un número de versión específico (por ejemplo,
python{{ versión_python_reciente }}).
Recomendamos evitar las versiones recientes de Python (es decir, las versiones que tienen un micro número de versión ".0" o ".1", como por ejemplo, 3.14.0). Esto se debe a que las herramientas necesarias para soportar Python en Linux a menudo no están disponibles para las versiones estables de Python recientemente publicadas.
{{ nombre_formal }} requiere Python 3.10+. También
necesitarás un método para gestionar entornos virtuales (como venv).
Puede verificar la versión de Python que tiene instalada ejecutando:
C:\...>py -3 --version
Si tiene más de una versión de Python instalada, puede que necesite sustituir
-3 por un número de versión específico (por ejemplo, -python3.13).
Recomendamos evitar las versiones recientes de Python (es decir, las versiones que tienen un micro número de versión ".0" o ".1", como por ejemplo, 3.14.0). Esto se debe a que las herramientas necesarias para soportar Python en Windows a menudo no están disponibles para las versiones estables de Python recientemente publicadas.
Configure su entorno de desarrollo¶
La forma recomendada de configurar tu entorno de desarrollo para BeeWare es utilizar un entorno virtual, y luego instalar la versión de desarrollo de BeeWare y sus dependencias.
Clonar el repositorio BeeWare¶
A continuación, ve a la página BeeWare de GitHub y, si aún no lo has hecho, bifurca el repositorio en tu propia cuenta. A continuación, haz clic en el botón "<> Code" de tu bifurcación. Si tienes la aplicación de escritorio de GitHub instalada en tu ordenador, puedes seleccionar "Abrir con GitHub Desktop"; si no, copia la URL HTTPS proporcionada, y utilízala para clonar el repositorio en tu ordenador utilizando la línea de comandos:
Fork el repositorio BeeWare, y luego:
$ git clone https://github.com/<your username>/beeware.git
(sustituyendo tu nombre de usuario de GitHub)
Fork el repositorio BeeWare, y luego:
$ git clone https://github.com/<your username>/beeware.git
(sustituyendo tu nombre de usuario de GitHub)
Fork el repositorio BeeWare, y luego:
C:\...>git clone https://github.com/<your username>/beeware.git
(sustituyendo tu nombre de usuario de GitHub)
Crear un entorno virtual¶
Para configurar un entorno virtual y actualizar pip, ejecute:
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
Tu prompt debería tener ahora un prefijo (.venv) delante.
Instalar BeeWare¶
Ahora que tienes el código fuente, puedes hacer una instalación editable de {{ nombre_formal }} en tu entorno de desarrollo. Ejecute el siguiente comando:
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
Activar precommit¶
BeeWare utiliza una herramienta llamada pre-commit para identificar problemas simples y estandarizar el formato del código. Para ello, instala un hook git que ejecuta automáticamente una serie de linters de código antes de finalizar cualquier commit git. Para activar pre-commit, ejecuta:
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
¡Ahora estás listo para empezar a hackear BeeWare!