pypas

Si damos por buena aquella frase de «A programar se aprende programando», sería muy útil disponer de «problemas» a los que encontrar una solución mediante código. Pues este proyecto viene a dar respuesta a este escenario.

pypas te ofrece cientos de ejercicios con los que podrás practicar tu lenguaje de programación favorito Python.

Este paquete proporciona una herramienta en línea de comandos llamada pypas mediante la cual podrás interactuar con los ejercicios.

Instalación

Hay varias formas de instalar el paquete pypas-cli:

uv

Una vez que tengas uv instalado, abre una terminal y ejecuta el siguiente comando:

uv tool install -n -p 3.13 pypas-cli

pip

Una vez que tengas python instalado, abre una terminal y ejecuta el siguiente comando:

python -m pip install pypas-cli

pipx

Una vez que tengas pipx instalado, abre una terminal y ejecuta el siguiente comando:

pipx install pypas-cli

Actualización

Es fundamental que tengas instalada la última versión disponible de pypas-cli, para evitar fallos y disponer de las mejoras implementadas.

Para actualizar a la última versión de pypas-cli puedes usar la propia herramienta (self-upgrading):

pypas upgrade

Listar los ejercicios

Para listar todos los ejercicios «públicos» basta con ejecutar el siguiente comando:

pypas list

Filtros

Es posible aplicar distintos filtros para refinar el listado de ejercicios:

• Filtrar por tema principal (primary topic):

  pip list -p <topic>

• Filtrar por tema secundario (secondary topic):

  pip list -s <topic>

• Filtrar por frame (secondary topic):

  pip list -f <topic>

Obtener un ejercicio

Cada ejercicio dispone de un slug que lo identifica (nombre único).

Supongamos que queremos trabajar en el ejercicio add. Para obtenerlo escribimos el siguiente comando:

pypas get add

El comando anterior creará una carpeta add con los siguientes directorios y ficheros:

.
├── docs
│   └── README.pdf
├── main.py
├── tests
│   ├── __init__.py
│   └── test_main.py
└── vendor.py

Es posible que esta estructura cambie ligeramente, en función de las características del ejercicio.

Enunciado de un ejercicio

Una vez dentro de la carpeta del ejercicio, podemos visualizar el enunciado del ejercicio mediante el siguiente comando:

pypas doc

Previsiblemente se abrirá un documento .pdf con la explicación del ejercicio.

Probar un ejercicio

El punto de entrada de la mayoría de los ejercicios es main.py. Será el fichero que debes cumplimentar buscando la etiqueta # TODO.

Para probar (testear) un ejercicio puedes usar:

pypas test

pytest

Ejecutar un ejercicio

Eventualmente podrías querer ejecutar tu código en vez de lanzar las pruebas.

Para explicar cómo, vamos a partir del ejercicio add. Este sería su main.py una vez terminado:

def run(a: int, b: int) -> int:
      result = x + y
      return result

# DO NOT TOUCH THE CODE BELOW
# ...

Tendrás que crear un fichero args.py dentro de la carpeta del ejercicio con los valores que quieras dar a los parámetros de la función principal:

a = 3
b = 7

Ahora podrás ejecutar tu programa con:

pypas run

Puedes utilizar esta estrategia para depurar los errores o mejorar tu código.

Actualizar un ejercicio

Es posible que, debido a la corrección de errores o mejoras introducidas, haya actualizaciones de los ejercicios.

En ese caso, puedes actualizar el ejercicio con:

pypas update

Se hará automáticamente una copia de seguridad (local) de aquellos ficheros (propios) que puedan ser sobreescritos.

Comprimir un ejercicio

Si quisieras comprimir todo el contenido del ejercicio para enviarlo o almacenarlo, lo puedes hacer con:

pypas zip

El comando anterior genera un fichero <ejercicio>.zip dentro de la propia carpeta del ejercicio con todos los ficheros (exluyendo ciertos ficheros «temporales» o «auxiliares»).

Autenticarse como usuario

Para poder autenticarte como usuario debes recibir un token por parte del administrador. Una vez que dispongas de este «token» debes ejecutar el siguiente comando:

$ pypas auth <pon-aqui-tu-token-quitando-los-angulitos>

Si la autenticación ha sido satisfactoria, se creará un fichero .pypas.toml en el HOME del usuario con la configuración correspondiente.

Desautenticarse

Es posible eliminar el «token» de autenticación ejecutando el comando:

pypas unauth

Entregar un ejercicio

Para entregar (subir) un ejercicio a pypas.es debes ejecutar el siguiente comando:

pypas put

El comando anterior comprime todos los archivos de tu ejercicio y los sube a pypas.es.

Seguir tu actividad

Para seguir tu actividad puedes lanzar el siguiente comando:

pypas log

Con el comando anterior podrás obtener la información de tus entregas, separadas por frames. Un frame es un "bloque de ejercicios" que suele tener asociada una fecha de comienzo y una fecha de finalización.

Dentro de cada «frame» verás la siguiente información:

• Uploaded: número de ejercicios entregados sobre el total de ejercicios del frame.
• Passed: número de ejercicios que han pasado todos los tests.
• Failed: número de ejercicios que no han pasado todos los tests.
• Waiting: número de ejercicios que están pendientes de testearse.
• Score: nota (puntuación). Ejercicios satisfactorios («passed») entre el total disponible.

Puedes obtener información más detallada sobre cada ejercicio entregado utilizando lo siguiente:

pypas log -v

Puedes obtener información de un determinado «frame» utilizando lo siguiente:

pypas log -f <frame>

Miscelánea

• pypas --version te proporciona la versión actual instalada del paquete pypas-cli.
• pypas --help te proporciona ayuda sobre el modo de uso del programa. Puedes aplicar --help sobre cualquier comando.

Si quieres informar de cualquier error o propuesta de mejora, lo puedes hacer en GitHub o escribiendo un correo (ver «footer»).