🛠️ Funções em Python

Este repositório é dedicado ao estudo, estruturação e boas práticas de Funções em Python. O conteúdo aborda desde a criação de subprogramas simples até conceitos avançados de engenharia de software utilizados no mercado de trabalho, como tipagem dinâmica e documentação padronizada.

---

💡 O que é uma Função?

Uma função é um bloco de código nomeado e autônomo, projetado para executar uma tarefa específica. Ela funciona como um subprograma que:

1. Recebe dados de entrada (parâmetros).
2. Processa as informações de forma isolada.
3. Opcionalmente, devolve um resultado (retorno).

O uso de funções é fundamental para evitar a repetição de código, modularizar sistemas e facilitar a manutenção e leitura do software.

---

🗂️ Conteúdo Prático do Repositório

O arquivo principal funcoes.py está estruturado didaticamente em seções fundamentais:

1. Declaração Simples e Parâmetros Padrão (Default Parameters)

Como criar funções básicas e definir valores de contingência padrão para parâmetros. Isso torna os argumentos opcionais no momento de chamar a função.

• Exemplo: calcular_area_do_retangulo(base=1, altura=1, comprimento=10)

2. Parâmetros Flexíveis e Retornos Múltiplos

Como o Python permite que uma única função retorne múltiplos valores de forma nativa (empacotados em uma tupla).

• Exemplo: analisar_numeros(a, b) (retorna a soma e o produto simultaneamente).

3. Empacotamento de Parâmetros (*args e **kwargs)

• *args: Permite que uma função receba um número dinâmico e ilimitado de argumentos posicionais.
• **kwargs: Permite que a função receba um número ilimitado de argumentos nomeados (chave/valor), mapeados como um dicionário.
• Funções Lambda: Expressões compactas e anônimas escritas em uma única linha para operações simples.

4. Boas Práticas da Indústria (Type Hinting & Docstrings)

Demonstração de padrões profissionais para construção de códigos limpos, legíveis e fáceis de documentar:

• Type Hinting (Tipagem de Dados): Especificação clara do tipo de dado esperado na entrada e do tipo de retorno (ex: list[float] -> float).
• Docstrings: Comentários estruturados que explicam o propósito da função, os parâmetros aceitos e o retorno.

5. Casos de Uso do Mundo Real

Exemplos práticos simulando situações reais do cotidiano de desenvolvimento:

• Validação de Entrada: Proteção e verificação lógica de idades em formulários de cadastro.
• Mecânica de Jogos: Cálculo físico de mitigação de dano sofrido por um personagem considerando atributos de vida e armadura.
• Formatação de Dados: Criação de perfis acadêmicos padronizados para integração com bancos de dados.

---

🚀 Como Executar o Projeto

Pré-requisitos

Certifique-se de ter o Python 3.x instalado. Você pode validar a instalação usando:

python --version

1. Clone esse repositório de forma local através do terminal:

git clone https://github.com/seu-usuario/funcoes-python.git

2. Acesse a pasta do repositório:

cd funcoes-python

3. Execute o script principal através do terminal ou clique em Run Python File:

python funcoes.py

---

🛡️ Diretrizes Aplicadas

Este repositório segue convenções estritas de desenvolvimento voltadas à qualidade do código:

• Legibilidade: Estrutura organizada seguindo os princípios de código limpo (Clean Code).

• Documentação robusta: Uso de Docstrings claras para guiar novos desenvolvedores.

• Segurança de tipos: Implementação de tipagem dinâmica indicativa (Type Hints) para prevenir erros em tempo de execução.

Desenvolvido como material para ajudar os alunos do projeto SuperTalentos