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.
- Versões anteriores 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.
Se você está atualizando entre mais de uma versão (ex.: A.B para A.B+2), é normalmente mais fácil de atualizar cada versão incrementalmente (A.B para A.B+1 para A.B+2) ao invés de precisar fazer todas as modificações de cada versão lançada de uma vez só. Para cada versão lançada, use o patch de lançamento (A.B.C).
A mesma abordagem de atualização incremental é recomendada quando for atualizar de um lançamento LTS para outro.
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.
Em Python, avisos de código obsoleto são silenciados por padrão. Você deve ativá-los usando a opção de linha de comando Python -Wa, ou então a variável de ambiente PYTHONWARNINGS. Por exemplo, para exibir alerta durante a execução de testes:
$ python -Wa manage.py test
...\> py -Wa 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=always 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.
Se você tiver instalado Django com pip, você pode usar a flag --upgrade ou -U.
$ pip install -U Django
...\> pip install -U Django
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 -Wa manage.py test
...\> py -Wa 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().
