Temario Lección 69 de 148 · APIs que nadie puede usar mal
APIs que nadie puede usar mal

Sin trampas booleanas

Por qué importa copy(src, dst, True, False) no se puede leer sin abrir la función. Intercambia los dos indicadores y una simulación se convierte en una sobrescritura real. Las opciones con nombre hacen que cada llamada diga lo que hace.

Un equipo de datos tiene una función auxiliar que copia registros entre dos almacenes: copy_records(src, dst, overwrite, dry_run). El mes pasado alguien la llamó como copy_records(a, b, False, True) queriendo decir "simulación, no sobrescribir", se equivocó de orden y sobrescribió una tabla de producción. Tú la vas a sustituir.

Trampa booleana: un argumento que solo es True o False, así que el sitio de la llamada no dice qué significa y es fácil de intercambiar.

copy_records(src, dst, on_conflict="keep", mode="dry_run")
Tu turno

Escribe copy_records(src, dst, *, on_conflict, mode). src y dst son diccionarios. Para cada clave de src: si no está en dst, cópiala; si está, decide on_conflict: "keep" (deja el valor de dst), "overwrite" (usa el de src) o "fail" (lanza ValueError y no cambia absolutamente nada). mode es "apply" (cambia dst) o "dry_run" (no cambia nada). Devuelve la lista ordenada de claves escritas (o que se escribirían).

Unos scripts ocultos de mal uso probarán cada uno de estos; cada uno debe lanzar TypeError o ValueError y dejar dst sin cambios: pasar las opciones por posición, omitir cualquiera de las opciones (sin valores por defecto: el llamador tiene que elegir), cualquier valor que no sea exactamente una de las cadenas con nombre (erratas, otras mayúsculas, True, False, None), y la palabra clave antigua overwrite=.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.