Começando com o Framework Web Flask

Beginner

This tutorial is from open-source community. Access the source code

Introdução

Este laboratório irá guiá-lo através do processo de como começar com Flask, um framework web leve para Python. Você aprenderá como criar uma aplicação Flask básica, executá-la localmente e entender os conceitos básicos de roteamento (routing) e renderização de templates.

Nota: Você precisa criar o arquivo de código você mesmo e executá-lo no ambiente. Você pode visualizar o status do serviço Flask na Web 5000.

Configurando o Flask

Para começar com o Flask, você precisa instalá-lo e configurar um novo projeto. Siga as instruções abaixo:

  1. Instale o Flask executando o seguinte comando no seu terminal ou prompt de comando:

    pip install flask
  2. Abra um novo arquivo e salve-o como app.py.

    cd ~/project
    touch app.py
  3. Importe o módulo Flask e crie uma instância da classe Flask:

    from flask import Flask
    
    app = Flask(__name__)

Criando uma Rota Básica

Rotas (Routes) no Flask definem os padrões de URL para sua aplicação. Vamos criar uma rota básica que exibe a mensagem "Hello, World!".

  1. Adicione o seguinte código ao seu arquivo app.py:

    @app.route("/")
    def hello_world():
        return "Hello, World!"
  2. Salve o arquivo.

Executando a Aplicação

Agora que você configurou sua aplicação Flask e criou uma rota básica, vamos executar a aplicação e vê-la em ação.

  1. No seu terminal ou prompt de comando, navegue até o diretório onde seu arquivo app.py está localizado.

  2. Execute o seguinte comando para iniciar o servidor de desenvolvimento Flask:

    flask run --host=0.0.0.0

--host=0.0.0.0 é usado para tornar a aplicação publicamente disponível. Se você não especificar isso, a aplicação estará disponível apenas na sua máquina local.

Em seguida, mude para a aba Web 5000 e atualize a página.

Adicionando Templates HTML

Flask usa templates Jinja2 para gerar conteúdo HTML. Vamos criar um arquivo de template e renderizá-lo em nossa rota.

  1. Crie um novo diretório em seu projeto chamado templates.

  2. Dentro do diretório templates, crie um novo arquivo chamado index.html.

  3. Abra o arquivo index.html e adicione o seguinte código HTML:

    <!doctype html>
    <html>
      <head>
        <title>Flask Quickstart</title>
      </head>
      <body>
        <h1>Hello, Flask!</h1>
      </body>
    </html>
  4. Modifique seu arquivo app.py para renderizar o template index.html:

    from flask import render_template
    
    @app.route("/")
    def hello_world():
        return render_template("index.html")

Executando a Aplicação Novamente

Agora que adicionamos um template HTML, vamos executar a aplicação novamente e ver o template renderizado.

  1. Pare o servidor de desenvolvimento Flask se ele ainda estiver em execução (pressione Ctrl+C).

  2. Execute o seguinte comando para iniciar o servidor novamente:

    flask run --host=0.0.0.0

Você agora deve ver a mensagem "Hello, Flask!" exibida no template HTML.

Hello, Flask!

Adicionando Conteúdo Dinâmico

Flask nos permite passar conteúdo dinâmico para nossos templates. Vamos modificar nossa rota para passar um parâmetro nome (name) e exibir uma saudação personalizada.

  1. Modifique seu arquivo app.py para aceitar um parâmetro nome na rota:

    @app.route("/<name>")
    def hello(name):
        return render_template("index.html", name=name)
  2. Abra o arquivo index.html e modifique a tag <h1> para exibir a saudação personalizada:

    <h1>Hello, {{ name }}!</h1>

Executando a Aplicação Novamente

Vamos executar a aplicação novamente e testar o recurso de conteúdo dinâmico.

  1. Pare o servidor de desenvolvimento Flask se ele ainda estiver em execução (pressione Ctrl+C).

  2. Execute o seguinte comando para iniciar o servidor novamente:

    flask run --host=0.0.0.0
  3. Copie a URL da aba Web 5000 e cole-a em uma nova aba no seu navegador.

    Copiando a URL da Web 5000
  4. Adicione /LabEx ao final da URL e pressione Enter.

    Página web Hello LabEx
  5. Altere o valor do parâmetro name na URL e pressione Enter.

Resumo

Neste laboratório, você aprendeu como começar com Flask, configurando um novo projeto, criando rotas (routes), renderizando templates e passando conteúdo dinâmico. Flask é uma ferramenta poderosa para construir aplicações web, e este laboratório fornece uma base sólida para exploração e desenvolvimento futuros.