Compreendendo Instruções, Indentação e Comentários em Python

Este tutorial fornece uma compreensão fundamental de instruções, indentação e comentários em Python – elementos cruciais para escrever código limpo, eficiente e fácil de manter.

Sumário

1. Instruções Python
2. Indentação Python
3. Comentários Python

Instruções Python

Em Python, uma instrução é uma única ordem executada pelo interpretador. Embora geralmente ocupe uma única linha, instruções longas podem se estender por várias linhas usando continuação de linha (barras invertidas ou parênteses ()). As instruções incluem atribuições, chamadas de funções, loops e instruções condicionais.

Exemplos:

• Atribuição: x = 10 (atribui 10 a x)
• Chamada de Função: print("Olá!")
• Instrução Condicional:

  
  if x > 5:
      print("x é maior que 5")
  else:
      print("x não é maior que 5")
  

• Instrução de Loop:

  
  for i in range(5):
      print(i)
  

Indentação Python

Ao contrário de linguagens que usam chaves {} para definir blocos de código, Python usa indentação. Isso determina o agrupamento de instruções dentro de blocos (if, else, for, while, funções, classes). Indentação consistente é obrigatória; inconsistências causam IndentationError.

Indentação Correta:

if x > 5:
    print("x é maior que 5")
    y = x * 2
else:
    print("x não é maior que 5")

Indentação Incorreta:

if x > 5:
print("x é maior que 5")  # IndentationError
y = x * 2
else:
print("x não é maior que 5") # IndentationError

Use 4 espaços para indentação; evite tabulações.

Comentários Python

Comentários são notas explicativas ignoradas pelo interpretador. Eles melhoram a legibilidade e a compreensão do código. Python oferece dois tipos:

• Comentários de uma linha: Começam com #. Qualquer coisa após # na mesma linha é um comentário.
• Comentários de várias linhas (docstrings): Envolvidos em aspas triplas (''' ou """). Frequentemente usados para documentar funções, classes e módulos.

Exemplos:

x = 10  # Comentário de uma linha

'''
Este é um
comentário de
várias linhas.
'''

def minha_funcao():
    """Esta é uma docstring."""
    pass

A documentação eficaz é crucial para código limpo e fácil de manter. Mantenha os comentários concisos e relevantes; evite explicações redundantes.