À medida que nossos programas em Python crescem, precisamos organizá-los de forma a separá-los para melhor compreensão e manutenção. Python utiliza o conceito de Módulo que é um arquivo com extensão .py como variáveis, funções e etc.

Para criarmos um módulo em Python, basta criarmos um arquivo com extensão .py na mesma pasta onde nosso módulo principal, main.py por exemplo, será utilizado. Após a criação e codificação, nosso módulo será importado utilizando o comando import.

Para acompanhar esta parte do tutorial é necessário instalar umas das IDEs listadas em Python: Introdução ou utilizar alguma compilador online que tenha suporte a criação de arquivos .py em seu ambiente como o OnllineGDB.

Utilizando uma IDE ou compilador Python online, vamos criar uma arquivo .py chamado modulo.py. Esse deve ser criado na mesma pasta do arquivo main.py que já deve estar criado em seu projeto utilizando as IDEs ou um compilador online.

Exemplo 1

#modulo.py

lista = [1,2,3,4,5,6,7,9] #variavel

#funcao
def funcao_no_modulo(nome):
  print("Olá, " + nome +" esse é nosso modulo.")

Vamos utilizarmos a função funcao_no_modulo de nosso arquivo modulo.py em nosso arquivo main.py, devemos importar modulo.py utilizando o comando import que deve ser declarado no topo do arquivo onde iremos utilizá-lo.

Sintaxe

import nome_modulo

Exemplo 2

#main.py
import modulo

modulo.funcao_no_modulo(“Teste”)

Saída

Olá, Teste esse é nosso modulo.

Para apelidarmos o nome de uma módulo para que fica com uma descrição mais amigável, podemos utilizar o comando as ao importarmos um módulo.

Sintaxe

import nome_modulo as novo_nome

Exemplo 3

#main.py
import modulo as mod

mod.funcao_no_modulo("Teste")
print(mod.lista)

Saída

Olá, Teste esse é nosso modulo.
[1, 2, 3, 4, 5, 6, 7, 9]

Às vezes , ao utilizarmos um módulo, desejamos apenas alguns recursos. Sendo assim, importamos apenas o que desejamos utilizando from e import como na sintaxe abaixo:

Sintaxe

from nome_modulo import nome_recurso_desejado

Exemplo 4

#main.py
from modulo import lista #modulo.py

print(lista)

Saída

[1, 2, 3, 4, 5, 6, 7, 9]

1. 18/09/2024 - revisão 1 - Ajustes gramaticais e outros ajustes
2. 12/02/2024 - versão inicial