Instalação¶
Versão da Python¶
Nós recomendamos usar a versão mais recente da Python. A Flask suporta a Python 3.8 e as mais recentes.
Dependências¶
Estas distribuições serão instaladas automaticamente quando instalares a Flask.
Werkzeug implementa a WSGI, a interface da Python padrão entre as aplicações e servidores.
Jinja é uma linguagem de modelo de marcação que desenha as páginas que a tua aplicação serve.
MarkupSafe vem com a Jinja. Ela escapa entradas duvidosas quando geramos os modelos de marcação para evitar ataques de injeção.
ItsDangerous assina com segurança o dado para garantir sua integridade. Isto é usado para proteger o cookie da sessão da Flask.
Click é uma abstração para escrita de aplicações de linha de comando. Ela fornece o comando
flask
e permite adicionar comandos de gestão personalizados.
Dependências Opcionais¶
Estas distribuições não serão instaladas automaticamente. A Flask detetará e as usará se as instalarmos.
python-dotenv ativa suporte para a Environment Variables From dotenv quando executamos os comandos da
flask
.Watchdog fornece um recarregador mais rápido e mais eficiente para o servidor de desenvolvimento.
greenlet¶
Nós podemos escolher usar gevent
ou eventlet
com a nossa aplicação. Neste caso, greenlet>=1.0
é obrigatório. Quando usamos PyPY, PyPy>=7.3.7
é obrigatório.
Estas não sãos as versões mínimas suportadas, apenas indicam as primeiras versões que adicionaram funcionalidades necessárias. Nós deveríamos usar as versões mais recentes de cada.
Ambientes Virtuais¶
Nós devemos sempre usar um ambiente virtual para gerir as dependências para o nosso projeto, tanto em desenvolvimento como em produção.
Qual problema um ambiente virtual soluciona? Quanto mais projetos de Python temos, mais provavelmente é que precisaremos de trabalhar com diferentes versões de bibliotecas de Python, ou mesmo a própria Python. As versões mais novas de bibliotecas para um projeto pode quebrar a compatibilidade em um outro projeto.
Os ambientes virtuais são grupos independentes de bibliotecas da Python, um para cada projeto. Os pacotes instalados para um projeto não afetarão outros projetos ou os pacotes do sistema operativo.
A Python vem empacotada com o módulo venv
para criar ambientes virtuais:
Criar um Ambiente¶
Criar uma pasta de projeto e um pasta .venv
dentro dela:
$ mkdir myproject
$ cd myproject
$ python3 -m venv .venv
> mkdir myproject
> cd myproject
> py -3 -m venv .venv
Ativar o ambiente¶
Antes de trabalharmos no nosso projeto, vamos ativar o ambiente correspondente:
$ . .venv/bin/activate
> .venv\Scripts\activate
O nosso pronto da shell mudará para mostrar o nome do ambiente ativado.
Instalação da Flask¶
Dentro do ambiente ativado, usamos o seguinte comando para instalar a Flask:
$ pip install Flask
A Flask agora está instalada. Consulte a Introdução Rápida ou siga para a Perspetiva geral da documentação.