À medida que nossos programas em Python crescem, precisamos organizá-los de forma a separá-los para melhor compreensão, manutenção e reuso. Python utiliza o conceito de Módulo que é um arquivo com extensão .py com variáveis, funções, classes 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. 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á foi criado em seu projeto utilizando alguma IDEs ou um compilador online.

Exemplo 1

#modulo.py
lista = [1,2,3,4,5,6,7,9] #objeto

#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 main.py.

Sintaxe

import nome_modulo

O acesso aos recurcos do módulo é feita utilizando o operador de acesso a membros (.) como mostrado na sintaxe a seguir:

Sintaxe

nome_modulo.nome_recurso

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 fique com um nome mais amigável, podemos utilizar o comando as ao importar 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 de 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]

Quando precisamos importar todas os recursos declarados em um pacote, utilizamos o caractere (*) no comando import como mostrado abaixo:

Sintaxe

from nome_modulo import *

Exemplo 4

#main.py
from modulo import * #modulo.py

print(lista)

modulo.funcao_no_modulo("Teste")

Saída

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

1. 11/09/2025 - revisão 2 - Ajustes: pontuais, sintaxes, objetivos; Adição: 'importar todos recursos'
2. 18/09/2024 - revisão 1 - Ajustes gramaticais e outros ajustes
3. 12/02/2024 - versão inicial