Primeiros passos no Flask

Lâmpada mágica

Nestes primeiros passos no Flask vamos explorar a programação web utilizando o micro framework Flask. Primeiramente, nos concentraremos em entender os conceitos iniciais e, logo depois, adicionaremos comentários de forma sequencial para facilitar o aprendizado e a aplicação prática.

Para começar, antes de qualquer outro passo, crie seu projeto e, em seguida, instale o Python e o Flask. Além disso, é importante garantir que todas as configurações básicas estejam funcionando corretamente para evitar problemas mais adiante. Todos os exemplos apresentados neste post foram cuidadosamente baseados no site oficial do Flask, o que, consequentemente, assegura a confiabilidade do conteúdo que você estará estudando.

No Flask, diferentemente de outras ferramentas, criamos nossas rotas manualmente utilizando o decorador @app.route(). Esse processo, embora simples, é essencial para o funcionamento correto do aplicativo e, por isso, será abordado em mais detalhes a seguir.

Home

‘ @app.route(“/hello”) def hello_world(): return ”

Hello, World!

” @app.route(“/”) def hello_name(name): return f”

Hello, {escape(name)}!

” # Executa o aplicativo LOCALMENTE (localhost) na porta 5000 if __name__ == ‘__main__’: app.run(host=’127.0.0.1′, port=5000) “”” Resultados: Vejamos as Rotas: “http://127.0.0.1:5000/” veremos um texto “Home”, “http://127.0.0.1:5000/hello” veremos “Hello, World”, “http://127.0.0.1:5000/Pedro” veremos “Hello, Pedro” “””

No último exemplo, utilizamos o escape, que permite enviar um parâmetro ao servidor de maneira simples. Por exemplo, ao escrever “Pedro” na URL, recebemos a concatenação “Hello, ” + “Pedro”. Contudo, é essencial destacar que esse método, conforme apresentado, não é seguro. É necessário criptografar as informações antes de enviá-las pela rede. Em um próximo post, discutiremos como criptografar e descriptografar dados de forma eficaz.

Conclusão:

No post “Páginas Estáticas e Dinâmicas com CSS Global no Flask“, exploraremos a estilização e a utilização de modelos HTML. O objetivo do estudo com Flask é compreender o funcionamento de um servidor de Back-End, seja por API ou integração com bases de dados, permitindo interação direta com o Front-End.

Sugiro estudar o Front-End utilizando o Next.js, que facilita a criação de bibliotecas de componentes React e rotas dinâmicas. Além disso, dominar a criação de páginas no servidor Back-End, mesmo diretamente no Flask, permitirá o desenvolvimento de páginas administrativas e a futura apresentação de tabelas dinâmicas com informações provenientes do servidor.

Referências:

Publicidade – Livros da Amazon:

Funções e módulos em Python

módulos

Criar suas funções é a chave para a sucesso. Vamos ver algumas das opções de parâmetros de entrada de uma função e em outro post vamos falar em criar seus módulos (Conjunto de funções).

Comente suas funções com docstrings

Para acessar a informação help() das suas funções em Python, você precisa adicionar docstrings (documentação inline) ao seu código. Após as configurações docstrings no prompt de comando tente usar help(saudacao) para ter acesso ao help da sua função.

O exemplo acima é uma função que não tem parâmetros de entrada, apenas imprime uma informação. Ao comentar suas funções com aspas triplas você poderá consulta-las em help() e poderá gerar a documentação com pydoc.

Valor Default

No exemplo acima nome é um campo não obrigatório que caso não seja informado será atribuído o valor default “Mundo” e imprime o resultado.

 

Definindo Tipo no parâmetro de entrada

Type hints não são obrigatórios (Python continua dinâmico), mas são altamente recomendados para:

  • Projetos de médio/grande porte

  • Código que será mantido por outras pessoas

  • Bibliotecas e APIs públicas

  • Times de desenvolvimento

  • Prevenção de bugs antes do runtime

Contudo em pequenos ou médios projetos não é interessante o uso de type hints.

Retornando o valor

No exemplo acima a função retornou 5, pois usamos o método return, também definimos que os parâmetros de entrada devem ser do tipo float;

Passando um parâmetro obrigatório e outro opcional em uma função

 

Passando número arbitrários de parâmetros

Passando um Dicionário

 

Dicionário é um tipo de dado mais complexo que farei um post separadamente. A princípio você deve saber que ele existe, e nele temos campos com propriedades chave e valor.

Retornando um Dicionário

Passando uma Função para outra Função