105-django-52

Novidades do Django 5.2

Em 02 de Abril de 2025 saiu o Django 5.2.

Veja o video no YouTube em breve.

Doc: https://docs.djangoproject.com/en/5.2/releases/5.2/

Github: https://github.com/rg3915/django52

Importante: remova a \ no meio das tags.

---

E eu vou destacar aqui algumas das novidades:

Importação automática dos modelos no shell (Automatic models import in the shell)

01

Ou digite simplesmente python manage.py shell

python manage.py shell -v 2 é o modo verboso.

Se quiser, você pode desabilitar isso. Leia mais em How to customize the shell command

Composição de Chave Estrangeira (Composite Primary Keys)

O novo django.db.models.CompositePrimaryKey permite a criação de tabelas com uma chave primária composta por vários campos.

02

🧳 Exemplo 1: Sistema de Reservas de Passagens

• Tabela: Reserva

• Chave composta: (voo_id, passageiro_id)

• Motivo: Motivo: Um passageiro pode ter várias reservas, e um voo pode ter vários passageiros. A chave composta identifica uma reserva única por voo e passageiro.

🏫 Exemplo 2: Registro de Presença em Aulas

• Tabela: Presenca

• Chave composta: (aluno_id, data, aula_id)

• Motivo: Um aluno só pode ter um registro por aula por dia. Isso evita duplicidade de presença.

Diagrama UML (feito no mermaid.live):

classDiagram
  class Aluno {
      +int id
      +string nome
  }

  class Professor {
      +int id
      +string nome
  }

  class Turma {
      +int id
      +string nome
      +int ano
  }

  class Aula {
      +int id
      +date data
      +string horario
      +int turma_id
      +int professor_id
  }

  class Presenca {
      +int aluno_id
      +int aula_id
      +date data_presenca
      +bool presente
      +string observacao
  }

  Aluno "1" --> "0..*" Presenca : registra
  Aula "1" --> "0..*" Presenca : possui
  Turma "1" --> "0..*" Aula : contém
  Professor "1" --> "0..*" Aula : ministra
  Aluno "0..*" --> "1" Turma : pertence

  note for Presenca "Chave composta: aluno_id + data_presenca + aula_id"

mermaid_school

models.py

Agora veja o arquivo apps/school/models.py

admin.py

Erro ao registrar no admin:

admin.site.register(Attendance)

Resultado:

django.core.exceptions.ImproperlyConfigured: The model Attendance has a composite primary key, so it cannot be registered with admin.

ImproperlyConfigured

Observações:

Segunda a doc:

Ainda estamos trabalhando no suporte a chaves primárias compostas para campos relacionais, incluindo campos GenericForeignKey, e para o Django Admin. No momento, modelos com chaves primárias compostas não podem ser registrados no Django Admin. Você pode esperar esse recurso em versões futuras.

Veja mais em:

• apps/school/

• Rodando a lista de presença no shell

Veja aqui a chave composta via DBeaver.

DBeaver

Observações: O Django não oferece suporte para migração para, ou a partir de, uma chave primária composta após a criação da tabela. Também não é possível adicionar ou remover campos de uma chave primária composta por meio de migrações do Django.

Se você deseja migrar uma tabela existente de uma chave primária única para uma chave primária composta, siga as instruções específicas do seu sistema de banco de dados para realizar essa alteração manualmente.

Depois que a chave primária composta estiver definida no banco de dados, adicione o campo CompositePrimaryKey ao seu modelo. Isso permitirá que o Django reconheça e trate corretamente a chave primária composta.

Leia mais em Migrating to a composite primary key

Minor features

Forms — New Inputs

ColorInput

class StudentForm(forms.ModelForm):
    class Meta:
        model = Student
        fields = ('name', 'class_group', 'color')
        widgets = {
            'color': forms.ColorInput()
        }

forms.py

Rodando: localhost:8000/school/create

TelInput

class StudentForm(forms.ModelForm):
    class Meta:
        model = Student
        fields = ('name', 'class_group', 'color', 'phone')
        widgets = {
            ...
            'phone': forms.TelInput(),
        }

SearchInput

class SearchForm(forms.Form):
    search = forms.CharField(
        required=False,
        widget=forms.SearchInput()
    )

Você também pode usar o django-phonenumber-field para validar o formato do telefone no models ou no forms.

JSONArray

A nova função de banco de dados JSONArray aceita uma lista de nomes de campos ou expressões e retorna um array JSON contendo esses valores.

jsonarray

Templates

simple_block_tags

Documentação

O novo decorador simple_block_tag() permite a criação de block tags simples, que podem aceitar e utilizar uma seção do template.

simple_block_tag 06

simple_block_tag 07

simple_block_tag 08

• Arquivo: card_tags.py

from django import template
from django.utils.html import format_html


register = template.Library()


@register.simple_block_tag(takes_context=True)
def card(context, content, header, footer):
    format_kwargs = {
        "header": header,
        "content": content,
        "footer": footer,
    }
    result = """
    <article>
      <header>{header}</header>
      {content}
      <footer>{footer}</footer>
    </article>
    """
    return format_html(result, **format_kwargs)

card_tags

• Template: student_list.html

{\% extends "base.html" %}

{\% load msgbox_tags %}
{\% load card_tags %}

{\% block content %}
  <div class="container">
    <h1>Alunos</h1>

    <div class="grid">
      <a role="button" href="{\% url 'school:student_create' %}">Cadastrar novo aluno</a>

      <form action="" method="GET">
        {{ form.search }}
      </form>
    </div>

    {\% msgbox level="error" %}
      Please fix all errors. Further documentation can be found at
      <a href="http://example.com">Docs</a>.
    {\% endmsgbox %}

    {\% msgbox level="info" %}
      More information at: <a href="http://othersite.com">Other Site</a>/
    {\% endmsgbox %}}

    {\% card header="Cabeçalho" footer="Rodapé" %}
      Este é um exemplo de um card feito com simple_block_tag.

      <figure>
        <img
          src="https://picsum.photos/1800/400"
          alt="picsum photos"
        />
      </figure>
    {\% endcard %}

    <table>
      <tbody>
        {\% for object in object_list %}
          <tr>
            <td>{{ object.pk }}</td>
            <td>{{ object.name }}</td>
            <td>{{ object.class_group }}</td>
            <td>{{ object.color }}</td>
            <td>
              <div class="ball" style="background-color: {{ object.color }}"></div>
            </td>
          </tr>
        {\% endfor %}
      </tbody>
    </table>
  </div>
{\% endblock content %}

{\% block js %}
  <script>
  const input = document.getElementById('id_search');

  input.addEventListener('input', function () {
    if (this.value === '') {
      // Redirect to current URL with no parameters (e.g., ".")
      window.location.href = '.';
    }
  });
</script>
{\% endblock js %

student_list.html

Alterações incompatíveis com versões anteriores na versão 5.2

Não tem mais suporte ao PostgreSQL 13

O suporte oficial ao PostgreSQL 13 será encerrado em novembro de 2025. O Django 5.2 oferece suporte ao PostgreSQL 14 e versões superiores.