Introdução ao Flask - Instalação

O Flask é um pequeno framework para a maioria dos padrões - pequeno o suficiente para ser chamado de “micro-framework” e pequeno o suficiente para que você possa ler e entender todo o seu código-fonte, mas isto não significa que faça menos que outros frameworks.

Ele foi projetado como uma estrutura extensível a partir do zero; Ele fornece um núcleo sólido com os serviços básicos, enquanto as extensões fornecem o restante. Porque você pode escolher os pacotes de extensão que você quer, você acaba com uma pilha enxuta que não tem inchaço e faz exatamente o que você precisa.

O Flask tem três dependências principais. Os subsistemas de roteamento, depuração e Web Server Gateway Interface (WSGI) são provenientes do Werkzeug; o suporte ao modelo é fornecido pelo Jinja2; e a integração de linha de comando vem do Click.

Essas dependências são todas de autoria de Armin Ronacher, o criador do Flask. O framework não tem suporte nativo para acessar bancos de dados, validar formulários da web, autenticar usuários ou outras tarefas de alto nível. Esses e muitos outros serviços importantes que a maioria dos aplicativos da Web precisam, estão disponíveis por meio de extensões que se integram aos pacotes principais.

Como desenvolvedor, você tem o poder de escolher as extensões que funcionam melhor para o seu projeto, ou até mesmo escrever as suas próprias, se você se sentir inclinado a fazê-lo. Isso está em contraste com uma estrutura maior, em que a maioria das opções foi feita para você e é difícil ou, às vezes, impossível de ser alterada. Neste artigo, você aprenderá como instalar o Flask. O único requisito é um computador com o Python instalado.

Nota

Os exemplos de código neste livro foram verificados para trabalhar com o Python 3.5 e 3.6. O Python 2.7 também pode ser usado se desejado, mas dado que esta versão do Python não será mantida após o ano de 2020, é altamente recomendado que você use as versões 3.x.

Nota

Se você planeja usar um computador com Microsoft Windows para trabalhar com o código de exemplo, é necessário decidir se deseja usar uma abordagem “nativa” com base nas ferramentas do Windows ou configurar seu computador de modo a permitir que você adote mais principal conjunto de ferramentas baseado em Unix. O código apresentado neste livro é amplamente compatível com as duas abordagens. Nos poucos casos em que as abordagens diferem, a solução Unix é seguida e as alternativas para o Windows são observadas.

Se você decidir seguir um fluxo de trabalho Unix, terá algumas opções. Se você estiver usando o Windows 10, poderá habilitar o Windows Subsystem para Linux (WSL), que é um recurso oficialmente suportado que cria uma instalação do Ubuntu Linux que é executada junto à interface nativa do Windows, fornecendo acesso a um shell bash e ao conjunto completo de ferramentas baseadas em Unix. Se o WSL não estiver disponível em seu sistema, outra boa opção é o Cygwin, um projeto de código aberto que emula o subsistema POSIX usado pelo Unix e fornece portas para um grande número de ferramentas Unix. 

Criando o diretório da aplicação

Para começar, você precisa criar o diretório que hospedará o código de exemplo, que está disponível em um repositório GitHub. A maneira mais conveniente de fazer isso é checando o código diretamente do GitHub usando um cliente Git. Os comandos a seguir baixam o código de exemplo do GitHub e inicializam o aplicativo para a versão 1a, que é a versão inicial com a qual você trabalhará:

$ git clone https://github.com/miguelgrinberg/flasky.git

$ cd flasky

$ git checkout 1a

Ambientes Virtuais

Agora que você criou o diretório de aplicativos, é hora de instalar o Flask. A maneira mais conveniente de fazer isso é usar um ambiente virtual. Um ambiente virtual é uma cópia do interpretador Python no qual você pode instalar pacotes de forma privada, sem afetar o interpretador Python global instalado em seu sistema. 

Os ambientes virtuais são muito úteis, pois evitam conflitos de pacotes e versões de pacotes no interpretador Python do sistema. A criação de um ambiente virtual para cada projeto garante que os aplicativos tenham acesso apenas aos pacotes que eles usam, enquanto o interpretador global permanece limpo e funciona apenas como uma fonte a partir da qual mais ambientes virtuais podem ser criados. Como benefício adicional, diferentemente do interpretador Python em todo o sistema, os ambientes virtuais podem ser criados e gerenciados sem direitos de administrador.

Criando um ambiente virtual com o Python 3

A criação de ambientes virtuais é uma área em que os intérpretes do Python 3 e do Python 2 diferem. Com o Python 3, os ambientes virtuais são suportados nativamente pelo pacote venv que faz parte da biblioteca padrão do Python.

Se você estiver usando o interpretador Python 3 padrão em um sistema Ubuntu Linux, o pacote venv padrão não será instalado por padrão. Para adicioná-lo ao seu sistema, instale o pacote python3-venv da seguinte forma:

$ sudo apt-get install python3-venv

O comando que cria um ambiente virtual possui a seguinte estrutura:

$ python3 -m venv virtual-environment-name

A opção -m venv executa o pacote venv da biblioteca padrão como um script autônomo, passando o nome desejado como um argumento. Agora, você criará um ambiente virtual dentro do diretório flasky. 

Uma convenção comumente usada para ambientes virtuais é chamá-los de venv, mas você pode usar um nome diferente, se preferir. Certifique-se de que seu diretório atual esteja configurado para flasky e, em seguida, execute este comando:

$ python3 -m venv venv

Após a conclusão do comando, você terá um subdiretório com o nome venv dentro de flasky, com um novo ambiente virtual que contém um interpretador Python para uso exclusivo deste projeto.

Criando um ambiente virtual com o Python 2

O Python 2 não possui um pacote venv. Nesta versão do interpretador Python, os ambientes virtuais são criados com o utilitário third-party virtualenv. 

Certifique-se de que seu diretório atual esteja definido como flasky e, em seguida, use um dos dois comandos a seguir, dependendo do sistema operacional. Se você estiver usando Linux ou macOS, o comando é:

$ sudo pip install virtualenv

Se você estiver usando o Microsoft Windows, certifique-se de abrir uma janela de prompt de comando usando a opção "Executar como administrador" e, em seguida, execute este comando:

$ pip install virtualenv

O comando virtualenv leva o nome do ambiente virtual como seu argumento. Certifique-se de que seu diretório atual esteja definido como flasky e, em seguida, execute o seguinte comando para criar um ambiente virtual chamado venv:

$ virtualenv venv

Um subdiretório com o nome venv será criado no diretório atual e todos os arquivos associados ao ambiente virtual estarão dentro dele.

Trabalhando com um ambiente virtual

Quando você quer começar a usar um ambiente virtual, você precisa ativá-lo. Se você estiver usando um computador Linux ou macOS, poderá ativar o ambiente virtual com este comando:

$ source venv/bin/activate

No Windows o comando é o seguinte:

$ venv\Scripts\activate

Quando um ambiente virtual é ativado, o local do interpretador Python é adicionado à variável de ambiente PATH na sessão de comando atual, que determina onde procurar arquivos executáveis. Para lembrá-lo de que você ativou um ambiente virtual, o comando de ativação modifica seu prompt de comando para incluir o nome do ambiente:

(venv) $

Depois que um ambiente virtual for ativado, digitar python no prompt de comando invocará o intérprete do ambiente virtual em vez do intérprete de todo o sistema. Se você estiver usando mais de uma janela de prompt de comando, terá que ativar o ambiente virtual em cada uma delas.

Nota

Embora a ativação de um ambiente virtual geralmente seja a opção mais conveniente, você também pode usar um ambiente virtual sem ativá-lo. Por exemplo, você pode iniciar um console Python para o ambiente virtual venv executando venv/ i /python no Linux ou macOS ou venv\Scripts\python no Microsoft Windows.

Quando terminar de trabalhar com o ambiente virtual, digite desativar no prompt de comando para restaurar a variável de ambiente PATH para sua sessão de terminal e o prompt de comando para seus estados originais.

Instalando Pacotes Python com pip 

Pacotes Python são instalados com o gerenciador de pacotes pip, que está incluído em todos os ambientes virtuais. Como o comando python, digitar pip em uma sessão do prompt de comando invocará a versão dessa ferramenta que pertence ao ambiente virtual ativado.

Para instalar o Flask no ambiente virtual, certifique-se de que o ambiente virtual venv esteja ativado e, em seguida, execute o seguinte comando :

(venv) $ pip install flask

Quando você executa este comando, o pip não só instalará o Flask, mas também todas as suas dependências. Você pode verificar quais pacotes estão instalados no ambiente virtual a qualquer momento usando o comando pip freeze:

(venv) $ pip freeze

A saída do pip freeze inclui números de versão detalhados para cada pacote instalado. Os números de versão que você obtém provavelmente serão diferentes dos mostrados aqui.

Você também pode verificar se o Flask foi instalado corretamente iniciando o interpretador Python e tentando importá-lo:

(venv) $ python

>>> import flask

>>>

Se nenhum erro aparecer, parabéns: você está pronto para o próximo artigo, onde você escreverá sua primeira aplicação web.