Convenções de Nomeação de Classes

Python tem um conjunto de regras e convenções que utilizamos ao nomear as nossas classes, métodos e atributos. Estas convenções são importantes porque asseguram consistência no código que escreves, tornando-o mais fácil de ler e compreender. Adotar estas convenções é também uma boa prática profissional.

Nomes de Classes

Em Python, os nomes das classes seguem a convenção CapWords, também conhecida como PascalCase. Neste estilo, a primeira letra de cada palavra é maiúscula e não há underscores (_) entre as palavras:

class MyClass:  # O nome da classe começa com letra maiúscula
    pass        # Utilizamos "pass" quando não queremos que a classe faça nada

O termo PascalCase teve origem na linguagem de programação Pascal, atribuído à sua convenção de capitalização. CapWords é o termo utilizado no guia de estilo oficial do Python (PEP 8) e é essencialmente igual ao PascalCase.

Nomes de Métodos

Os nomes dos métodos devem ser todos em minúsculas, com palavras separadas por underscores conforme necessário para melhorar a legibilidade. Isto é também conhecido como snake_case. Aqui está um exemplo:

class MyClass:
    def my_method(self):  # O nome do método está todo em minúsculas
        pass              # As palavras são separadas por underscores

Nomes de Atributos

Os nomes dos atributos seguem a mesma convenção que os nomes dos métodos: devem ser todos em minúsculas, com palavras separadas por underscores para melhorar a legibilidade.

class MyClass:
    def __init__(self):
        self.my_attribute = 'algum valor'  # Nome do atributo em minúsculas,
                                           # palavras separadas por underscores

No código acima, definimos um atributo my_attribute dentro do método __init__. O método __init__ é um método especial em classes Python que é chamado automaticamente quando uma nova instância da classe é criada.

Vamos ver um exemplo completo de uma classe, seus métodos e atributos:

class MyCar:                              # Nome da classe usa CapWords
    def __init__(self):
        self.car_model = 'Tesla Model 3'  # Nome do atributo usa snake_case

    def start_engine(self):               # Nome do método usa snake_case
        print('Engine started!')

Embora o Python não imponha estritamente estas convenções de nomeação, segui-las torna o teu código mais profissional, legível e consistente. Portanto, é considerado uma boa prática na comunidade Python.