PROGRAMAÇÃO

BACK END I

Diego Bittencourt de Oliveira

Integrando o Django
ao Visual Studio
Objetivos de aprendizagem
Ao final deste texto, você deve apresentar os seguintes aprendizados:

„„ Compreender a instalação do Python no Visual Studio.

„„ Integrar o Django ao Visual Studio.
„„ Implementar uma aplicação Web com Django e Visual Studio.

Introdução
Atualmente, aplicações Web estão ganhando maior espaço no cenário da
programação, anteriormente dominado por aplicações do tipo desktop. O
Django é mais um framework que, verificando essa tendência, criou um
conjunto de ferramentas que possibilitam a fácil criação de aplicações
Web, utilizando a linguagem de programação Python. Observando isso, foi
desenvolvida uma extensão para que tanto o Django quanto a linguagem
Python fossem suportadas no Visual Studio, criando, assim, aplicações
Web por meio dessa popular IDE.
Neste capítulo, você conhecerá os passos para instalar o Python no
Visual Studio e aprenderá a realizar a correta integração do Django. Além
disso, você acompanhará a criação de uma aplicação Web, utilizando os
recursos instalados e integrados ao Visual Studio.

Instalação do Python no Visual Studio

O Visual Studio é um tipo de IDE, ou ambiente de desenvolvimento integrado.
Este ambiente de desenvolvimento integrado, segundo Santana e Galesi (2010),
é uma espécie de programa que possui inúmeros recursos que podem ser
utilizados em várias etapas do desenvolvimento de um software. No painel
de inicialização do Visual Studio é possível realizar a edição, a depuração e
2 Integrando o Django ao Visual Studio

a compilação de um código. Ainda, nesta IDE existem ferramentas de design

gráfico, assim como recursos para o preenchimento de códigos, entre outras
ferramentas para facilitar o desenvolvimento de um software.
O download do instalador Visual Studio é realizado diretamente no site
da Microsoft, podendo-se optar por baixar sua versão gratuita ou a versão
paga. A versão gratuita é mais simples em comparação à versão paga. Veja,
a seguir, as versões do Visual Studio que podem ser adquiridas.

„„ Community: gratuita. É uma versão completa para estudantes que visam

realizar projetos de código livre ou para desenvolvedores individuais.
„„ Code: esta é uma versão open source (de código aberto). Assim como
a Community, esta versão também é gratuita, mas é multiplataforma,
ou seja, pode ser utilizada tanto em sistemas Windows como Linux,
entre outros. Proporciona a edição e a depuração de códigos em várias
linguagens.
„„ Enterprise: versão paga. Trata-se de uma versão completa, ideal para
a utilização em empresas.
„„ Professional: também é uma versão paga, possuindo mais funções, além
de dispor de tipos de serviços voltados para equipes de desenvolvimento
relativamente menores ou a desenvolvedores individuais.

Na pasta de downloads, você encontra o arquivo baixado da versão esco-

lhida. Basta dar um clique duplo sobre o arquivo e sua instalação será iniciada.
Caso seja recebido um aviso de controle de conta de usuário Windows, basta
clicar em Sim para que a instalação ocorra de fato.
Em seguida, aparecerá uma tela com uma solicitação referente à confir-
mação dos termos de licença e de política de privacidade da Microsoft. Ao
clicar em Continuar, o instalador será instalado e será possível personalizar a
instalação do Visual Studio na guia Workloads (cargas de trabalho), conforme
podemos observar na Figura 1. Nesta parte, pode-se adicionar à instalação
as cargas de trabalho Python development (Desenvolvimento Python, ao
lado do logo dessa linguagem), ASP.NET and Web development (ASP.NET
e desenvolvimento Web, ao lado do ícone de um globo), entre outras.
 Integrando o Django ao Visual Studio 3

Figura 1. Personalização da instalação do Visual Studio pelas cargas de trabalho.

Fonte: Instalar... (2019, documento on-line).

Pela guia Individual components (Componentes individuais) é possível

realizar a instalação dos componentes das cargas de trabalho de maneira
individual, pois, conforme podemos observar na Figura 2, pode-se instalar
os componentes de forma padrão ou selecionar mais componentes, retirando
aqueles que não têm utilidade, dependendo da necessidade do desenvolvedor.
Pode-se adicionar diferentes compiladores, ferramentas de código, entre outros.

Figura 2. Personalização da instalação do Visual Studio pela instalação individual de

componentes.
Fonte: Instalar... (2019, documento on-line).
4 Integrando o Django ao Visual Studio

Após as cargas de trabalho ou os componentes desejados ser selecionados,

basta clicar sobre o botão Install (Instalar) e, então, a instalação será iniciada.
No decorrer deste processo serão mostradas telas nas quais será possível
observar o andamento da instalação e, após a conclusão, o Visual Studio
poderá ser utilizado.
Como mencionado anteriormente, é possível instalar a carga de trabalho de
Python. Esta é uma linguagem totalmente gratuita, com inúmeras bibliotecas
disponíveis e com o auxílio de uma comunidade de desenvolvedores. Pela lin-
guagem Python, o usuário pode realizar todas as maneiras de desenvolvimento,
inclusive de serviços e aplicativos Web, programas para desktop, scripts e,
ainda, computação científica. Esta linguagem é utilizada por todos os tipos
de usuários, do desenvolvedor amador ao profissional (BORGES, 2014).
Como já mencionado, é possível realizar a instalação desta carga de trabalho
de Python durante a instalação do Visual Studio, no momento de selecionar
as cargas de trabalho desejadas, conforme visto na Figura 1.
Se o usuário não souber se esta carga de trabalho está instalada ou não,
pode-se realizar um teste simples, com o intuito de verificá-lo. Basta pressionar
as teclas Alt+I ou acessar a aba Ferramentas > Opções > Python > Janelas
Interativas (PYTHON..., 2019, documento on-line). Isto resultará na abertura
da janela de interação do Python. Nela, digite 2+2, conforme demonstrado
na Figura 3. Caso o valor 4 seja retornado, o funcionamento está correto,
caso contrário, será necessário verificar a instalação da carga de trabalho em
questão e realizá-la novamente.

Figura 3. Teste de verificação da instalação do Python.

 Integrando o Django ao Visual Studio 5

Caso seja necessário realizar a instalação da carga de trabalho do Python,

basta acessar Ferramentas > Obter ferramentas e funcionalidades. O insta-
lador do Visual Studio abrirá e, nesta tela, será possível adicionar o suporte ao
Python apenas selecionando a carga de trabalho nomeada Desenvolvimento
Python. Dessa forma, será realizada a instalação padrão e, caso desejado,
é possível adicionar mais componentes da linguagem pelo campo Detalhes
da instalação, como demonstra a Figura 4. Após selecionar as alterações
desejadas, basta clicar em Modificar e será aberta a janela na qual pode se
observar o andamento do processo de modificação do Visual Studio.

Figura 4. Campo em que podem ser adicionados outros

componentes à carga de trabalho.
6 Integrando o Django ao Visual Studio

Integração do Django ao Visual Studio

Matthes (2016) evidencia que o Python possui uma estrutura de alto nível,
elaborada com o foco voltado para um desenvolvimento Web escalonável,
de velocidade considerável e segura. Esta estrutura é denominada Django.
Na nomenclatura do Django, seus projetos são constituídos por inúmeros
arquivos de configuração, referentes ao nível do site, em conjunto com algum
aplicativo que é inserido em um host Web, com a intenção de exercer o desen-
volvimento de uma aplicação Web por completo. Um aplicativo desenvolvido
pelo Django pode fazer parte de inúmeros de seus projetos, da mesma forma
que um projeto desenvolvido pelo Django pode possuir outros inúmeros apli-
cativos. Com relação ao projeto desenvolvido pelo Visual Studio, este pode
possuir um projeto do Django em conjunto com outros aplicativos.
Para criar um projeto e uma solução no Visual Studio, o usuário necessi-
tará ir a Arquivo > Novo > Projeto para abrir a tela de criação de projetos,
conforme demonstra a Figura 5, e nela pesquisar por Django. Ao fazê-lo, a
opção Blank Django Web Project (Projeto Web Django em branco) apare-
cerá. Após, abrirá uma tela chamada Name (Nome), na qual será necessário
nomear o projeto, e o campo Location (Local), em que se seleciona o local
de salvamento da aplicação. Este pode ser deixado com o padrão adicionado
pelo programa ou, caso queira alterá-lo, basta clicar em browser e selecionar o
local de preferência. Em relação ao campo Solution (Solução), recomenda-se
que este seja deixado com a forma padrão. Também haverá o campo Solution
name (Nome da solução), que deve ficar com o mesmo nome do campo
Name (Nome).
Além destes campos mencionados, nesta etapa é necessário marcar ou
não dois campos. O primeiro é chamado Create directory for solution (criar
um diretório para a solução), que se recomenda deixar estabelecido, o que
é o padrão. O outro campo é denominado Create new Git repository (criar
um novo repositório Git). A recomendação para este campo é deixá-lo mar-
cado, caso o usuário deseje criar um ambiente virtual. Após ter preenchido
e selecionado todos os itens corretamente, basta clicar em OK para ir para a
etapa seguinte.
 Integrando o Django ao Visual Studio 7

Figura 5. Tela de criação de um novo projeto no Visual Studio.

Fonte: Tutorial... (2018, documento on-line).

Depois de a etapa de criação do projeto ser finalizada, um código do projeto

do Django é automaticamente criado. Recomenda-se realizar uma análise deste
código. O arquivo denominado manage.py é localizado na raiz do projeto que
está sendo criado. Este é definido pelo Visual Studio, de maneira automática,
como sendo o arquivo de inicialização de um projeto que está sendo ou foi
criado. O Visual Studio concede comandos prontos de menu e, para encontrá-
-los, como demonstra a Figura 6, basta ir ao Solution explorer (gerenciador de
soluções) e clicar com o botão direito do mouse sobre o projeto. Após, clique
em Python para que a lista com estes comandos fique visível e seja possível
selecionar algum comando pertinente.
8 Integrando o Django ao Visual Studio

Figura 6. Onde se encontram os comandos citados.

Fonte: Tutorial... (2018, documento on-line).

No campo Solution explorer (gerenciador de soluções), existe uma pasta

que contém arquivos do projeto básico do Django. O __init__.py é um tipo
de arquivo vazio que comunica ao Python se a pasta em questão é um pacote
do Python ou não.
Já o wsgi.py é um arquivo para servidores Web compatíveis com WSGI
(Web server gateway interface, em português interface de porta de entrada do
servidor Web). Com o intuito de atender ao projeto, este arquivo é um ponto
de entrada que costuma permanecer igual, uma vez que fornece os ganchos
para os servidores Web de produção.
O arquivo settings.py possui todas as configurações do projeto, por exemplo,
configurações que sofrem alterações no decorrer da criação de uma aplicação Web.
Por fim, o arquivo urls.py sofre modificações ao longo da criação de um
projeto. Este arquivo armazena uma espécie de sumário do projeto do Django.
Outro arquivo do tipo texto que também pode ser encontrado na pasta do
projeto é o requirements.txt. Ao adicioná-lo, o Visual Studio especifica a
dependência de pacote pertencente ao Django. Por causa deste arquivo, ocorre
a sugestão para que se crie um ambiente virtual na primeira vez em que um
projeto é desenvolvido.
 Integrando o Django ao Visual Studio 9

O projeto criado pode ser executado mesmo estando vazio, com o intuito
de testar seu funcionamento. Para isso, é necessário clicar em Debug > Start
debugging (depurar > iniciar depuração) ou no botão Web server (servidor
Web) que, conforme demonstra a Figura 7, localiza-se na barra de ferramentas.

Figura 7. Localização do botão Web Server.

Ao ser inicializada a depuração, o usuário pode ser informado pelo Visual

Studio sobre ocorrência de algum tipo de falha, sendo que esta informação é
exibida ao usuário por meio de uma mensagem alertando que algum arquivo
necessário para a inicialização está faltando. Será, então, necessário que ele
vá em Project e selecione Properties. Ao fazê-lo, conforme mostra a Figura 8,
abrirá uma tela com o campo Startup file (arquivo de inicialização). Deverá
ser colocado o nome do arquivo necessário para a inicialização, pois, dessa
forma, o Visual Studio será informado que, quando a depuração for executada,
este será o arquivo de inicialização.

Figura 8. Tela para digitar o nome do arquivo necessário para a inicialização de um projeto.
10 Integrando o Django ao Visual Studio

Após esta alteração ser realizada (se for necessária), ao executar o servi-
dor, uma janela abrirá de forma automática no navegador, com a página que
conterá o link http://localhost:<port>. Também será aberta uma
janela do console, que exibirá o log do servidor. Como o projeto ainda não
possui aplicações será exibida somente uma página que confirmará que, até
o momento, tudo está funcionando de acordo. Para finalizar a depuração,
interrompendo a execução do servidor, basta ir a Debug > Stop debugging
no Visual Studio, ou simplesmente fechar a janela do console.

Aplicação Web com Django e Visual Studio

No Django, uma aplicação é basicamente uma espécie de pacote separado em
Python, que conterá um grupo de arquivos que se relacionam em função de
uma especialidade específica (MCKINNEY, 2018).
Um projeto do Django pode ter uma variada quantidade de aplicativos,
o que acaba por refletir no fato de que um host da Web pode trabalhar com
qualquer quantidade de pontos de entrada, que são separados de apenas um
nome de domínio.
Ao se criar um aplicativo no Django, este costuma iniciar com um grupo de
arquivos. Modelos de itens são fornecidos pelo Visual Studio, e estes exercem
a inicialização de uma aplicação do Django no interior de um de seus projetos.
Por exemplo, criaremos um aplicativo chamado HelloDjangoApp. Para
utilizar estes modelos em sua criação, vá a Solution explorer. Com o botão
direito do mouse, e clique sobre o nome do projeto e selecione Add > New
item. Na tela que será aberta, selecione Django 1.9 App, um dos modelos do
Django. Após nomear a aplicação, basta clicar em OK para realizar sua adição.
Exercendo função semelhante, existe o comando de menu integrado, que
possibilita criar uma aplicação Django. Para utilizá-lo, basta clicar com o botão
direito sobre o nome do projeto, clicar em Add e, em seguida, em Django
App. Ao clicar neste botão, automaticamente será solicitado um nome para a
aplicação. Assim que clicar em OK, será criada a aplicação no tipo Django 1.9.
Finaliza-se, então, a criação do aplicativo independente, da forma que ele for
desenvolvido. Como mostra a Figura 9, uma pasta com o nome dado será criada.
Esta está localizada na pasta do projeto e conterá itens como o __init__.py.
 Integrando o Django ao Visual Studio 11

Figura 9. Tela mostrando a aplicação já criada, com seus

arquivos e pastas.

Veja, a seguir, alguns exemplos de pastas e arquivos do Django.

„„ migrations: pastas em que são armazenados scripts (pelo Django) que

atualizam o banco de dados com o intuito de se manter em alinhamento
com as alterações que ocorrem nos modelos. Por meio das ferramentas
de migração do Django são aplicadas alterações — caso seja necessário
— para alguma versão anterior do banco de dados; esta funcionalidade
é utilizada em casos em que ocorre um erro na migração, desfazendo as
alterações problemáticas a fim de manter o aplicativo em funcionamento.
„„ templates: nesta pasta são inseridos modelos de página pertencentes
ao Django, como arquivos index.html, os quais possuem códigos
que formam visualização das páginas.
„„ __init__.py: arquivo que exerce uma identificação do aplicativo, como
um pacote de códigos ou um módulo.
12 Integrando o Django ao Visual Studio

„„ admin.py: arquivo Python em que é estendida a interface adminis-

trativa, referindo-se ao aplicativo, utilizada no intuito de exercer uma
propagação e editar dados localizados em um banco de dados.
„„ apps.py: arquivo Python pelo qual é definida uma classe que contém
a configuração para o aplicativo que estiver sendo criado.
„„ models.py: local padronizado onde são criados os modelos, além de no
momento inicial possuir somente uma instrução from django.db
import models. Modelos são objetos de dados cuja identificação
é realizada por meio de funções, além de ser por eles que o banco de
dados interage com os modos de exibição.
„„ tests.py: arquivo Python que possui uma espécie de estrutura básica
na qual são exercidos testes de unidade.
„„ views.py: arquivo padrão no qual são desenvolvidas as exibições e,
no primeiro momento, possui somente a instrução from django.
shortcuts import render. Modos de exibição são considerados
páginas da Web que recebem uma espécie de solicitação HTTP e, depois,
retornam uma resposta também HTTP.

Caso o projeto seja executado como descrito, após todas estas etapas ainda
será visualizada a página padrão mencionada anteriormente. Nesta etapa é
preciso especificar uma página do aplicativo, além de adicionar o aplicativo
ao projeto do Django. Inicialmente, é necessário alterar o arquivo views.py de
modo a que ele fique como descrito no código mostrado na Figura 10. Dessa
forma, estará sendo configurada uma espécie de exibição chamada index.
O próximo passo é modificar o arquivo urls.py, localizado na pasta Basic
Project, conforme o código descrito na Figura 11. É possível observar
padrões URL e, por meio de cada um destes, são descritas as exibições,
para as quais o Django encaminha as URLs de determinado site e que são
específicas. Basicamente vem a ser a parte da URL que segue o domínio,
por exemplo, http://www.dominio.com/. No código demonstrado na
Figura 11 existem duas entradas; a primeira inicia com uma expressão regular
e com ^$, tratando-se do roteamento que é realizado para a raiz do site “/”.
Já a segunda entrada é iniciada com a expressão regular ^home$, realizado
assim o direcionamento para “/home”.
 Integrando o Django ao Visual Studio 13

Figura 10. Código que determina a exibição da Index.

Fonte: Etapa... (2018, documento on-line).

Figura 11. Código com os padrões de URL.

Fonte: Etapa... (2018, documento on-line).

Neste ponto, se for novamente realizada a execução do projeto em de-

senvolvimento, será possível visualizar a mensagem “Hello, Django!”
(“Olá, Django!”), de acordo com o que foi definido pelo meio de exibição.
Um modelo de página pode ser utilizado para que um modo de exibição
seja renderizado. No momento, uma resposta HTTP é gerada pela função
Index, com texto, mas sem formatação de página. A maior parte das páginas
Web responde pelas páginas HTML, sendo elas avançadas e que costumeira-
mente incorporam dados dinâmicos. Exibições como esta ocorrem para que
o conteúdo seja gerado de forma dinâmica.
14 Integrando o Django ao Visual Studio

Qualquer tipo de HTML pode ser desenvolvido por uma cadeia de carac-
teres, pois o argumento para httpresponse é uma cadeia formada por
caracteres. Pelo código mostrado na Figura 12, podemos exemplificar este
caso de maneira relativamente simples. Substitua a função Index pelo código
citado, No entanto, as instruções from que o código já possui precisam ser
mantidas para se obter o funcionamento correto. Dessa forma, será gerada
uma resposta em HTML, utilizando o conteúdo de forma dinâmica, sendo que
este será atualizado sempre que o usuário atualizar a página no navegador.

Figura 12. Código que gera uma resposta em HTML, utilizando o conteúdo de forma
dinâmica.
Fonte: Etapa... (2018, documento on-line).

Assim que a alteração for exercida, o usuário pode realizar o teste de fun-
cionamento ao atualizar a página e observar se a hora na mensagem “Olá,
Django! Na quarta-feira, 09/10/2019, às 09:22:30” muda
conforme as atualizações na página e de acordo com o passar do tempo.

BORGES, L. E. Python para desenvolvedores: aborda Python 3.3. 3. ed. São Paulo: Novatec,
2014. 320 p.
 Integrando o Django ao Visual Studio 15

ETAPA 2: Criar um aplicativo do Django com modos de exibição e modelos de pá-

gina. Microsoft Docs, Redmond, 18 nov. 2018. Disponível em: https://docs.microsoft.
com/pt-br/visualstudio/python/learn-django-in-visual-studio-step-02-create-an-
-app?view=vs-2019. Acesso em: 24 out. 2019.
INSTALAR Visual Studio. Microsoft Docs, Redmond, 6 out. 2019. Disponível em: https://
docs.microsoft.com/pt-br/visualstudio/install/install-visual-studio?view=vs-2019. Acesso
em: 24 out. 2019.
MATTHES, E. Curso intensivo de Python: uma introdução prática e baseada em projetos
à programação. São Paulo: Novatec, 2016. 656 p.
MCKINNEY, W. Python para análise de dados. São Paulo: Novatec, 2018. 616 p.
SANTANA, O.; GALESI, T. Python e Django: desenvolvimento ágil de aplicações web.
São Paulo: Novatec, 2010. 280 p.
TUTORIAL: Introdução à estrutura da Web do Django no Visual Studio. Microsoft Docs,
Redmond, 18 nov. 2018. Disponível em: https://docs.microsoft.com/pt-br/visualstudio/
python/learn-django-in-visual-studio-step-01-project-and-solution?view=vs-2019.
Acesso em: 24 out. 2019.