Como Fazer uma Calculadora Simples em Python - Comentar código

No tutorial passado de nossa Apostila de Python, aprendemos a somar, subtrair, dividir, multiplicar, exponenciar e achar o resto da divisão, de dois números quaisquer.

Propusemos que você criasse uma calculadora em Python, que pede ao usuário dois números e exiba todas as operações da seguinte maneira:

Agora vamos mostrar a solução desse exercício, de duas maneiras.
Mas, antes, precisamos aprender algo essencial em programação: comentar um código

Comentar um Código - Caractere #

Uma das coisas mais essenciais que você precisa aprender em programação, é comentar seu código.

"Lá vai o Python, começa a executar. Python toca pra variável, a variável chama a input, a input passa pra função int que cruza pra função print e exibe o resultado na tela, é gol!"

Não, nada a ver, você não vai comentar nem narrar nada.
Comentar é escrever coisas no seu código, em sua língua (português, inglês...) de modo que quem vai ver o código, consiga ler algo.

Vamos voltar no tempo e digitar o Hello, World.
Escreva e rode:

# O programa abaixo exibe uma mensagem na tela
print("Hello, World!")

Note que tem algo diferente. Na primeira linha.
Escrevemos o símbolo de jogo da velha e escrevemos algo.
Porém, quando vamos rodar nosso script, essa linha não aparece.

É isso que é um comentário: uma linha que começa com o caractere #
O Python simplesmente ignora tudo que começa com #

Pode colocar qualquer coisa, qualquer comando, até uma letra da Xuxa depois de # que o Python não vai ler, não vai rodar aquela linha nem vai aparecer nada no interpretador.

Agora pode parecer bobagem usar isso, mas a medida que seus programas forem ficando enormes, complexos e difíceis, é altamente recomendável que você vá comentando seu código, tipo

# Aqui estamos conectando com o site da NASA
[código]

# Agora vamos tentar invadir o sistema da NASA
[código]

# Tendo acesso ao banco de dados da NASA
[código]

# O código a seguir começa a baixar arquivos secretos da NASA
[código]

# Caceta! Fudeu! Me pegaram

Isso ajuda a você quando ver o código de novo, a entender o que cada parte do código está fazendo, para que serve. Ok ?
Sempre comente seus códigos!

Vamos dar um exemplo agora de código comentado, fazendo a calculadora em Python.

Calculadora Simples em Python

O código de nossa calculadora, todo bonitinho, organizado e comentado ficou assim:

# Inicialmente, pedimos os dois números para o usuário
# Vamos transformar ele em float
var1 = float( input("Digite um numero: ") )
var2 = float( input("Digite outro numero: ") )

# Calculando a soma e armazenando na variável 'soma'
soma = var1 + var2

# Calculando a subtração e armazenando na variável 'subtracao'
subtracao = var1 - var2

# Calculando a multiplicação e armazenando na variável 'mult'
mult = var1 * var2

# Calculando a divisão e armazenando na variável 'div'
div = var1 / var2

# Calculando a exponenciação e armazenando na variável 'expo'
expo = var1 ** var2

# Calculando o resto da divisão e armazenando na variável 'resto'
resto = var1 % var2

# Imprimindo tudo
print('Soma:             ', var1,'+',var2,' = ' , soma)
print('Subtração:        ', var1,'-',var2,' = ' , subtracao)
print('Multiplicação:    ', var1,'*',var2,' = ' , mult)
print('Divisão:          ', var1,'/',var2,' = ' , div)
print('Exponenciação:    ', var1,'**',var2,' = ', expo)
print('Resto da divisão: ', var1,'%',var2,' = ' , resto)

E o seu ?
Coloque seu código nos comentários.

Código Menor da Calculadora em Python

Uma das coisas mais comuns de ocorrer com quem está começando a programar, é criar códigos longos, bagunçados e confusos.

As vezes você programa 200 linhas de código para fazer algo.
Aí vem um filho de uma mãe e faz um código melhor, sem erros, mais organizado, que roda mais rápido e usando apenas 30 linhas.

Dá uma raiva...mas, calma. É assim mesmo no começo.
O código a seguir é o mesmo da calculadora, porém ele é menor, roda mais rápido e consome menos memória, pois usamos apenas duas variáveis 'var1' e a 'var2':

# Recebe dados do usuário
var1 = float( input("Digite um numero: ") )
var2 = float( input("Digite outro numero: ") )

# Imprime o resultado das operações direto na função print
print('Soma:             ', var1,'+',var2,' = ' , var1+var2)
print('Subtração:        ', var1,'-',var2,' = ' , var1-var2)
print('Multiplicação:    ', var1,'*',var2,' = ' , var1*var2)
print('Divisão:          ', var1,'/',var2,' = ' , var1/var2)
print('Exponenciação:    ', var1,'**',var2,' = ', var1**var2)
print('Resto da divisão: ', var1,'%',var2,' = ' , var1%var2)

Bacana, não é verdade?