Python - Organização do código por módulos

Python - Organização do código por módulos

Para códigos com alguma dimensão e complexidade há que pensar em organizar o código.

Quer seja para legibilidade ou organização, manter todo o código apenas num ficheiro é considerada uma má prática.

Existem diversas formas de organizar o código. Uma é repartir o código por ficheiros que se chamam módulos e podem ser importados para o código principal.

Mesmo para a repartição por ficheiros, há várias soluções, trago aqui a mais básica.

Tendo numa pasta o ficheiro principal.py posso repartir na mesma pasta o código num outro ficheiro a que chamei funcoes.py.

Tenho também na imagem uma pasta Source que será outra solução a explorar.

Dentro do ficheiro funcoes.py tenho um conjunto de funções, ou métodos, que serão chamados desde o ficheiro principal.py 

Neste ficheiro tenho duas funções que podem ser chamadas desde o ficheiro principal, adiciona e subtrai. Note-se que coloquei ao inicio um texto que nunca será apresentado pois nenhuma função ou método o executa. A chamada do ficheiro principal é ao conteúdo das funções.

No ficheiro principal tenho de ter o import funcoes que le o ficheiro funcoes.py

Veja-se que depois para executar a função adiciona tenho de colocar antes o prefixo do nome do módulo importado.

De notar que existem outros métodos para realizar a importação.

Se optar por organizar os módulos dentro de uma pasta, como no esquema da primeira imagem a importação é ligeiramente diferente.

Dentro do ficheiro funcoes_extras.py não há nada de diferente.

Na importação do módulo que está dentro da pasta, temos de fazer referência à pasta com o prefixo igual ao nome da pasta, neste caso source.funcoes_extras 

A execução do programa apresenta o output seguinte:

O output acima é o resultado da leitura e execução dos dois módulos.