Gerenciamento do Ciclo de Vida de Dados Meteorológicos

Visão Geral

Mantenha dados meteorológicos baixados e derivados exatamente pelo tempo que o consumidor deles precisa. Torne a propriedade explícita para que trabalhos de uso único limpem prontamente, visualizações interativas retenham suas entradas até o fechamento e caches compartilhados nunca sejam excluídos como parte da limpeza de requisições.

Esta habilidade governa o tempo de vida e a propriedade. Ela não escolhe um provedor, decodifica dados científicos ou define uma política de descarte de cache por si só.

Quando Usar Esta Habilidade

• Uma renderização concluída deixa arquivos temporários grandes para trás.
• Uma visualização interativa falha porque seus dados de suporte foram excluídos muito cedo.
• Cancelamento ou exceções vazam downloads parciais e arquivos derivados.
• Arquivos de propriedade da requisição e um cache de usuário compartilhado são misturados.
• Trabalhadores em segundo plano transferem a propriedade de dados para uma interface de usuário ou estágio de processamento posterior.

Classifique Cada Caminho

Atribua a cada arquivo ou diretório um proprietário e um tempo de vida:

Se a propriedade não puder ser declarada, não exclua o caminho. Resolva a propriedade primeiro.

Fluxo de Trabalho de Uso Único

Use um diretório temporário específico da requisição, mantenha todos os downloads transitórios e produtos intermediários dentro dele, e copie ou mova atomicamente apenas o artefato solicitado para seu destino durável.

from pathlib import Path
from tempfile import TemporaryDirectory


def render_once(destination):
    destination = Path(destination)
    destination.parent.mkdir(parents=True, exist_ok=True)

    with TemporaryDirectory(prefix="weather-job-") as workspace:
        workspace = Path(workspace)
        source = fetch_into(workspace)
        temporary_output = render(source, workspace / "result.png")
        temporary_output.replace(destination)

    return destination

O artefato final deve residir fora do diretório temporário. Se a substituição entre sistemas de arquivos não for atômica, copie para um arquivo temporário ao lado do destino final, verifique-o e, em seguida, substitua localmente.

Fluxo de Trabalho Interativo

Um consumidor interativo sobrevive ao trabalhador que criou seus dados. Transfira a propriedade apenas após a criação bem-sucedida do visualizador ou sessão:

1. O trabalhador é proprietário da área de trabalho da requisição durante a aquisição.
2. Se a aquisição ou a criação da exibição falhar, o trabalhador a limpa imediatamente.
3. Na exibição bem-sucedida, anexe um único callback de limpeza idempotente ao evento de fechamento ou destruição do consumidor real.
4. O consumidor se torna o proprietário; o trabalhador não deve excluir os dados em seu caminho finally comum.
5. Se vários consumidores compartilharem os mesmos dados, libere-os apenas após o fechamento do último empréstimo.

Não vincule a limpeza a uma caixa de diálogo temporária, variável local ou sinal que possa disparar antes que o consumidor real termine.

Regras de Falha e Cancelamento

• Mantenha downloads incompletos sob um sufixo ou diretório distinto para que não possam ser confundidos com dados válidos.
• Feche conjuntos de dados, manipuladores de arquivos e mapeamentos de memória antes de remover seus caminhos.
• Coloque a limpeza de propriedade da requisição em finally, mas exclua recursos cuja propriedade foi transferida com sucesso.
• Torne a limpeza idempotente; um sinal de cancelamento e um evento de fechamento podem competir.
• Preserve um manifesto de resultado parcial durável quando o usuário puder tentar o trabalho restante.
• Em caso de falha na limpeza, relate o caminho exato de propriedade sem excluir diretórios pais mais amplos.

Limite do Cache Compartilhado

• Uma requisição pode ler ou popular um cache compartilhado, mas não é proprietária da raiz do cache.
• Promova entradas validadas atomicamente; nunca exponha um arquivo parcial como um acerto.
• Use identidade de cache e metadados de descarte em vez de excluir arquivos por idade ou adivinhação de nome de arquivo dentro do código da requisição.
• Não coloque exportações de usuário dentro de um diretório que a limpeza normal do cache possua.
• Teste se dois consumidores concorrentes não removem dados ainda emprestados pelo outro.

Lista de Verificação de Verificação

• Cada caminho criado tem um proprietário nomeado e um evento de exclusão.
• Operações de uso único retêm apenas saídas duráveis solicitadas.
• Dados interativos permanecem disponíveis até que o consumidor final feche.
• A falha na criação da exibição limpa imediatamente.

…