Criando Primeiro Projeto em Django

Ao instalar o Django em um ambiente virtual, é disponibilizada a ferramenta django-admin. No Windows, também é incluído o executável django-admin.exe. Esses arquivos fazem parte do ambiente virtual, que isola as dependências do projeto, e podem ser acessados no subdiretório apropriado: no Windows, no diretório Scripts; no Linux e macOS, no diretório bin. Essa organização garante que o ambiente virtual contenha todas as ferramentas necessárias para trabalhar com o Django sem interferências externas.

O django-admin oferece uma variedade de comandos para gerenciar projetos Django. Um dos mais importantes é o comando startproject, usado para criar um novo projeto. Esse comando exige que seja especificado o nome do projeto como argumento.

Por exemplo, para criar um projeto básico, você pode armazená-lo na mesma pasta onde o ambiente virtual foi configurado. Antes disso, é necessário ativar o ambiente virtual. Em seguida, execute o seguinte comando:

django-admin startproject programicio

Neste caso, será criado um projeto chamado "programicio". Após a execução do comando, uma pasta chamada programicio será gerada no diretório atual (c:\django).

Estrutura do projeto

django
└── programicio
    ├── manage.py
    └── programicio
        ├── __init__.py
        ├── settings.py
        ├── urls.py
        └── wsgi.py

A pasta gerada pelo comando contém os seguintes elementos principais:

• manage.py

  Este arquivo é usado para executar comandos de gerenciamento do projeto. Ele permite, por exemplo, inicializar o servidor de desenvolvimento, criar novqs aplicações e realizar migrações de banco de dados.

• Diretório do projeto (programicio)

  Contém os arquivos que definem a estrutura do projeto. Eles incluem:

  • __init__.py

    Um arquivo vazio que indica que o diretório onde está localizado é tratado como um pacote Python.

  • settings.py

    Contém as configurações globais do projeto, como a definição do banco de dados, configurações regionais (locale), gerenciamento de arquivos estáticos e aplicativos instalados.

  • urls.py

    Define as rotas do projeto, mapeando URLs para as respectivas views. Ele organiza a lógica de roteamento do projeto.

  • wsgi.py

    Configura o WSGI (Web Server Gateway Interface), uma interface usada para implantação de servidores web síncronos em produção.

Executando o projeto

Para executar o projeto, o terminal deve ser direcionado para a pasta principal do projeto com o comando cd. Uma vez no diretório correto, o servidor de desenvolvimento pode ser iniciado utilizando o seguinte comando:

python manage.py runserver

Após a execução, o terminal exibirá o endereço onde o servidor está sendo executado, geralmente http://127.0.0.1:8000/. Esse endereço pode ser inserido em um navegador web para acessar a página inicial padrão do projeto Django.

Documentação oficial:

• Tutorial Django