0a1eeea424
* fix: replace sh with shell fix replace terminal with shell fix replace node with js fix replace output with shell fix replace cs with csharp fix replace c++ with cpp fix replace c# with csharp fix replace javasctipt with js fix replace syntax with js fix replace unix with shell fix replace linux with shell fix replace java 8 with java fix replace swift4 with swift fix replace react.js with jsx fix replace javascriot with js fix replace javacsript with js fix replace c++ - with cpp fix: corrected various typos fix: replace Algorithm with nothing fix: replace xaml with xml fix: replace solidity with nothing fix: replace c++ with cpp fix: replace txt with shell fix: replace code with json and css fix: replace console with shell
30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
---
|
||
title: Coding standards
|
||
localeTitle: Padrões de codificação
|
||
---
|
||
### Esboço
|
||
|
||
* Por que padrões de codificação?
|
||
* Introdução ao PEP 8
|
||
* Comandos
|
||
|
||
### Por que padrões de codificação?
|
||
|
||
A comunidade global de python está crescendo rapidamente e quase todo mundo usa python. É aqui que a legibilidade do código e os padrões uniformes são importantes. Qualquer pessoa no planeta deve ser capaz de ler seu código e entender o que ele faz. Há muitos aspectos para entender o código do outro, por exemplo, comentários sobre o que uma função faz, dividindo logicamente tarefas entre módulos e funções, bons nomes de variáveis, etc.
|
||
|
||
### Introdução ao PEP 8
|
||
|
||
Nós amamos aderir às convenções. A comunidade de usuários de python criou um conjunto de padrões, que agora são considerados convenções. Qualquer código de nível de setor que você escreve é executado através do verificador PEP 8. Portanto, é uma boa prática começar a escrever docstrings para suas classes e funções e nomear variáveis em minúsculas com sublinhados apropriados. Pode valer a pena dar uma olhada nesses padrões antes de começar a codificação.
|
||
|
||
[Aqui está o link exaustivo](https://www.python.org/dev/peps/pep-0008/ "Padrões PEP 8")
|
||
|
||
### Comandos
|
||
|
||
Veja como você verifica se o seu código python atende aos padrões dele.
|
||
|
||
```shell
|
||
:~$ pip install pep8
|
||
:~$ pep8 --first myCode.py
|
||
```
|
||
|
||
Isso dará todas as linhas que violam os padrões, juntamente com uma breve descrição das correções. |