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.

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

Instalación¶

El paquete —en realidad— se denomina pypas-cli y existen varias maneras de instalarlo:

$ uv tool install -n -p 3.13 pypas-cli

$ python -m pip install pypas-cli

$ python -m ensurepip --upgrade

$ 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

Actualización manual¶

Si tienes algún problema con el comando de actualización pypas upgrade, también puedes actualizar manualmente el paquete pypas-cli. Este proceso dependerá del gestor de paquetes que hayas utilizado:

Listar 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:

$ pypas list -p <topic>  # primary topic

$ pypas list -s <topic>  # secondary topic

$ pypas list -f <frame>

Es posible combinar filtros para obtener un resultado más concreto.

Obtener un ejercicio¶

Cada ejercicio dispone de un slug (palabra) que lo identifica unívocamente.

$ pypas get add #(1)!

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

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 («pypas testear») un ejercicio puedes usar:

$ pypas test

Ejecutar un ejercicio¶

Eventualmente podrías querer ejecutar tu código en vez de lanzar las pruebas. Puedes utilizar esta estrategia para depurar los errores o mejorar la solución propuesta.

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

# DO NOT TOUCH THE CODE BELOW
# ...

a = 3
b = 7

$ pypas run

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 tu-token

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 #(1)!

1. Este comando comprime todos los archivos de tu ejercicio y los sube a pypas.es.

Seguir tu actividad¶

Para seguir tu actividad (de entrega de ejercicios) 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:

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

Obtener tus entregas¶

Puedes obtener (descargar) tus entregas a través del siguiente comando:

$ pypas pull foo

Funciona de la siguiente manera:

flowchart TB
    q1(["¿foo es un slug de ejercicio válido?"])
    q1 -->|sí| a1[["Se descarga el ejercicio foo"]]
    q1 -->|no| q2(["¿foo es un slug de frame válido?"])
    q2 -->|sí| a2[["Se descarga el frame foo"]]

Miscelánea¶