Ler código, o mínimo: variáveis, funções e erros

O agente escreve no ecrã: «Alterei a função preco_encomenda no ficheiro loja.py e corrigi o erro da linha 8.» E pede-te licença para gravar.

Se não souberes o que é uma função nem onde está a linha 8, só te resta dizer que sim e ter fé. Esta lição não te ensina a programar. Ensina-te o mínimo para perceberes o que o agente te mostra e para decidires com os olhos abertos.

Dez linhas de Python

Uma encomenda na padaria:

# Preço de uma encomenda na padaria
preco_papo_seco = 0.25

def preco_encomenda(quantidade):
    # Multiplica a quantidade pelo preço de cada um
    return quantidade * preco_papo_seco

total = preco_encomenda(12)
print("Doze papo-secos custam", total, "euros")

Quando corre, escreve: Doze papo-secos custam 3.0 euros.

Há quatro peças aqui:

• Comentário: as linhas que começam por #. São notas para pessoas. O computador salta-as.
• Variável: preco_papo_seco = 0.25 guarda o valor 0.25 com aquele nome. É uma caixa com etiqueta. O sinal = quer dizer «guarda», não «é igual».
• Função: o bloco que começa em def. Tem um nome (preco_encomenda), recebe um ingrediente (quantidade) e devolve um resultado (return). É uma receita escrita uma vez e usada muitas.
• Chamada: preco_encomenda(12) usa a receita com 12 papo-secos. O resultado fica guardado noutra variável, total.

Em Python, os espaços no início das linhas contam: é assim que se sabe o que pertence à função.

O mesmo em JavaScript

// Preço de uma encomenda na padaria
const precoPapoSeco = 0.25;

function precoEncomenda(quantidade) {
  // Multiplica a quantidade pelo preço de cada um
  return quantidade * precoPapoSeco;
}

const total = precoEncomenda(12);
console.log("Doze papo-secos custam", total, "euros");

As mesmas quatro peças, com outra roupa. O comentário começa por //. A variável leva const antes do nome. A função começa por function e o que lhe pertence fica entre chavetas { }. As linhas acabam em ;. E os nomes juntam as palavras com maiúsculas (precoPapoSeco) em vez de traços (preco_papo_seco).

Ler uma mensagem de erro

Imagina que alguém escreveu preco_encomenda(doze) em vez de preco_encomenda(12). O Python responde:

Traceback (most recent call last):
  File "/Users/graca/experiencias/loja.py", line 8, in <module>
    total = preco_encomenda(doze)
                            ^^^^
NameError: name 'doze' is not defined

Parece assustador, mas lê-se de baixo para cima:

1. Última linha: o que correu mal. NameError: name 'doze' is not defined quer dizer «não conheço nada chamado doze». O computador não sabe que «doze» é 12; só conhece as variáveis que foram criadas.
2. Logo acima: a linha culpada, com setas ^^^^ debaixo da parte que falhou.
3. Mais acima: o ficheiro e o número da linha. loja.py, linha 8.

Em JavaScript a arrumação muda um pouco: o erro (ReferenceError: doze is not defined) aparece a meio, e o sítio aparece em cima e nas linhas que começam por at, no formato loja.js:9:30 (ficheiro, linha 9, coluna 30). A ideia é a mesma: o que correu mal, em que ficheiro, em que linha.

O diff: o mais importante deste curso

Um diff mostra o que mudou entre duas versões de um ficheiro. É como as «alterações controladas» do Word, mas em texto:

 # Preço de uma encomenda na padaria
-preco_papo_seco = 0.25
+preco_papo_seco = 0.30

• Linha com − (muitas vezes a vermelho): sai.
• Linha com + (muitas vezes a verde): entra.
• Linha sem sinal: fica igual. Está lá só para te situares.

Aqui o preço do papo-seco passou de 0.25 para 0.30. Mais nada.

Porque é que isto é o mais importante? Porque um agente pode escrever trezentas linhas num minuto, e tu não vais ler trezentas linhas. Mas vais ler o diff do que ele quer mudar, antes de dizeres que sim. O diff é o momento em que és tu que mandas. Nas próximas lições vais vê-lo muitas vezes.

 def preco_encomenda(quantidade):
-    # Multiplica a quantidade pelo preço de cada um
+    # Dúzia de padeiro: quem leva 13 ou mais paga menos um
+    if quantidade >= 13:
+        quantidade = quantidade - 1
     return quantidade * preco_papo_seco

Antes de aplicar, explica-me este diff em português simples: o que sai, o que entra e porquê. Não alteres nada ainda.