Conteúdo do curso Lição 69 de 148 · APIs que ninguém pode usar de forma errada
APIs que ninguém pode usar de forma errada

Sem armadilhas booleanas

Por que isso importa copy(src, dst, True, False) não pode ser lido sem abrir a function. Troque as duas flags e um dry run vira uma sobrescrita real. Opções nomeadas fazem cada chamada dizer o que faz.

A equipe de dados

A tem um auxiliar que copia registros entre duas lojas: copy_records(src, dst, overwrite, dry_run). No mês passado, alguém o chamou como copy_records(a, b, False, True) significando "dry run, do not overwrite", errou a ordem e sobrescreveu uma tabela de produção. Você está substituindo isso.

Armadilha booleana: um argumento que é apenas True ou False, então o local da chamada não diz o que ele significa e é fácil de trocar.

copy_records(src, dst, on_conflict="keep", mode="dry_run")
Sua vez

Escreva copy_records(src, dst, *, on_conflict, mode). src e dst são dicts. Para cada chave em src: se ela não estiver em dst, copie ela; se estiver, on_conflict decide: "keep" (mantenha o valor de dst), "overwrite" (use o de src), ou "fail" (lance ValueError e não mude nada). mode é "apply" (mude dst) ou "dry_run" (não mude nada). Retorne a lista ordenada de chaves escritas (ou que seriam).

Scripts de uso indevido ocultos tentarão cada um destes; cada um deve gerar TypeError ou ValueError e deixar dst inalterado: passar as opções por posição, deixar qualquer uma das opções de fora (sem padrões: quem chama deve escolher), qualquer valor que não seja exatamente uma das strings nomeadas (erros de digitação, outras maiúsculas, True, False, None) e a antiga palavra-chave overwrite=.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.