Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Neste início rápido, você segue as etapas guiadas para criar rapidamente um aplicativo Flask usando um modelo de projeto interno do Python. O Visual Studio facilita o desenvolvimento de projetos do Python com código clichê e funcionalidade em modelos para várias estruturas do Python, incluindo Flask, Django e Bottle. O projeto python descrito neste artigo é semelhante ao projeto que você cria manualmente por meio do Início Rápido: Criar um aplicativo Web com o artigo do Flask .
Pré-requisitos
Visual Studio instalado com suporte para cargas de trabalho do Python.
No Instalador do Visual Studio, selecione a carga de trabalho de desenvolvimento do Python e a opção de suporte da Web do Python para acesso aos modelos de projeto Web. Para obter mais informações, consulte Instalar o suporte do Python no Visual Studio.
Não há suporte para o Visual Studio para Mac. O Visual Studio Code no Windows, Mac e Linux funciona bem com o Python por meio de extensões disponíveis.
Criar o projeto
Siga este procedimento para criar uma solução do Visual Studio e um novo projeto Web do Flask:
No Visual Studio, selecione Arquivo>Novo>Projeto e pesquise "Flask". Selecione o modelo Projeto Web Flask em Branco e selecione Avançar.
O Visual Studio exibe a caixa de diálogo de configuração do projeto. Insira um nome para o projeto e selecione Criar. Você pode deixar os outros campos definidos como padrões.
Após um momento, o Visual Studio exibe um prompt sobre como lidar com dependências de pacote. O prompt é diferente com base em se você já tem dependências de pacote instaladas.
A caixa de diálogo Este projeto requer pacotes externos. Indica que o modelo selecionado inclui um arquivo requirements.txt que especifica dependências no pacote Flask. O Visual Studio pode instalar os pacotes automaticamente, o que oferece a opção de instalar os pacotes em um ambiente virtual. É recomendável usar um ambiente virtual em vez de instalar em um ambiente global.
Se você receber essa caixa de diálogo, selecione a opção Instalar em um ambiente virtual :
Como alternativa, você pode ver o prompt "arquivo de especificação do pacote Python 'requirements.txt' foi detectado no projeto <Nome do Projeto>" na parte superior da janela do Visual Studio. Esse prompt indica que as dependências do pacote já estão disponíveis em sua configuração. O Visual Studio pode criar um ambiente virtual para você a partir da configuração existente.
Se você vir esse prompt, selecione a opção Criar ambiente virtual :
O Visual Studio exibe a caixa de diálogo Adicionar ambiente . Aceite os valores padrão e selecione Criar e, em seguida, consenta com quaisquer solicitações de elevação.
Dica
Quando você começa um projeto, é altamente recomendável criar um ambiente virtual imediatamente, pois a maioria dos modelos do Visual Studio convida você a fazer. Os ambientes virtuais mantêm os requisitos exatos do projeto ao longo do tempo à medida que você adiciona e remove bibliotecas. Em seguida, você pode gerar facilmente um arquivo requirements.txt , que você usa para reinstalar essas dependências em outros computadores de desenvolvimento (como ao usar o controle do código-fonte) e ao implantar o projeto em um servidor de produção. Para obter mais informações sobre ambientes virtuais e seus benefícios, consulte Usar ambientes virtuais e Gerenciar pacotes necessários com requirements.txt.
Examinar o código de texto clichê
Nesta seção, você examinará o código clichê no arquivo de projeto flask (.py) que o Visual Studio cria para o modelo selecionado.
Abra o Gerenciador de Soluções para exibir a solução e os arquivos de projeto do Flask. O projeto inicial contém apenas dois arquivos, app.py e requirements.txt:
O arquivo requirements.txt especifica as dependências do pacote Flask. A presença desse arquivo é o que convida você a criar um ambiente virtual ao criar o projeto pela primeira vez.
O único arquivo app.py contém o código padrão para um projeto web Flask em branco. O modelo fornece código semelhante às descrições no Início Rápido – Criar um aplicativo Web com o artigo do Flask , com algumas seções adicionadas.
Abra o arquivo app.py no editor e examine a seção superior.
O código começa com uma instrução
importpara o pacote Flask. Essa instrução cria uma instância daFlaskclasse, que é atribuída à variávelapp:from flask import Flask app = Flask(__name__)Em seguida, o código atribui a
wsgi_appvariável, que é útil quando você implanta o aplicativo Flask em um host Web:# Make the WSGI interface available at the top level so wfastcgi can get it. wsgi_app = app.wsgi_appA seção intermediária atribui uma função a uma rota de URL, o que significa que a função fornece o recurso identificado pela URL. Nesse caso, a rota define uma visão.
@app.route('/') def hello(): """Renders a sample page.""" return "Hello World!"Você define rotas usando o decorador
@app.routedo Flask com um argumento que é a URL relativa da raiz do site. Como você pode ver no código, a função retorna apenas uma cadeia de caracteres de texto, o que é suficiente para um navegador renderizar.A seção inferior contém código opcional para iniciar o servidor de desenvolvimento do Flask. Você pode definir o host e a porta por meio de variáveis de ambiente em vez de codificá-las. Esse código permite que você controle facilmente a configuração em computadores de desenvolvimento e produção sem alterar o código:
if __name__ == '__main__': import os HOST = os.environ.get('SERVER_HOST', 'localhost') try: PORT = int(os.environ.get('SERVER_PORT', '5555')) except ValueError: PORT = 5555 app.run(HOST, PORT)Selecione Debug>Iniciar sem Depuração para executar o aplicativo Flask e abrir um navegador para o host e porta padrão,
localhost:5555.
Explorar modelos do Python no Visual Studio
Quando você instala a carga de trabalho do Python, o Visual Studio fornece vários modelos de projeto para as estruturas web Flask, Bottle e Django e serviços de nuvem do Azure. Há também modelos para diferentes cenários de aprendizado de máquina e um modelo para criar um projeto a partir de uma estrutura de pastas existente que contém um aplicativo Python. Você pode acessar os modelos usando a opção de menu Arquivo>Novo>Projeto . Selecione o nó da linguagem Python e seus nós filhos para ver os modelos disponíveis.
O Visual Studio também fornece vários modelos de arquivo ou item para criar rapidamente uma classe Python, um pacote Python, um teste de unidade do Python , arquivosweb.config e muito mais. Quando um projeto do Python está aberto, você acessa modelos de item usando a opção de menuAdicionar Novo Item do >. Para obter mais informações, consulte a referência de modelos de item .
Usar modelos pode economizar tempo significativo ao iniciar um projeto ou criar um arquivo. Eles também são uma ótima maneira de aprender sobre diferentes tipos de aplicativo e estruturas de código. É útil levar alguns minutos para criar projetos e itens dos vários modelos para se familiarizar com o que eles oferecem.
Usar modelos do Cookiecutter
O Visual Studio fornece integração direta com o Cookiecutter para ajudá-lo a descobrir modelos, opções de modelo de entrada e criar projetos e arquivos. Para obter mais informações, consulte o Início Rápido: Criar um projeto a partir de um artigo de modelo do Cookiecutter .