0% acharam este documento útil (0 voto)

14 visualizações34 páginas

Apresentação Da Formação

Este documento apresenta as boas práticas de programação em Python definidas pela PEP 8, incluindo nomeação, layout de código, indentação, comentários e espaços em branco. A PEP 8 tem como objetivo padronizar o estilo de código Python para torná-lo mais legível e de fácil manutenção.

Enviado por

enniobernardo96

Direitos autorais

Levamos muito a sério os direitos de conteúdo. Se você suspeita que este conteúdo é seu, reivindique-o aqui.

Formatos disponíveis

Baixe no formato PDF, TXT ou leia on-line no Scribd

0% acharam este documento útil (0 voto)

14 visualizações34 páginas

Apresentação Da Formação

Enviado por

enniobernardo96

Direitos autorais

Levamos muito a sério os direitos de conteúdo. Se você suspeita que este conteúdo é seu, reivindique-o aqui.

Formatos disponíveis

Baixe no formato PDF, TXT ou leia on-line no Scribd

Você está na página 1/ 34

Fundamentos de

Inteligência de Dados
Formação Power BI Analyst

Juliana Mascarenhas
Tech Education Specialist DIO / Owner @Simplificandoredes e @SimplificandoProgramação

Mestre em modelagem computacional | Cientista de dados

@in/juliana-mascarenhas-ds/

[1]
Objetivo Geral Convenções de nomeação

Indentação

DocStrings

Overview sobre as boas práticas de programação

em Python com o guia PEP 8.
Espaços em branco
Espaços em branco

Code Layout
[2]
Etapa 1

O que é a PEP 8? Qual sua

importância?
// Integração com Python

[3]
PEP

• Julho 2000
• PEP – Python Enhancement Proposals
• Convenções de acordo com tópicos
• Possui controle de versão

Documentação PEP Documentação PEP 8

[4]
PEP 8 – Guia de Estilo

Objetivo:
• Nomeação de classes e métodos
• Code Layout
• Indentação “Readability counts.”
— The Zen of Python
• Docstrings - comentários
• ...

[5]
PEP 8 – Legibilidade
O que eu fiz aqui mesmo?

“Code is read much more often than

it is written.”

Guido van Rossum

[6]
PEP 8 – Legibilidade
Por que aprender isso?

• Time de desenvolvimento
• Trabalho em equipe
• Facilidade de entendimento
• Manutenção facilitada

[7]
Etapa 2

The Guide Line –

Padronização com Python
// Integração com Python

[8]
PEP 8 - Nomeando

• Classes
• Variáveis
• Métodos
• Funções

Nomes com significado “Explicit is better than implicit.”

— The Zen of Python
[9]
PEP 8 - Nomeando

[10]
PEP 8 - Nomeando

[11]
PEP 8 - Nomeando

>>> # Not recommended

>>> x = 'John Smith'
>>> y, z = x.split()
>>> print(z, y, sep=', ') 'Smith, John'

>>> # Recommended
>>> name = 'John Smith'
>>> first_name, last_name = name.split()
>>> print(last_name, first_name, sep=', ') 'Smith, John'

[12]
PEP 8 - Nomeando

# Not recommended
def db(x):
return x * 2

# Recommended
def multiply_by_two(x):
return x * 2

[13]
Etapa 2

The Guide Line – Code Layout

& Tópicos Relacionados

// Integração com Python

[14]
Code Layout

O que é isso?

“Beautiful is better than ugly.”

— The Zen of Python [15]
PEP 8 – Code Layout

“Beautiful is better than ugly.”

— The Zen of Python
[16]
PEP 8 – Code Layout

• Blank lines
• Espaçamento “Beautiful is better than ugly.”
• Tamanho máximo — The Zen of Python
• Quebra de linha

[17]
PEP 8 - Indentação

Define o agrupamento das x=3

if x > 5:
linhas de código e a lógica print('x is larger than 5')
da aplicação
“There should be one—and preferably only one—
obvious way to do it.”

— The Zen of Python

[18]
PEP 8 – Tab e Espaço

Tecla tab
• Esqueça a tecla Tab
• 4 espaços

Pode misturar? 4 espaços

[19]
PEP 8 – Tab e Espaço
Limite = 79 caracteres
def function(
arg_one,
• Quebra estruturas e arg_two,
métodos arg_three,
arg_four):
return arg_one

def function( arg_one, arg_two,

arg_three, arg_four):
return arg_one

[20]
PEP 8 – Testando o Código

Fonte: https://realpython.com/python-pep8/#naming-conventions [21]

PEP 8 – Quebrando linhas

[22]
PEP 8 – Quebrando linhas

[23]
Etapa 1

The Guide Layout -

Comentários no código
// Integração com Python

[24]
Comentários no código

• Comentários tanto quanto necessário

• Objetivo: facilitar o entendimento
• Código bem escrito também é documentação

“If the implementation is hard to explain, it’s

a bad idea.”
— The Zen of Python
[25]
Comentários no código

• Limite da linha = 79 caracteres

• Sentenças completas iniciando com letra maíscula
• Atualização de comentários

“If the implementation is hard to explain, it’s

a bad idea.”
— The Zen of Python
[26]
Blocos de comentários

“If the implementation is hard to explain, it’s

a bad idea.”
— The Zen of Python
[27]
Blocos de comentários

Não explique o óbvio!

[28]
Docstring

• Caracteres: """ ou '''

• Dentro e classes, funções e início de programas
• Escritos para módulos públicos
[29]
Etapa 1

The Guide Line - Espaços em

Branco em Expressões
// Integração com Python

[30]
Espaçamento

Não exagere nos espaços!

[31]
Quando evitar?
Poucos espaços

• Difícil de ler
Esparso demais

• Muitos espaços

[32]
Dúvidas?
> Fórum/Artigos
> Comunidade Online (Discord)

[33]
Para saber mais
Referências principais:

• https://peps.python.org/pep-0008/

• https://peps.python.org/pep-0257/ https://github.com/julianazanelatto

• https://pypi.org/project/pylint/

• https://pypi.org/project/flake8/

[34]

Apresentação Da Formação

Enviado por

Apresentação Da Formação

Enviado por

Fundamentos de

Mestre em modelagem computacional | Cientista de dados

Overview sobre as boas práticas de programação

O que é a PEP 8? Qual sua

Documentação PEP Documentação PEP 8

“Code is read much more often than

Guido van Rossum

The Guide Line –

Nomes com significado “Explicit is better than implicit.”

>>> # Not recommended

The Guide Line – Code Layout

// Integração com Python

“Beautiful is better than ugly.”

“Beautiful is better than ugly.”

Define o agrupamento das x=3

— The Zen of Python

Pode misturar? 4 espaços

def function( arg_one, arg_two,

Fonte: https://realpython.com/python-pep8/#naming-conventions [21]

The Guide Layout -

• Comentários tanto quanto necessário

“If the implementation is hard to explain, it’s

• Limite da linha = 79 caracteres

“If the implementation is hard to explain, it’s

“If the implementation is hard to explain, it’s

Não explique o óbvio!

• Caracteres: """ ou '''

The Guide Line - Espaços em

Não exagere nos espaços!

Você também pode gostar

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.