Python

Veremos neste post variável local e global, comentários e documentação em Python

Declaração de Variáveis

Representa uma posição na memória, onde pode ser armazenado um dado
Possui um nome e um valor
Durante a execução do algoritmo, pode ter seu valor alterado

resultado = 0
resultado += 1
resultado += 1
resultado += 1
print('resultado =',resultado)
"""
Resultado:

resultado = 3
"""

resultado = 0

resultado += 1

print('resultado =',resultado)

"""

Resultado:

resultado = 3

"""

Nome de variável

Dê nome significativo e sucinto a sua variável;
Variáveis de uma única letra como a variável ‘i’ é aceitável apenas para contadores
O nome deve iniciar por letra ou _ (sublinhado ou underscore)
Para separar palavras podemos fazer com _ (underscore) ou letra maiúscula.
Exemplos: retornaNomeObjeto, retorna_nome_objeto
Python é case sesitive pois difere nome de variável que tem letras maiúsculas e minúsculas.
Somos impedidos de usar palavras reservadas da linguagem para nomes de variáveis.
São elas: False, class, finally, is, return, None, continue, for, lambda, try, True, def, from, nonlocal, while, and, del, global, not, with, as, elif, if, or, yield, assert, else, import, pass, break, except, in, raise

primeironome = "Fábio"
primeiroNome = "Mario"
print('Os nomes: ',
primeironome, 'e', primeiroNome, 
'foram armazenados em variáveis diferentes, 
porquê o Python é case sensitive e percebeu a diferença na letra n (maiúscula e minúscula)')
"""
Resultado:

Os nomes:  
Fábio e Mario foram armazenados em variáveis diferentes, 
porquê o Python é case sensitive e percebeu a diferença na letra n (maiúscula e minúscula)
"""

primeironome = "Fábio"

primeiroNome = "Mario"

print('Os nomes: ',

primeironome, 'e', primeiroNome,

'foram armazenados em variáveis diferentes,

porquê o Python é case sensitive e percebeu a diferença na letra n (maiúscula e minúscula)')

"""

Resultado:

Os nomes:

Fábio e Mario foram armazenados em variáveis diferentes,

porquê o Python é case sensitive e percebeu a diferença na letra n (maiúscula e minúscula)

"""

Local

def somaTres(valor):
    # variável a ser utilizada localmente
    valorAdicional = 3
    result = valor + valorAdicional

def somaTres(valor):

# variável a ser utilizada localmente

valorAdicional = 3

result = valor + valorAdicional

Observe que a variável valorAdicional como foi declarada dentro de uma função fica restringida dentro da função somaTres().

Global

O uso de variáveis globais em Python não é recomendado na maioria dos casos, os principais motivos são problemas no paralelismo e funções que dependem de variáveis globais são menos reutilizáveis, já que têm dependências externas implícitas, o que, reduz a modularidade do código.

# Variável global
contador = 0
def incrementar():
    global contador
    contador += 1
incrementar()
incrementar()
incrementar()

print("resultado: ",contador)
"""
Resultado:

resultado:  3
"""

# Variável global

contador = 0

def incrementar():

global contador

contador += 1

incrementar()

print("resultado: ",contador)

"""

Resultado:

resultado: 3

"""

Atribuindo valores as variáveis na mesma linha

nome, aluno, colega = "André","Pedro","Francisco"
print(nome)
print(aluno)
print(colega)
"""
Resultado:

André
Pedro
Francisco
"""

nome, aluno, colega = "André","Pedro","Francisco"

print(nome)

print(aluno)

print(colega)

"""

Resultado:

André

Pedro

Francisco

"""

Comentários e Documentação em Python

Os comentários no código é importante para ajudar a compreender o seu código e de outros colegas programadores.
O comentário com aspas triplas pode permite gerar documentação e passa a aparecer em help( ).
No IDLE do python podemos executar help(print) que apresenta informações sobre esta função solicitada.

Uma linha

# Comentário de uma linha

1	# Comentário de uma linha

Multiplas linhas

"""
Comentário de
mais de uma
linha
"""

"""

Comentário de

mais de uma

linha

"""

Documentação a partir de comentários

def function soma(a,b):
    """
    Soma dois números 'a' e 'b'
    """
    return a + b

def function soma(a,b):

"""

Soma dois números 'a' e 'b'

"""

return a + b

Para gerar documentação deverá instalar a biblioteca pydoc

Depois deverá executar:
pydoc -p 1234
Que cria uma documentação em html do projeto com base nos comentários de três aspas em suas funções e objetos.

Função Print

Para imprimir uma informação em Python, se utiliza a função embutida print( ).
Você pode informar diretamente o texto ou pode passar variáveis.

retornando uma string

# Passando string simples
print("Ola Mundo")
# passando string de multiplas linhas
print("""Silvio
Silva
Firminon
""")
"""
Resultado: 

Ola Mundo
Silvio
Silva
Firminon
"""

# Passando string simples

print("Ola Mundo")

# passando string de multiplas linhas

print("""Silvio

Silva

Firminon

""")

"""

Resultado:

Ola Mundo

Silvio

Silva

Firminon

"""

Separador com espaço em branco e quebra de linha ao final

nome1 = "Silvio"
nome2 = "Silva"
nome3 = "Firmino"
print(nome1,nome2,nome3, sep=' ', end='n')
"""
Resultado: 

Silvio Silva Firminon
"""

nome1 = "Silvio"

nome2 = "Silva"

nome3 = "Firmino"

print(nome1,nome2,nome3, sep=' ', end='n')

"""

Resultado:

Silvio Silva Firminon

"""

Formatando uma String com F-String e Format

aluno = "Pedro"
idade = 12
print(f"Aluno: {aluno}, Idade:{idade}")
print("Aluno: {}, Idade: {}".format(aluno,idade))
"""
Resultado: 

Aluno: Pedro, Idade:12
Aluno: Pedro, Idade: 12
"""

aluno = "Pedro"

idade = 12

print(f"Aluno: {aluno}, Idade:{idade}")

print("Aluno: {}, Idade: {}".format(aluno,idade))

"""

Resultado:

Aluno: Pedro, Idade:12

Aluno: Pedro, Idade: 12

"""

Dica:

No IDLE do Python você pode consultar as funções nativas da linguagem com help( )
Veja:

help(print)
"""
Resultado:

Help on built-in function print in module builtins:
print(...)
    print(value, ..., sep=' ', end='n', file=sys.stdout, flush=False)
    Prints the values to a stream, or to sys.stdout by default.
    Optional keyword arguments:
    file:  a file-like object (stream); defaults to the current sys.stdout.
    sep:   string inserted between values, default a space.
    end:   string appended after the last value, default a newline.
    flush: whether to forcibly flush the stream.
"""

help(print)

"""

Resultado:

Help on built-in function print in module builtins:

print(...)

print(value, ..., sep=' ', end='n', file=sys.stdout, flush=False)

Prints the values to a stream, or to sys.stdout by default.

Optional keyword arguments:

file: a file-like object (stream); defaults to the current sys.stdout.

sep: string inserted between values, default a space.

end: string appended after the last value, default a newline.

flush: whether to forcibly flush the stream.

"""

Vimos hoje, variável local e global, comentários e documentação em Python, continue nos acompanhando !

Referências:

Gerar a documentação com PyDoc
Documentação Python

Livros sobre Introdução a Python da Amazon

Interno:

Quem somos

Explorando os Tipos de Dados no Python

No Python, os tipos de dados desempenham um papel fundamental no desenvolvimento de qualquer aplicação. Eles definem como as informações são armazenadas e manipuladas durante a execução do código. Entre os tipos básicos, destacam-se: int para números inteiros, float para números de ponto flutuante, str para cadeias de caracteres, bool para valores booleanos, e bytes para dados binários. Esses tipos servem como blocos de construção para qualquer programa e permitem maior controle sobre a lógica e o armazenamento de dados.

Principais Tipos de Dados

O tipo int representa números inteiros, como 10 ou -5, enquanto o float lida com números decimais, como 3.14 ou -0.001. Já o tipo str é utilizado para trabalhar com texto, sendo bastante versátil ao permitir a manipulação de palavras, frases e até mesmo caracteres únicos. O tipo bool aceita apenas os valores True ou False, tornando-o essencial para expressar condições e tomadas de decisão. Por fim, o tipo bytes é amplamente usado para representar sequências de dados binários, especialmente úteis em tarefas como comunicação em redes e manipulação de arquivos binários.

Tipos de dados

Numéricos:

Tipo	Exemplo	Descrição
int	50	Numeros inteiros são utilizados para contar elementos, representação de índices e operações mateáticas
Float	10.5 (Dez virgula cinco)	Chamado de Ponto Flutuante pois representa os números reais, ou seja, números com partes decimais, utilizados quando requerem precisão decimal, como taxas ou medições.

Cadeia de caracteres:

Tipo	Exemplo	Descrição
str	“Paulo da Silva”	Representa texto, armazenando uma sequência de caracteres.

Observação:
String não é um tipo de dado mas um módulo para tratamento de texto.
Contudo é muito comum chamarmos srt de string, o que leva a confundir com um tipo de dado.

import string
# Caracteres alfabéticos
print(string.ascii_letters)  
# Digitos
print(string.digits)  
"""
Resultado:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789
"""

import string

# Caracteres alfabéticos

print(string.ascii_letters)

# Digitos

print(string.digits)

"""

Resultado:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ

0123456789

"""

Lógico:

Tipo	Exemplo	Descrição
bool	True ou False	Representa valores lógicos: `True` (verdadeiro) ou `False` (falso).

Python não é uma linguagem tipada

Perceba que, nas declarações abaixo, o tipo de uma variável não é especificado diretamente. No Python, a variável recebe automaticamente um dado básico, que possui um tipo primário, como int, float, str ou bool. Além disso, ela também pode receber um tipo objeto, como class, function ou dados estruturados. Dessa forma, o Python garante flexibilidade e simplicidade no gerenciamento de variáveis.

print('Exemplo tipo de dado "32" - tipo: ',type('32'))
print('Exemplo tipo de dado 32 - tipo: ',type(32))
print('Exemplo tipo de dado 32.0 - tipo: ',type(32.0))
print('Exemplo tipo de dado True - tipo: ',type(True))
"""
Resultado:

Exemplo tipo de dado "32" - tipo:  &lt;class 'str'&gt;
Exemplo tipo de dado 32 - tipo:  &lt;class 'int'&gt;
Exemplo tipo de dado 32.0 - tipo:  &lt;class 'float'&gt;
Exemplo tipo de dado True - tipo:  &lt;class 'bool'&gt;
"""

print('Exemplo tipo de dado "32" - tipo: ',type('32'))

print('Exemplo tipo de dado 32 - tipo: ',type(32))

print('Exemplo tipo de dado 32.0 - tipo: ',type(32.0))

print('Exemplo tipo de dado True - tipo: ',type(True))

"""

Resultado:

Exemplo tipo de dado "32" - tipo: <class 'str'>

Exemplo tipo de dado 32 - tipo: <class 'int'>

Exemplo tipo de dado 32.0 - tipo: <class 'float'>

Exemplo tipo de dado True - tipo: <class 'bool'>

"""

x = "32"
print(type(x))
y = int(x)
print(type(y))
z = str(y)
print(type(z))
w = True
print(type(w))
"""
Resultado:

&lt;class 'str'&gt;
&lt;class 'int'&gt;
&lt;class 'str'&gt;
&lt;class 'bool'&gt;
"""

x = "32"

print(type(x))

y = int(x)

print(type(y))

z = str(y)

print(type(z))

w = True

print(type(w))

"""

Resultado:

"""

O programador precisa estar atento ao tipo da variável ou ao tipo de entrada de uma função.
Python tem crescido muito por sua lingagem concisa.

# Somando Strings
resultado = '32' + '1'
print(resultado)
321
# Somando Inteiros
resultado = 32 + 1
print(resultado)
33

# Somando Strings

resultado = '32' + '1'

print(resultado)

321

# Somando Inteiros

resultado = 32 + 1

print(resultado)

Conversões e Manipulação de Dados

As conversões de tipo permitem transformar dados de um tipo para outro de maneira eficiente. Por exemplo, a função int() converte valores numéricos ou strings que representam números em inteiros, enquanto float() realiza a conversão para números decimais. Para transformar um número ou objeto em texto, a função str() é amplamente utilizada. Além disso, as funções list() e set() possibilitam criar listas e conjuntos a partir de iteráveis. Em relação ao tipo bytes, as funções encode() e decode() são fundamentais. Enquanto encode() converte uma string para binário, decode() realiza o processo inverso. Essas conversões garantem flexibilidade e facilitam a manipulação de dados em diferentes contextos.

Com o domínio dos tipos e conversões, é possível o uso consciente dessas ferramentas torna o código mais eficiente e confiável.

Int() – converte para Inteiro
float() – converte para Float
str() – converte para string
list() – converte conjunto em lista
set() – converte lista em conjunto

print('Exemplo de conversão da str "5" para int - resultado: ',type(int('5')))
print('Exemplo de conversão da str "5" para float - resultado: ',type(float('5')))
print('Exemplo de conversão da int "5" para str - resultado: ',type(str(5)))
print('Exemplo de conversão da list ["banana","abacate"] para set - resultado: ',type(set(['banana','abacate'])))
print('Exemplo de conversão da set {"banana","abacate"} para list - resultado: ',type(list({'banana','abacate'})))
exemplo_byte = 'Hello'.encode(encoding='utf-8')
print('Exemplo de conversão da str "Hello" para byte - resultado: ',type(exemplo_byte))
print('Exemplo de conversão da byte b"Hello" para str - resultado: ',type(exemplo_byte.decode()))
"""
Resultado:

Exemplo de conversão da str "5" para int - resultado:  <class 'int'>
Exemplo de conversão da str "5" para float - resultado:  <class 'float'>
Exemplo de conversão da int "5" para str - resultado:  <class 'str'>
Exemplo de conversão da list ["banana","abacate"] para set - resultado:  <class 'set'>
Exemplo de conversão da set {"banana","abacate"} para list - resultado:  <class 'list'>
Exemplo de conversão da str "Hello" para byte - resultado:  <class 'bytes'>
Exemplo de conversão da byte b"Hello" para str - resultado:  <class 'str'>
"""

print('Exemplo de conversão da str "5" para int - resultado: ',type(int('5')))

print('Exemplo de conversão da str "5" para float - resultado: ',type(float('5')))

print('Exemplo de conversão da int "5" para str - resultado: ',type(str(5)))

print('Exemplo de conversão da list ["banana","abacate"] para set - resultado: ',type(set(['banana','abacate'])))

print('Exemplo de conversão da set {"banana","abacate"} para list - resultado: ',type(list({'banana','abacate'})))

exemplo_byte = 'Hello'.encode(encoding='utf-8')

print('Exemplo de conversão da str "Hello" para byte - resultado: ',type(exemplo_byte))

print('Exemplo de conversão da byte b"Hello" para str - resultado: ',type(exemplo_byte.decode()))

"""

Resultado:

Exemplo de conversão da str "5" para int - resultado: <class 'int'>

Exemplo de conversão da str "5" para float - resultado: <class 'float'>

Exemplo de conversão da int "5" para str - resultado: <class 'str'>

Exemplo de conversão da list ["banana","abacate"] para set - resultado: <class 'set'>

Exemplo de conversão da set {"banana","abacate"} para list - resultado: <class 'list'>

Exemplo de conversão da str "Hello" para byte - resultado: <class 'bytes'>

Exemplo de conversão da byte b"Hello" para str - resultado: <class 'str'>

"""

Tipo Byte

Tipo	Exemplo	Descrição
bytes	sequência imutável de números inteiros entre 0 e 255	Representa dados binários, armazenados como uma sequência de bytes. Usado para trabalhar com dados brutos, como arquivos binários, imagens ou streams de rede. Criado com o prefixo b antes de uma string.

Byte é uma sequência de 8 bits (bit é a menor unidade de informação em um sistema digital que representa 0 ou 1) agrupados.
É usado como uma unidade padrão para representar dados em sistemas digitais.
Um byte pode armazenar valores inteiros de 0 a 255 (ou -128 a 127 se for com sinal) ou representar um caractere em muitos sistemas de codificação, como ASCII.
Exemplo prático: A letra “A” em ASCII é representada pelo byte 01000001 (65 em decimal).

# Declaração de bytes
dados = b"hello world"  # Representação binária de "hello world"
# Acessando elementos
print(dados[0])  # 104 (representação ASCII do 'h')
# Convertendo bytes para string
texto = dados.decode("utf-8")  # Converte de bytes para str
print(texto)  # "hello world"
# Convertendo string para bytes
novo_dados = texto.encode("utf-8")
print(novo_dados)  # b"hello world"

"""
Resultado:

104
hello world
b'hello world'
"""

# Declaração de bytes

dados = b"hello world" # Representação binária de "hello world"

# Acessando elementos

print(dados[0]) # 104 (representação ASCII do 'h')

# Convertendo bytes para string

texto = dados.decode("utf-8") # Converte de bytes para str

print(texto) # "hello world"

# Convertendo string para bytes

novo_dados = texto.encode("utf-8")

print(novo_dados) # b"hello world"

"""

Resultado:

104

hello world

b'hello world'

"""

Conversões com encode e decode

str_original = 'Hello'

bytes_encoded = str_original.encode(encoding='utf-8')
print(type(bytes_encoded))

str_decoded = bytes_encoded.decode()
print(type(str_decoded))

print('Encoded bytes =', bytes_encoded)
print('Decoded String =', str_decoded)
print('str_original equals str_decoded =', str_original == str_decoded)
"""
Resultado:

<class 'bytes'>
<class 'str'>
Encoded bytes = b'Hello'
Decoded String = Hello
str_original equals str_decoded = True
"""

str_original = 'Hello'

bytes_encoded = str_original.encode(encoding='utf-8')

print(type(bytes_encoded))

str_decoded = bytes_encoded.decode()

print(type(str_decoded))

print('Encoded bytes =', bytes_encoded)

print('Decoded String =', str_decoded)

print('str_original equals str_decoded =', str_original == str_decoded)

"""

Resultado:

Encoded bytes = b'Hello'

Decoded String = Hello

str_original equals str_decoded = True

"""

Referências:

Documentação Python

Livros sobre Introdução a Python da Amazon

Interno:

Área de Convivência