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.

  • Blinker fornece suporte para os Signals.

Dependências Opcionais

Estas distribuições não serão instaladas automaticamente. A Flask detetará e as usará se as instalarmos.

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

Ativar o ambiente

Antes de trabalharmos no nosso projeto, vamos ativar o ambiente correspondente:

$ . .venv/bin/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.