Me explique o que realmente acontece quando você chama uma função generator.

Chamar uma função generator não roda nenhum código do corpo; ela devolve um objeto generator. O corpo só executa quando você chama next nele, rodando até o primeiro yield, que suspende o frame com as variáveis locais intactas. Cada next seguinte retoma exatamente de onde parou. Quando o corpo retorna, o generator levanta StopIteration, que um loop for captura para você.

Chamar não faz quase nada. O Python vê a palavra yield em tempo de compilação, marca a função como generator, e a chamada só devolve um objeto generator com um frame congelado. Nada do corpo rodou ainda, o que pega as pessoas de surpresa quando elas esperam que a validação lá no topo dispare imediatamente. O primeiro next roda até bater num yield, passa aquele valor para fora e congela o frame com todos os locais ainda vivos. Chame next de novo e a execução continua na linha depois do yield. Quando a função chega ao fim ou bate num return sem valor, o Python levanta StopIteration, e um loop for trata isso como o sinal de parar. Por baixo, um generator satisfaz o protocolo de iteração porque tem tanto dunder iter quanto dunder next, então funciona em qualquer lugar onde se espera um iterável. Eu me apoio nisso para pipelines de streaming. Num projeto tínhamos quatro estágios de transformação encadeados como generators, e nenhum estágio segurava mais do que um único registro.