# Documentação Django 6.0.7

# Filosofias de Projeto

Este documento explica algumas filosofias que os desenvolvedores do Django tem usado ao criar o framework. Seu objetivo é de explicar o passado e guiar o futuro.

## Em geral

### Acoplamento fraco

Um objetivo fundamental do Django é acoplamento fraco e coesão forte. As várias camadas do framework não devem “saber” uma das outras salvo se absolutamente necessário.

Por exemplo, o sistema de modelo não sabe nada sobre solicitações da web, a camada de banco de dados não sabe nada sobre exibição de dados e o sistema de exibição não se importa com qual sistema de modelo um programador usa.

Embora o Django venha com uma pilha de soluções completa por conveniência, as peças desta pilha de soluções são independentes uma das outras sempre que possível.

### Menos código

Aplicações Django devem usar o mínimo possível de código; elas não devem ter código padrão. Django deve aproveitar as características dinâmicas do Python, como introspecção.

### Desenvolvimento Rápido

O objetivo de uma estrutura da Web no século 21 é tornar rápidos os aspectos tediosos do desenvolvimento da Web. O Django deve permitir um desenvolvimento web incrivelmente rápido.

### Não repita a si mesmo (DRY)

Cada conceito distinto e/ou dado deve estar em um, e apenas um, lugar. Redundância é ruim. Normalização é bom.

O framework deve deduzir, razoavelmente, o máximo possível do mínimo possível.

Ver também

A discussion of DRY on the Portland Pattern Repository

### Explícito é melhor que implícito

Esta é um dos princípios mais importantes de Python, listado em PEP 20, que significa que o Django não deve utilizar mágica demais. Mágica deve ser utilizada apenas quando houver uma razão realmente boa para tal. Mágica vale a pena ser usada somente se criar uma enorme conveniência, impossível de outra forma, e não deve ser implementada de forma a confundir os desenvolvedores que estejam tentando aprender como utilizar uma funcionalidade.

### Consistência

O framework deve ser consistente em todos os níveis. Consistência se aplica a tudo, do nível mais baixo (estilo de codificação Python utilizado) ao nível mais alto (a “experiência” de se usar Django).

## Modelos

### Explícito é melhor que implícito

Campos não devem assumir certos comportamentos baseados apenas no nome do campo. Isto requer muito conhecimento do sistema e é propenso a erros. Ao invés disso, o comportamento deve ser baseado em argumentos nomeados e, em alguns casos, no tipo do campo.

### Inclui toda lógica do domínio relevante

Modelos devem encapsular cada aspecto de um objeto, seguindo o padrão de projeto Active Record de Martin Fowler.

Esse é o porque de ambos os dados representandos por um modelo e a informação sobre eles (seus nomes legíveis, opções como ordenação padrão, etc) são definidos na classe de modelo; toda a informação necessária para entender um dado modelo deveria ser amazenada no modelo.

## API de banco de dados

Os objetivos principais da API de banco de dados são:

### Eficiência SQL

Ele deveria executar comandos SQL o mínimo de vezes possível, e deveria otimizar os comandos internamente.

É por isso que desenvolvedores devem chamar `save()` explicitamente, ao invés do framework salvar coisas por trás das cenas silenciosamente.

This is also why the `FETCH_PEERS` fetch mode exists. It’s an optional performance booster for the common case of selecting related objects for every peer in a `QuerySet`.

### Concisa, sintaxe poderosa

A API de banco de dados deve permitir uma rica, declarações expressivas na menor syntaxe possível. Não deve se basear na importação de outros módulos e objetos auxiliares.

“joins” devem ser realizados automaticamente, pode de trás das cenas, quando necessário.

Cada objeto deve ser capaz de acessar cada objeto relaticionado, em todo o sistema. Este acesso deve funcionar nas duas vias.

### Opção de usar SQL nativo, quando necessário.

A API do banco de dados deve perceber que é um atalho mas não necessariamente um meio para todos os fins. O framework deve facilitar a escrita de SQL personalizado – declarações inteiras, ou somente cláusulas `WHERE` personlizadas como parâmetros personalizados para chamadas de API.

## Definindo URL

### Acoplamento fraco

As URLs na aplicação Django não devem estar casadas com os componentes Python. Amarrar URLs a nomes de funções Python é uma coisa ruim e feia.

Ao longos destas linhas, o sistema de URL do Django deve permitir URLs ara uma mesma aplicação ser diferentes em diferetes contextos. Por exemplo, um site pode colocar “stories” em `/stories/`, enquanto outro possa usar `/news/`.

### Flexibilidade Infinita

As URLs deve ser tão flexíveis quanto possível. Qualquer URL concebível deve ser permitida.

### Encoraja melhores práticas

O framework deve tornar fácil (ou mesmo mais fácil) para um desenvolvedor definir URLs bonitas do que feias.

Extensões de arquivo em URLs de páginas da web devem ser evitadas.

Vírgula no estilo Vignette em URLs merecem uma punição servera.

### URLs definitivas

Tecnicamente, `foo.com/bar` e `foo.com/bar/` são dois URLs diferentes, e os robôs do mecanismo de busca (e algumas ferramentas de análise de tráfego da web) os tratariam como páginas separadas. O Django deve fazer um esforço para “normalizar” as URLs para que os robôs dos mecanismos de busca não fiquem confusos.

Essa é a razão por de trás da definição `APPEND_SLASH`.

## Sistema de “template”

### Separe a lógica da apresentação.

Nós vemos o sistema de “template” como uma ferramenta que controla a apresentação e a lógica relacionada a apresentação – e só isso. O sistema de template não deve dar suporte a funcionalidades que vão além deste objetivo básico.

### Desencoraja a redundância

A maioria dos sites web dinâmicos usam algum tipo de design para todo o site – um cabeçalho comum, um rodapé, barra de navegação etc. O sistema de “template” do Django deve tornar fácil armazenar estes elementos em um único local, eliminando duplicidade de código.

Esta é a filosofia por de trás: herança de template.

### Esteja desacomplado do HTML.

O sistema de “template” não deve ser feito de modo que só entregue HTML. Ele deve ser igualmente bom em gerar outros formatos baseados em texto, ou texto simples apenas.

### XML não deve ser usado para linguagens de “template”.

Usar um mecanismo XML para interpretar templates introduz um mundo inteiro novo de erros humanos na edição de “templates” – e incorre em um nível de custo inaceitável no processamento de “template”.

### Assume a competência do designer

O sistema de “template” não deve ser desenhado para que os “templates” sejam mostrados necessariamente de forma bonita em editores WYSIWYG como o dreamWeaver. Essa é uma limitação muito severa e não poderia permitir que a syntaxe fosse tão boa quanto é. O Django espera que autores de “templates” estejam confortáveis em editar o HTML diretamente.

### Trate espaços em branco de maneira óbvia.

O sistema de “template” não deve fazer coisas mágicas com espaços. Se um template inclui espaços, o sistema deve tratar espaços como trata o texto – somente mostrá-lo. Qualquer espaço em branco que não estiver dentro de uma tag de template deve ser mostrado.

### Não inventa uma linguagem de programação

O objetivo não é inventar uma linguagem de programação. O objetivo é oferecer somente o suficiente de funcionalidade programática, tal como ramificações e loops, que é essencial para tomar decisões relacionadas a apresentação. O Linguagem de Template do Django (sigla DTL em inglês) tenta evitar lógica avançada.

### Segurança

O sistema de template, tal como foi feito, deve coibir a inclusão de código malicioso – tal como comandos que deletam registros de banco de dados.

Este é outro motivo pelo qual o sistema de template não permite código Python arbitrário.

### Extensibilidade

O sistema de “template” deve reconhecer que autores de “template” avançados talvez queiram extender sua tecnologia.

Esta é a filosofia por trás das “tags” e filtros personalizadas.

## Views

### Simplicidade

Escrever uma “view” deve ser tão simples quanto escrever uma função Python. Desenvolvedores não devem ter que instânciar uma classe enquanto uma função resolve.

### Use objetos de requisição

“Views” devem ter acesso a um objeto de requisição – um objeto que armazena metadados sobre a requisição corrente. O objeto deve ser passado diretamente a uma função “view”, ao invés da função “view” ter que acessar os dados de uma requisição vindos de uma variável global. Isso faz com que seja leve, limpo e fácil de testar “views” passando um objeto de requisição “de mentira”.

### Acoplamento fraco

Uma “view” não deve se preocupar sobre qual sistema de template o desenvolvedor usa – ou mesmo se um sistema de templates está sendo usado.

### Diferencie entre GET e POST.

GET e POST são distintintos; desenvolvedores devem usar explcitamente um ou outro. O framework tornar fácil a distinção entre dados de GET e POST.

## Framework de Cache

O principais objetivos do Django framework de cache são:

### Menos código

A cache should be as fast as possible. Hence, all framework code surrounding the cache backend should be kept to the absolute minimum, especially for `get()` operations.

### Consistência

A API de “cache” deve fornecer uma interface consistente através de “backends de cache” diferentes.

### Extensibilidade

A API de “cache” deve ser extensível no nível da aplicação baseado nas necessidades dos desenvolvedores (por exemplo, veja Cache key transformation).