🚀 Capítulo 02: O Inventário do Minecraft

NOTE

Este capítulo utiliza a temática de Minecraft para explicar as Listas e Dicionários em Python. Aprenda a guardar muitos dados de forma organizada!


🎯 Objetivo da Aula

Compreender o conceito de Listas (arrays) e Dicionários (objetos chave-valor) em Python, aprendendo a manipular coleções de dados.

🏢 O Cenário Prático (Seu Desafio)

No jogo Minecraft, o personagem Steve pode carregar dezenas de itens diferentes em seu inventário: picaretas, blocos de terra, espadas e maçãs. Se fôssemos criar uma variável para cada item (item1, item2), o código ficaria gigante!

No Python, nós usamos as Listas para guardar uma sequência de coisas e os Dicionários para guardar informações detalhadas com nome e valor. É como se fosse o baú do Minecraft!


🧠 Fundamentos: A Teoria Traduzida

📦 1. Listas (Fila de Itens):

As listas são criadas com colchetes []. Os itens são guardados em ordem, começando da posição zero!

inventario = ["Picareta", "Espada", "Tocha"]
 
# Para pegar a Picareta (posição 0):
print(inventario[0])

🏷️ 2. Dicionários (Ficha com Nomes):

Os dicionários são criados com chaves {}. Em vez de números, você usa “chaves” (nomes) para acessar os valores.

bau = {
    "madeira": 64,
    "pedra": 32,
    "diamante": 5
}
 
# Para ver quantos diamantes eu tenho:
print(bau["diamante"])  # Retorna 5

📖 Exemplo Guiado: O Baú Cheio

Vamos criar um dicionário para representar o baú do Steve e mostrar a quantidade de um item:

bau_do_steve = {
    "ferro": 20,
    "ouro": 10,
    "maçã": 5
}
 
print("Eu tenho", bau_do_steve["ferro"], "barras de ferro no baú.")

🛠️ Prática Obrigatória 1: Criando a Lista

  1. Escreva o código em Python que cria uma lista chamada ferramentas contendo os textos: "Machado", "Pá" e "Enxada".

🛠️ Prática Obrigatória 2: Buscando no Baú

  1. Dado o dicionário itens = {"pedra": 64, "carvao": 16}, como você faria para imprimir na tela a quantidade de carvão?

📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)

Neste curso, você entregará suas atividades enviando o código para o seu repositório no GitHub usando o aplicativo GitHub Desktop. Siga o passo a passo detalhado:

  1. Verifique a estrutura: Certifique-se de que sua estrutura de pastas final está idêntica à mostrada abaixo.
  2. Abra o GitHub Desktop: Certifique-se de que o repositório do seu curso está selecionado no canto superior esquerdo.
  3. Visualize as alterações: Na aba Changes (à esquerda), você verá todos os arquivos que criou ou modificou nesta aula.
  4. Faça o Commit:
    • No campo Summary (na parte inferior esquerda), digite uma mensagem curta descrevendo o que fez, ex: Finaliza atividades do Capítulo.
    • Clique no botão azul Commit to main (ou o nome da sua branch).
  5. Envie para a Nuvem (Push): No topo da tela, clique no botão Push origin. Isso enviará seu código do seu computador para o seu perfil no GitHub.
  6. ⚠️ IMPORTANTE (Repositório Público): Para que o professor consiga corrigir, o seu repositório no GitHub DEVE SER PÚBLICO. Repositórios privados não podem ser visualizados por quem não foi convidado.
  7. Como entregar no Microsoft Teams:
    • Copie o link do seu repositório no GitHub (ex: https://github.com/seu-usuario/seu-repositorio).
    • Abra a tarefa correspondente no Microsoft Teams.
    • Clique no botão Adicionar trabalho (ou Add work).
    • Selecione a opção Link no menu lateral.
    • Cole o link do GitHub no campo “Endereço Web” e digite um texto (ex: Meu Repositório) no campo “Texto a ser exibido”.
    • Clique em Anexar.
    • MUITO IMPORTANTE: Clique no botão Entregar (ou Turn in) no canto superior direito para concluir o envio!

📂 Estrutura de Pastas

spec_backend_com_python_e_fastapi/
├── capitulos/
│   └── capitulo_02_minecraft.md

💡 Checkpoint de Lógica

Em Python, as listas podem mudar de tamanho a qualquer momento! Você pode adicionar um item novo usando o comando .append(), como em: inventario.append("Flecha").

🔥 Desafio de Fixação (Opcional)

Pesquise como remover um item de uma lista em Python pelo nome dele.

🔑 Gabarito de Código/Fórmulas

Gabarito da Prática 1:

ferramentas = ["Machado", "Pá", "Enxada"]

Gabarito da Prática 2:

print(itens["carvao"])

Capitulo Anterior | Proximo Capitulo