Do primeiro algoritmoao primeiro pull request.

Objetivo: confirmar que Python e Git estão disponíveis e criar uma pasta de trabalho.

Verifique as ferramentas

python --version
git --version

mkdir projeto-media
cd projeto-media

Objetivo: decompor um problema em entradas, transformação e saída antes de escrever sintaxe.

Três formas de fluxo

• Sequência: instruções executadas em ordem.
• Decisão: um caminho escolhido por uma condição.
• Repetição: um bloco executado para vários itens.

receber notas
se não houver notas:
    informar que faltam dados
senão:
    para cada nota:
        somar nota ao total
    dividir total pela quantidade
    mostrar média

Objetivo: combinar variáveis, tipos, condição, repetição e função em um programa pequeno.

Primeira execução

nome = input("Como você se chama? ")
print(f"Olá, {nome}!")

Salve como programa.py e execute python programa.py. input devolve texto; por isso, números recebidos precisam de conversão explícita.

Tipos e decisões

media = 7.5

if media >= 7:
    print("Aprovado")
else:
    print("Revisar conteúdo")

Função de média

def calcular_media(notas):
    if not notas:
        return 0
    return sum(notas) / len(notas)


entrada = input("Notas separadas por espaço: ")
notas = [float(item) for item in entrada.split()]
media = calcular_media(notas)
print(f"Média: {media:.1f}")

Objetivo: usar a mensagem de erro para localizar, explicar e corrigir uma falha.

Erro de sintaxe impede a leitura do código; erro de execução ocorre durante o uso; erro de lógica produz um resultado incorreto.

try:
    entrada = input("Notas separadas por espaço: ")
    notas = [float(item) for item in entrada.split()]
except ValueError:
    print("Use apenas números separados por espaço.")

Rotina de depuração

1. Reproduza o erro.
2. Leia a última linha da mensagem.
3. Localize a primeira linha do seu arquivo citada.
4. Formule uma hipótese pequena.
5. Altere uma coisa por vez.
6. Execute novamente e reteste o que já funcionava.

Teste rápido da regra

assert calcular_media([6, 8]) == 7
assert calcular_media([]) == 0

Objetivo: criar um repositório local e produzir um histórico legível com pelo menos dois commits.

git config --global user.name "Seu Nome"
git config --global user.email "seu-email@example.com"

git init -b main
git status
git add programa.py
git diff --staged
git commit -m "Cria calculadora de média"
git log --oneline

Crie um README.md com objetivo e instruções de execução. Registre-o em outro commit:

git add README.md
git diff --staged
git commit -m "Documenta como executar o programa"

Objetivo: conectar um remoto, publicar uma branch e abrir um pull request verificável.

Git registra versões localmente. GitHub hospeda repositórios Git e acrescenta colaboração, revisão, issues, Actions e Pages.

git remote add origin https://github.com/SEU-USUARIO/projeto-media.git
git remote -v
git push -u origin main

git switch -c feat/classificacao
# edite e teste programa.py
git add programa.py
git commit -m "Adiciona classificação pela média"
git push -u origin feat/classificacao

Descrição mínima do pull request

## Objetivo
Mostrar uma orientação após o cálculo da média.

## Mudanças
- adiciona classificação com limite 7;
- mantém o cálculo existente.

## Como verifiquei
- [x] média 8 mostra "aprovado";
- [x] média 6 mostra "revisar conteúdo";
- [x] entrada inválida continua tratada.

Objetivo: resolver um conflito simples e trabalhar sem expor credenciais.

Conflito é uma decisão, não um defeito

<<<<<<< HEAD
conteúdo da branch atual
=======
conteúdo da outra branch
>>>>>>> outra-branch

Leia as duas propostas, produza o resultado correto, remova todas as marcações, execute o programa e então registre a resolução.

git add programa.py
git commit -m "Resolve conflito na mensagem de resultado"

Autenticação atual

O GitHub não aceita senha da conta para operações Git via HTTPS. Para iniciantes, prefira gh auth login com navegador ou Git Credential Manager. Use token pessoal apenas quando necessário, com prazo e permissões mínimas.

# .gitignore
.env
.venv/
__pycache__/
*.pyc

• ative 2FA e guarde os códigos de recuperação;
• nunca coloque token em código, README ou captura de tela;
• revise git diff --staged antes do commit;
• se um segredo for publicado, revogue-o imediatamente.

Entrega: programa documentado, testado, desenvolvido em branch e integrado por pull request.

projeto-media/
├── .gitignore
├── README.md
├── programa.py
└── test_programa.py

def calcular_media(notas):
    if not notas:
        return 0
    return sum(notas) / len(notas)


def classificar(media, limite=7):
    return "aprovado" if media >= limite else "revisar conteúdo"


try:
    entrada = input("Notas separadas por espaço: ")
    notas = [float(item) for item in entrada.split()]
    media = calcular_media(notas)
    print(f"Média: {media:.1f}")
    print(f"Situação: {classificar(media)}")
except ValueError:
    print("Entrada inválida. Use apenas números separados por espaço.")

from programa import calcular_media, classificar

assert calcular_media([6, 8]) == 7
assert calcular_media([]) == 0
assert classificar(7) == "aprovado"
assert classificar(6.9) == "revisar conteúdo"