# Documentação Django 6.0.7

# Notas de lançamento do Django versão 0.96

Bem-vindo (a) à versão 0.96 do Django

O primeiro objetivo para o 0.96 é limpar e estabilizar as características introduzidas na versão 0.95. Houveram algumas backwards-incompatible changes desde a 0.95, mas o processo de atualização deve ser razoavelmente simples e não deve requerer uma grande mudança nas aplicações existentes.

Contudo, estamos também disponibilizando 0.96 agora pois temos várias alterações retro-incompatíveis agendadas para breve. Assim que concluídas, elas envolverão algumas alterações no código para desenvolvedores de aplicações, assim sendo, recomendamos que você continue com Django 0.96 até a próxima versão oficial; então será possível atualizar em um passo ao invés de fazer alterações incrementais para continuar com a versão de desenvolvimento do Django.

## Alterações retro-incompatíveis.

Para as próximas alterações, pode ser necessário atualizar seu código ao sair da versão 0.95 para a 0.96:

### `MySQLdb` versão solicitada.

Devido um bug nas versões anteriores do módulo `MySQLdb` para Python (que é utilizado pelo Django para se conectar à base de dados MySQL), o backend de MySQL do Django agora requer versão 1.2.1p2, ou superior, do módulo “MySQLdb. Caso sejam utilizadas verões anteriores a esta, ocorrerão excessões.

Caso você não possa atualmente atualizar a cópia do “MySQLdb” para satisfazer essas necessidades, um backend retro-compatível separado, chamado, “mysql_old”, foi adicionado ao Django. Para utilizar este backend, altere as configurações em `DATABASE_ENGINE` no arquivo settings de:

    DATABASE_ENGINE = "mysql"

para:

    DATABASE_ENGINE = "mysql_old"

Contudo, é altamente encorajado por nós que os usuários de MySQL, atualizem o módulo “MySQLdb” o quanto antes. O backend “mysql_old serve apenas para facilitar a transição e é considerado deprecated; ou seja, fora correções de segurança, ele não será ativamente mantido e será removido em uma futura versão do Django.

Note ainda que algumas funções como a nova configuração `DATABASE_OPTIONS` (veja o :doc: documentação de base dados </ref/databases> para detalhes) só está disponível para o backend “mysql”, não estando dispoível para “mysql_old”.

### Nomes de restrição de dados alterados

O formato dos nomes das regras gerados pelo Django para referenciar chaves estrangeiras foram ligeiramente alteradas. Estes nomes, em geral, são usados somente quando não é possível colocar a referência diretamente na coluna afetada, de modo que não estão visíveis sempre.

O resultado disso é que ao executar `manage.py reset` e comandos similares em um banco de dados existente talvez gerará um SQL com o novo formato de nome do “constraint”, enquanto que o banco de dados existente contém nomes no formato antigo; isso irá fazer com que o banco de dados gere uma mensagem de erro sobre modificar “constraints” não existentes

Se você precisar contornar isso, há dois métodos disponíveis:

1. Redirecione a saída de “manage.py” para um arquivo e edite o SQL gerado para corrigir as constraints antes de executá-lo.

2. Verifique a saída de `manage.py sqlall` para ver o novo estilo para os nomes de constraint e utilize isso como um guia para renomear as constraints existentes em sua base de dados.

### Nomes alterados em “manage.py”

Algumas das opções de “manage.py” foram alteradas com o adição de suporte a fixture:

- Existem novos comandos “dumpdata” e “loaddata” que, como se pode imaginar, irão realizar dump’s e load’s de dados de/para a base de dados. Estes comandos, podem operar em qualquer formato de serialização que seja suportada pelo Django.

- O comando `sqlinitialdata` foi renomeado para `sqlcustom` para enfatizar que o `loaddata` deve ser usado para dados (e o `sqlcustom` para outros SQL customizados – views, stored procedures, etc.).

- O comando `install` foi removido. Use `syncdb`.

### Escape da contrabarra modificado

O banco de dados de API Django agora escapa barras invertidas fornecidas como parâmetros na consulta. Se tiver algum código de API de banco de dados que coincida com barras invertidas, e ele estava funcionando antes (apesar da falta de escapar), você vai ter que alterar seu código para “não escapar” as barras em um nível.

Por exemplo, isto costumava funcionar:

    # Find text containing a single backslash
    MyModel.objects.filter(text__contains="\\\\")

Agora, o código acima está incorreto, e deve ser reescrito como:

    # Find text containing a single backslash
    MyModel.objects.filter(text__contains="\\")

### Configuração ENABLE_PSYCO removida

A configuração `ENABLE_PSYCO` não existe mais. Se seu arquivo de configurações incluir `ENABLE_PSYCO` isso não terá efeito; para usar o Psyco, nós recomendamos escrever uma classe middleware para ativá-lo.

## O que há de novo na 0.96?

Esta correção representa mais de mil commits e mais de quatrocentos correções de bugs, assim não é fácil catalogar todas estas alterações. Aqui, estão descritas apenas as alterações mais relevantes este lançamento.

### Biblioteca de novas formas

`django.newforms` is Django’s new form-handling library. It’s a replacement for `django.forms`, the old form/manipulator/validation framework. Both APIs are available in 0.96, but over the next two releases we plan to switch completely to the new forms system, and deprecate and remove the old system.

Há três elementos para essa transição:

- We’ve copied the current `django.forms` to `django.oldforms`. This allows you to upgrade your code now rather than waiting for the backwards-incompatible change and rushing to fix your code after the fact. Just change your import statements like this:

      from django import forms  # 0.95-style
      from django import oldforms as forms  # 0.96-style

- O próximo lançamento oficial do Django irá mover o atual `django.newforms` para `django.forms`. Isto será uma alteração não compatível com versões anteriores, e alguem ainda usando versões mais velhas do `django.forms` naquele momento irá precisar alterar as declrações de import como descrito acima.

- O próximo lançamento após o que irá remover completamente `django.oldforms`.

Embora a biblioteca `newforms` continue evoluindo, ela está pronta para uso na maioria dos casos. Recomendamos que novos formulários deixe de usar o antigo sistema e já inicie com o novo sistema de formulários.

Para mais informações sobre` django.newforms`, leia a documentação newforms.

### Melhorias URLconf

Agora você pode usar qualquer requisição como retorno de requisição no URLconfs (anteriormente, somente strings que referia-se a requisições era permitido). Isto permite um uso muito mais natural do URLconfs. Por exemplo, este URLconf:

    from django.conf.urls.defaults import *

    urlpatterns = patterns("", ("^myview/$", "mysite.myapp.views.myview"))

Agora pode ser reescrita como:

    from django.conf.urls.defaults import *
    from mysite.myapp.views import myview

    urlpatterns = patterns("", ("^myview/$", myview))

Uma aplicação útil disso pode ser visto quando se utiliza decoradores; esta mudança permite que você aplique decoradores de views *em seu URLconf *. Assim, você pode fazer uma view genérica requerer login facilmente:

    from django.conf.urls.defaults import *
    from django.contrib.auth.decorators import login_required
    from django.views.generic.list_detail import object_list
    from mysite.myapp.models import MyModel

    info = {
        "queryset": MyModel.objects.all(),
    }

    urlpatterns = patterns("", ("^myview/$", login_required(object_list), info))

Note-se que ambas syntaxes (strings e callables) são válidos, e continuará a ser válido para o futuro previsível.

### O teste framework

Django now includes a test framework so you can start transmuting fear into boredom (with apologies to Kent Beck). You can write tests based on `doctest` or `unittest` and test your views with a simple test client.

There is also new support for “fixtures” – initial data, stored in any of the supported serialization formats, that will be loaded into your database at the start of your tests. This makes testing with real data much easier.

Veja a documentação the testing para ver os detalhes completos.

### Melhorias para a interface de administrador

Uma pequena mudança, mas muito bacana: views dedicadas para adicionar e atualizar usuários foram adicionadas a interface do admin, então você não precisa se preocupar em trabalhar com senhas hash no admin.

## Obrigado

Since 0.95, a number of people have stepped forward and taken a major new role in Django’s development. We’d like to thank these people for all their hard work:

- Russell Keith-Magee and Malcolm Tredinnick for their major code contributions. This release wouldn’t have been possible without them.

- Our new release manager, James Bennett, for his work in getting out 0.95.1, 0.96, and (hopefully) future release.

- Our ticket managers Chris Beaven (aka SmileyChris), Simon Greenhill, Michael Radziej, and Gary Wilson. They agreed to take on the monumental task of wrangling our tickets into nicely cataloged submission. Figuring out what to work on is now about a million times easier; thanks again, guys.

- Everyone who submitted a bug report, patch or ticket comment. We can’t possibly thank everyone by name – over 200 developers submitted patches that went into 0.96 – but everyone who’s contributed to Django is listed in AUTHORS.