Atualizando o Django para uma nova versão

Apesar de ser um processo complexo as vezes, atualizar a versão do Django tem muitos benefícios:

• Novas características e melhorias são adicionadas.
• Erros são ajustados.
• Antigas versões do Django eventualmente não irão receber atualizações de segurança. (veja Versões suportadas).
• Atualizando assim que cada versão do Django fica disponível faz com que futuras atualizações sejam menos dolorosas, por mantendo sua base de código atualizada.

Aqui alguns pontos para considerar para ajudar fazer seu processo de atualização mais suave tanto quanto possível.

Leitura requerida

Se esta é sua primeira vez fazendo uma atualização, é útil ler o guia sobre o processo de atualizações diferente.

Depois você deveria familiarizar-se com as mudanças que foram feitas na(s) nova(s) versõe(s) do Django.

• Leia as notas sobre a edição para cara edição a partir da sua versão de Django corrente, até e inclusive a versão do Django pra qual que você planeja atualizar.
• Dê uma olhada no linha do tempo da depreciação para as versões relevantes.

Preste uma atenção particular a incompatibilidades das mudanças nas versões anteriores para ter uma idéia clara do que será necessário para uma atualização de sucesso.

If you’re upgrading through more than one feature version (e.g. A.B to A.B+2), it’s usually easier to upgrade through each feature release incrementally (A.B to A.B+1 to A.B+2) rather than to make all the changes for each feature release at once. For each feature release, use the latest patch release (A.B.C).

The same incremental upgrade approach is recommended when upgrading from one LTS to the next.

Dependências

Na maioria dos casos para atualizar para a última versão do Django será necessário atualizar as dependências do Django também. Se a versão do Django foi lançada recentemente ou se algumas de suas dependências não são muito bem mantidas, algumas dependências podem não dar suporte a versão do Django. Nestes casos você terá que esperar até que a nova versão das dependências sejam lançadas.

Resolvendo alertas de descontinuidade

Antes de atualizar, é uma boa idéia resolver qualquer alerta de descontinuidade emitido pelo projeto enquanto estiver usando sua versão do Django atual. Resolvendo estes alertas antes da atualização assegure-se que você tenha informações de todas as áreas do código que precisam de alteração.

No Python, alertas de descontinuidade são silenciados por padrão. Você deve ligá-las usando a opção de linha de comando Python -Wall ou a variável de ambiente PYTHONWARNINGS. Por exemplo, para mostrar alertas enquanto roda os testes:

$ python -Wall manage.py test

Se não estiver usando os testes do Django, você deve ter certeza que qualquer saída para o console não está sendo capturada o qual poderia esconder alertas de descontinuidade. Por exemplo, se usar o py.test:

$ PYTHONWARNINGS=all py.test tests --capture=no

Resolva qualquer alerta de descontinuidade com sua versão atual do Django antes de continuar o processo de atualização.

Aplicações de terceiros talvez usem APIs obsoletas para suporta múltiplas versões do Django, então alertas de descontinuidade em pacotes que você tenha instalado não indicam necessariamente um problema. Se um pacote não dá suporte a última versão do Django, considere enviar uma “issue” ou um “pull request” para ele.

Instalação

Uma vez que esteja pronto, é hora de instalar a nova versão do Django. Se estiver usando o virtualenv e for uma atualização grande, você talvez queira configurar um novo ambiente com todas as dependências primeiro.

Os passos exatos que serão necessários depende do seu processo de instalação. O jeito mais conveniente é usar o pip com --upgrade ou o parâmetro -U:

$ pip install -U Django

O pip também automaticamente desinstala as versões anteriores do Django.

Se você usa outros processos de instalação, talvez seja necessário manualmente desinstalar a versão antiga do Django e deve dar uma olhada nas instruções completas de instalação.

Testando

Quando o novo ambiente estiver definido, rode todo pacote de teste para sua aplicação. De novo, é útil ligar os alertas de descontinuidade de modo que sejam mostrados na saída dos testes (você também pode usar a “flag” se testar sua aplicação manualmente usando manage.py runserver):

$ python -Wall manage.py test

Depois que rodar os testes, concerte as falhas. Enquanto você tem as notas da versão frescas na sua cabeça, talvez seja uma boa hora para tirar vantagem das novas características do Django refatorando o código para eliminar qualquer alerta de descontinuidade.

Deploy

Quando você estiver suficientemente confiante que sua aplicação funciona com a nova versão do Django, você está pronto para ir em frente e implantar seu projeto com Django atualizado.

Se você estiver usando o cache fornecido pelo Django, você deve considerar limpar o cache depois da atualização. De outro modo você pode ter problemas, por exemplo, se você estiver mantendo em cache objetos serializados e estes objetos não tem garantia de compatibilidade de serialização entre as versões do Django. Um problema de incompatibilidade no passado foi o cache de objetos HttpResponse serializados, diretamente ou indiretamente via o decorador cache_page().