modularizador 1.0.13

Importe arquivos .ipynb como se fossem arquivos .py no Jupyter Notebook /\/\/\ Import .ipynb files as if they were .py files on Jupyter Notebook

Modularizador

For explanations in english, scroll down (Explicações em inglês no final).

Instale com

!pip install modularizador

Após importado no Jupyter Notebook, permite importar arquivos .ipynb como se fossem arquivos .py, inclusive os que estão em subpastas.

Exemplo de uso:

1. Na pasta do seu projeto, use seu Jupyter Notebook para criar o arquivo main.ipynb, depois crie um arquivo chamado somador.ipynb e coloque ele dentro de uma subpasta chamada pacotes.

'----Pasta do seu projeto
    |   main.ipynb
    |
    '---pacotes
            somador.ipynb

2. Crie uma função chamada soma dentro do arquivo somador.ipynb:

def soma(a, b):
    return a + b

3. Agora, a partir de main.ipynb, é só importar o modularizador e você poderá importar também o somador.ipynb:

import modularizador
from pacotes import somador
somador.soma(2, 3)
>>> 5

O código utilizado nesta biblioteca para obter o resultado acima foi extraído desta página da documentação do Jupyter Notebook. Daqui para baixo vamos nos referir a ele como o script, ou como modularizador.py.

A biblioteca modularizador conta ainda com 3 funções úteis: ativa(), desativa() e status_startup().

• ativa()

import modularizador
modularizador.ativa()

Insere o script na pasta startup do ipython, tornando desnecessário importar a biblioteca modularizador a partir das próximas vezes que você abrir um projeto. O efeito durará enquanto modularizador.py estiver na pasta startup, portanto fechar seu Jupyter Notebook não o desfará.

No exemplo anterior, se você já tivesse, em algum momento do passado, realizado o procedimento de ativação logo acima, poderia, em seu novo projeto, importar pacotes/somador.ipynb sem a necessidade de importar o modularizador. Simplesmente assim:

from pacotes import somador
somador.soma(2, 3)
>>> 5

• desativa()

import modularizador
modularizador.desativa()

Remove o script modularizador.py da pasta startup do ipyton, tirando do seu Jupyter Notebook a capacidade de importar arquivos .ipynb sem importar manualmente o modularizador em cada projeto.

• status_startup()

import modularizador
modularizador.status_startup()

Apenas informa se o script modularizador.py está na pasta startup do ipyton. I.e., se está ou não ativo o recurso que permite a importação de arquivos .ipynb sem a necessidade de importar a biblioteca modularizador explicitamente em cada projeto.

É só isso. Abaixo estão as mesmas explicações acima em inglês.

---

---

---

---

---

== Explanations in english ==

Install with

!pip install modularizador

After importing modularizador on Jupyter Notebook, you'll be able to import .ipynb files as if they were .py files, even those inside subfolders.

Usage example:

1. Inside your project directory, use your Jupyter Notebook to create main.ipynb, then create summer.ipynb and put it inside a subfolder named packages.

'----Your project folder
    |   main.ipynb
    |
    '---packages
            summer.ipynb

2. Define a function named add inside summer.ipynb:

def add(a, b):
    return a + b

3. Now, inside main.ipynb, import modularizador and you'll become able to import summer.ipynb too afterwards:

import modularizador
from packages import summer
summer.add(2, 3)
>>> 5

The code that makes this possible was extracted from this page of Jupyter Notebook's documentation. From now on, we will refer to it either as the script or as modularizador.py.

The modularizador library has 3 useful methods: ativa(), desativa() and status_startup().

• ativa()

import modularizador
modularizador.ativa()

Ativa means activate. This method inserts the script in ipython's startup, making it unnecessary to explicitly import modularizador everytime you open a new Jupyter Notebook project from now on. This effect will last as long as modularizador.py remains in the startup folder, so closing your Jupyter Notebook won't undo it.

In our last example, had you activated modularizador somewhen in the past, you would be able to import packages/summer.ipynb without having to import modularizador first. Just like:

from packages import summer
summer.add(2, 3)
>>> 5

• desativa()

import modularizador
modularizador.desativa()

Desativa means deactivate. This method removes the script (modularizador.py) from ipython's startup folder, making your Jupyter Notebook unable to import .ipynb without manually importing modularizador priorly in each project again.

• status_startup()

import modularizador
modularizador.status_startup()

Just tells you whether or not the script (modularizador.py) is in ipython's startup folder. I.e., whether modularizador is active and hence allowing you to import .ipynb without the need to explicitly import modularizador beforehand in your projects or not.