Como Dar Nomes para Variáveis no Python – Nomenclatura PEP8
Sabia que existem convenções para as formas de como dar nomes para variáveis? Não se trata de uma regra, mas é importante no Python.
O guia de estilo PEP8 recomenda snake_case (tudo minúsculo separado por underline) para variáveis e funções, UPPERCASE para constantes e CapitalCamelCase para classes. Camel case e kebab case existem, mas são pouco usados no Python: o kebab aparece mais em nomes de bibliotecas. Não é regra obrigatória, e sim convenção de leitura.
Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!
O que você aprende neste vídeo
Resposta rápida: O vídeo explica as convenções de nomes do Python vindas do PEP8: snake_case para variáveis e funções, MAIÚSCULAS para constantes, CapitalCamelCase para classes, e quando aparecem camelCase e kebab-case. Mostra também o truque do underline no final do nome (como filter_) para usar uma palavra reservada do Python como variável.
Neste vídeo (12 min):
- 1:00 - Não existe uma regra obrigatória de nomenclatura no Python: qualquer nome funciona, mas seguir uma convenção facilita ler o código de outras pessoas e ser lido por elas
- 2:00 - As convenções vêm do PEP8, o guia de estilo oficial do Python, e a convenção da empresa onde se trabalha vem antes de qualquer padrão geral
- 3:00 - No
camelCase, a primeira palavra começa minúscula e as seguintes começam maiúsculas; é mais raro em Python, mais comum em quem vem de outras linguagens - 4:00 - No
snake_case, tudo fica minúsculo separado por underline; é o padrão mais usado no Python para variáveis e para nomes de função - 5:00 - Escrever a variável toda em maiúsculas sinaliza que ela é uma constante, um valor que não deve mudar, como uma chave de API ou um caminho fixo
- 6:00 - No
CapitalCamelCase, todas as palavras começam maiúsculas; é o padrão usado para nomear classes no Python - 8:00 - O
kebab-case, com hífen entre as palavras, quase não aparece em nomes de variável no Python; ele costuma aparecer no nome de bibliotecas na hora de instalar, como empip install opencv-python - 9:00 - Existe uma convenção chamada single trailing underscore: terminar o nome com um underline, como em
filter_, permite usar como variável uma palavra que é reservada do Python
Trechos do vídeo:
- O mais importante não é qual convenção de nomes você usa, mas seguir um padrão único no código, e antes de qualquer convenção geral vem a convenção da própria empresa
snake_caseé o padrão mais usado no Python para variáveis e funções;CapitalCamelCaseé o padrão para nomear classes- Escrever uma variável toda em maiúsculas é a forma de sinalizar que ela é uma constante, um valor que não muda ao longo do código
- Terminar um nome com underline, como em
filter_, resolve o conflito de usar como variável uma palavra que já é reservada pelo Python
Fala Impressionadores! Na aula de hoje eu quero te mostrar como dar nomes para as variáveis no Python!
Não é uma regra, mas temos convenções de nomes no Python para facilitar o entendimento de variáveis, classes e funções.
A ideia é padronizar o seu código para que fique mais fácil de entender e para que você entenda outros códigos também.
Nessa aula eu vou te mostrar as seguintes nomenclaturas:
- Camel case
- Snake case
- Uppercase
- Capital camel case
- Kebab case
- Single trailing underscore
Python ImpressionadorVocê vai aprender a linguagem de Programação que mais cresce no Mundo para fazer automações incríveis, desenvolver sites, fazer análises de dados, trabalhar com Ciência de Dados, Inteligência Artificial, mesmo que você nunca tenha tido nenhum contato com Programação na vida.
Começar agora
E aí, vamos aprender quais nomenclaturas temos dentro do Python e qual a utilidade de cada uma delas?
Como funcionam as nomenclaturas no Python?
No Python você tem liberdade para dar a nomenclatura que quiser às variáveis, funções e classes, mas existem algumas convenções que organizam melhor esses nomes.
Todas essas nomenclaturas que vamos falar agora estão no Guia de estilo para código Python – PEP8 clique no link caso queira conferir.
Dica: Antes de escolher por um estilo, veja se a sua empresa já não adquiriu algum deles, você deve priorizar pelo estilo que sua empresa já utiliza.
- Camel case – Como dar nomes para variáveis no Python?
O estilo Camel case é aquele em que escrevemos as palavras todas unidas sem nenhum espaço, acentos ou pontos entre elas e sempre a segunda palavra é iniciada com letra maiúscula
Ex: minhaVariavelVariasOutrasPalavras
Este padrão é pouco usado no Python, mas é perfeitamente válido.
- Snake case
Já o padrão Snake case é mais comum na linguagem Python, é usado em nome de variáveis e funções, nele as palavras estão todas em letra minúscula e são separadas pelo símbolo underline “_”
Ex: minha_variavel_varias_outras_palavras
- Uppercase
O Uppercase é uma variação do Snake case, a diferença é que nele vamos escrever tudo em letra maiúscula e separar também com o underline.
É usado no Python geralmente em constantes como chaves de API ou variáveis que não pretendemos modificar, é comum que programadores imaginem que a variável que tem o nome neste estilo seja uma constante no código
Ex: FATURAMENTO = 1000
MINHA_VARIAVEL_VARIAS_OUTRAS_PALAVRAS
- Capital camel case
Este estilo é muito semelhante ao primeiro que vimos o Camel case, no Capital camel case as palavras são escritas todas juntas com a primeira letra de cada palavra em maiúscula, inclusive a primeira palavra, e essa é a única diferença se compararmos ao estilo Camel case…
Este estilo é muito utilizado no Python para escrever Classes, se você não souber o que é uma Classe em Python clique no link, temos uma aula completa explicando o tema!
Ex: MinhaVariavelVariasOutras
- Kebab case
Neste estilo as palavras são escritas em letra minúscula e separadas por um hífen, particularmente eu recomendo um cuidado maior para usar este estilo, visto que o hífen possui outras funções no Python como o sinal para a conta de menos, por este motivo um simples espaço entre as palavras pode gerar um erro.
Este estilo é comumente usado para a instalação de algumas bibliotecas.
Ex: minha-variavel-varias-outras-palavras
Ex: Instalação de bibliotecas -> pip install opencv-python
- Single trailing underscore
Neste estilo você basicamente cria uma variável e no final dela coloca um underline.
Qual o objetivo deste estilo?
Muitas palavras como o Filter, por exemplo, são palavras reservadas do Python, se você as usar como nome de uma variável o Python irá reconhecer como um comando, por isso colocamos o underline no final, para modificar a palavra e torná-la um nome de variável.
Ex: Filter_
Perguntas frequentes
1. O que é snake case no Python?
É o estilo em que todas as palavras ficam em letra minúscula e separadas por underline, como minha_variavel_varias_outras_palavras. É o padrão mais comum da linguagem e o recomendado para nomes de variáveis e de funções, justamente por ser fácil de ler no meio do código.
2. Qual a diferença entre camel case e capital camel case?
No camel case as palavras ficam unidas e só a partir da segunda cada uma começa com maiúscula (minhaVariavelVariasOutras). No capital camel case até a primeira palavra começa com maiúscula (MinhaVariavelVariasOutras). Essa é a única diferença, e o segundo é o estilo usado para nomear classes em Python.
3. Por que colocar underline no final do nome da variável?
Porque algumas palavras são reservadas do Python, como filter. Se você usar o nome puro, o interpretador entende como comando e não como variável. Acrescentar um underline no final (filter_) muda a palavra o suficiente para virar um nome válido, mantendo a leitura. É o single trailing underscore.
4. Quais estilos de nomenclatura são mais comuns em Python?
Os três mais encontrados são snake case (variáveis e funções), uppercase com underline (constantes, como chaves de API) e capital camel case (classes). Se a sua empresa já adota um padrão, siga o dela: o objetivo da convenção é que qualquer pessoa entenda o código rapidamente.
Conclusão – Como Dar Nomes para Variáveis no Python
Nesta aula trouxe os estilos padronizados de nomes para o código Python, esses estilos não são obrigatórios, mas deixam o código mais bonito e facilitam para quem estiver vendo seu código ou quando você precisar ver o código de outra pessoa.
Alguns desses estilos têm significados específicos que ajudam a entender o código.
Lembrando que em Python os mais comuns de encontrar são os estilos snake case, uppercase e capital camel case.
Eu fico por aqui! Espero que tenham gostado. Abraço,
Hashtag Treinamentos
Para acessar outras publicações de Python, clique aqui!
