Para usar as funcionalidades de um módulo, você precisa importá-lo em outro script Python. Existem algumas formas de fazer isso:

• import nome_do_modulo (Importação Completa)

  • Como funciona: Importa o módulo inteiro. Para acessar suas funções, classes ou variáveis, você precisa prefixá-las com o nome do módulo.
  • Exemplo:

  # meu_programa.py
  import calculadora
  
  resultado_soma = calculadora.somar(10, 5)
  print(f"Resultado da soma: {resultado_soma}")
  
  print(f"O valor de PI é: {calculadora.PI}")
  
  calc_av = calculadora.CalculadoraAvancada()
  print(f"Potência de 3 elevado a 4: {calc_av.potencia(3, 4)}")
  

  • Vantagem: Evita conflitos de nomes, pois tudo vem de um namespace claro (calculadora.).

• from nome_do_modulo import item1, item2 (Importação Seletiva)

  • Como funciona: Importa apenas itens específicos (funções, classes, variáveis) do módulo diretamente para o namespace do seu script. Você pode usá-los sem o prefixo do módulo.
  • Exemplo:

  # meu_programa_v2.py
  from calculadora import somar, PI, CalculadoraAvancada
  
  resultado_soma = somar(20, 10) # Não precisa de calculadora.somar
  print(f"Resultado da soma: {resultado_soma}")
  
  print(f"O valor de PI é: {PI}") # Não precisa de calculadora.PI
  
  calc_av = CalculadoraAvancada()
  print(f"Raiz quadrada de 16: {calc_av.raiz_quadrada(16)}")
  

  • Vantagem: Torna o código mais conciso.
  • Cuidado: Pode levar a conflitos de nomes se você importar itens com o mesmo nome de diferentes módulos.

• from nome_do_modulo import * (Importação de Tudo - Cuidado!)

  • Como funciona: Importa todos os itens de um módulo diretamente para o namespace do seu script.
  • Exemplo:

  # meu_programa_v3.py
  from calculadora import * # EVITE USAR NA MAIORIA DOS CASOS!
  
  resultado_multi = multiplicar(7, 2) # Acessível diretamente
  print(f"Resultado da multiplicação: {resultado_multi}")
  

  • Cuidado: Altamente desencorajado para a maioria dos casos em código de produção! É difícil saber de onde cada função ou variável veio, e isso aumenta drasticamente o risco de conflitos de nomes (quando duas funções de módulos diferentes têm o mesmo nome, uma sobrescreve a outra). Geralmente é aceitável apenas para scripts pequenos, interativos ou em módulos __init__.py de pacotes muito específicos.

• import nome_do_modulo as alias (Importação com Alias)

  • Como funciona: Importa o módulo e atribui a ele um nome mais curto (alias).
  • Exemplo:

  # meu_programa_v4.py
  import calculadora as calc # 'calc' é um alias para 'calculadora'
  
  resultado_div = calc.dividir(100, 4)
  print(f"Resultado da divisão: {resultado_div}")
  
  print(f"Valor aproximado de PI: {calc.PI}")
  

  • Vantagem: Útil para módulos com nomes longos ou para evitar conflitos com outros nomes existentes, enquanto ainda mantém a clareza do namespace.