Exercício – Criar seu primeiro projeto

Concluído

Agora que exploramos alguns conceitos básicos do Django, vamos começar a criar o projeto.

Criar um projeto com Django-admin

Conforme realçado anteriormente, um projeto do Django é o contêiner para todo o nosso projeto e todos os aplicativos que criamos. Vamos criar o projeto.

Na janela do terminal no Visual Studio Code, execute o seguinte comando:

django-admin startproject helloproject .

Importante

O ponto à direita no final do comando é importante. Ele instrui django-admin a usar a pasta atual. Se você não usar o ponto, um subdiretório adicional será criado.

Após a execução do comando anterior, o novo projeto deve estar no diretório escolhido. Neste caso, você veria uma nova pasta chamada helloproject.

Explorar a estrutura do projeto

Agora que o projeto do Django foi criado, vamos examinar a estrutura para ver o que foi incluído.

manage.py
helloproject/
    __init__.py
    asgi.py
    settings.py
    urls.py
    wsgi.py
  • O utilitário de linha de comando manage.py é criado em todos os projetos do Django. Ele tem a mesma função que django-admin. O exemplo a seguir mostra como ele poderia ser usado se você estivesse dentro da pasta do projeto e quisesse ver os subcomandos disponíveis.

    python manage.py help
    
  • helloproject é considerado o pacote de Python de seu projeto.

  • init.py é um arquivo vazio que funciona para dizer ao Python que esse diretório deve ser considerado um pacote.

  • settings.py contém todas as configurações ou definições.

  • urls.py contém as URLs dentro do projeto.

  • asgi.py e wsgi.py servem como ponto de entrada para os servidores Web dependendo do tipo de servidor implantado.

Executar o projeto

Agora que o Django está instalado, um projeto foi criado e examinamos a estrutura do projeto, é hora de verificar se o projeto está funcionando corretamente.

  1. Dentro da janela do terminal no Visual Studio Code, insira o código a seguir para iniciar o servidor.

    python manage.py runserver
    

    O projeto executa verificações de sistema e inicia o servidor de desenvolvimento. Copie e cole a URL do servidor de desenvolvimento, que deve ser http://localhost:8000, no navegador de sua preferência. Você deve ver uma página de Parabéns do Django com uma imagem de um foguete decolando.

  2. Pare o servidor temporariamente, pois precisaremos reconfigurar o projeto. Dentro da janela do terminal, selecione Ctrl + C.

Criar o aplicativo Olá, Mundo

Aprendemos as noções básicas sobre a estrutura do Django e examinamos a estrutura de pastas do projeto. Agora, é hora de criar nosso primeiro aplicativo! O aplicativo Olá, mundo! ajudará você a entender como os aplicativos são criados e como eles funcionam em harmonia com o projeto Django.

Na janela do terminal, execute o comando a seguir para criar o aplicativo.

python manage.py startapp hello_world

Com esse comando, o Django cria as pastas e os arquivos necessários, e a estrutura a seguir deve estar visível.

hello_world/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

Registrar aplicativo com projeto

Como aplicativos e projetos são separados no Django, você deve registrar seu aplicativo no projeto. Isso é feito atualizando a variável INSTALLED_APPS dentro de settings.py para o projeto, adicionando uma referência à classe de configuração do aplicativo. A classe de configuração é encontrada em apps.py e tem o mesmo nome do projeto. Em nosso exemplo, a classe será nomeada HelloWorldConfig.

  1. Dentro de helloproject, abra settings.py.

  2. Localize a lista INSTALLED_APPS, que deve estar na linha 33.

  3. Adicione o seguinte ao final da lista, dentro dos colchetes ([ ]):

    'hello_world.apps.HelloWorldConfig',
    
  4. A lista INSTALLED_APPS atualizada se parece com o seguinte:

    INSTALLED_APPS = [
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.sessions',
        'django.contrib.messages',
        'django.contrib.staticfiles',
        'hello_world.apps.HelloWorldConfig',
    ]    
    
  5. Salve todos os arquivos selecionando Arquivo>Salvar tudo.

Parabéns! Você criou seu primeiro projeto e aplicativo Django. Em seguida, é criar um caminho e uma exibição para adicionar algumas funcionalidades.