> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Python Runner

> Execute um script Python no seu projeto e salve o que ele escreve, como figuras para o seu documento.

Os scripts Python são executados no seu navegador, então a saída aparece logo abaixo do editor. Não é preciso configurar nada.

**1. Criar um script**

Na árvore de arquivos, clique no ícone **New file**. Digite um nome que termine em `.py` e clique em **Create**.

![A caixa de diálogo Add Files com o nome analysis.py](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/python-runner-new-file.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=6be49974e488f7678604cc0644f43bdc)

Um novo arquivo Python

O botão **Run** e um painel de saída aparecem abaixo do editor. Na primeira vez, o botão fica desativado enquanto o Python carrega.

**2. Executar**

Escreva seu código e clique em **Run**. O que o script imprime aparece no painel de saída. Você não precisa salvar antes.

Os arquivos que o script escreve vão para o seu projeto. Uma mensagem informa quais, por exemplo **results.txt saved to your project**, e o arquivo aparece na árvore de arquivos.

![Um script no editor, sua saída impressa abaixo e a mensagem results.txt saved to your project](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/python-runner-output.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=28188ffe214aedd1203d2734891917f7)

A saída e um arquivo salvo

**3. Parar um script**

Enquanto um script é executado, **Run** se torna **Stop**. Clique nele para interromper o script. O painel de saída termina com **Execution interrupted**.

![O botão Stop e a saída de um script em execução](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/python-runner-stop.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=263af195efa53538f1e3b37b4fad6041)

Um script em execução

## Usar uma figura no seu documento

Os gráficos não têm uma janela onde aparecer, então salve-os em um arquivo. Por exemplo:

```python theme={null}
import matplotlib.pyplot as plt

plt.plot([1, 2, 3], [1, 4, 9])
plt.savefig("figure.png")
```

`figure.png` aparece no seu projeto, pronto para `\includegraphics{figure.png}`.

![figure.png aberto no editor, com a mensagem figure.png saved to your project](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/python-runner-figure.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=8b0074f8d46a40a105a459a6c09caabf)

Um gráfico salvo

## Ler os arquivos do seu projeto

Um script pode abrir os arquivos do seu projeto pelo caminho:

```python theme={null}
print(open("results.txt").read())
```

## Se algo der errado

**O script gera um erro.** O erro aparece em vermelho no painel de saída, depois de tudo o que o script imprimiu antes.

![Texto impresso seguido de um traceback em vermelho](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/python-runner-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=89ef60d790737fe01d6d69b1e0395e9e)

Um erro em um script

**`ModuleNotFoundError: No module named ...`.** Apenas os pacotes incluídos no Pyodide estão disponíveis, e pacotes instalados com `pip` não podem ser usados. NumPy e Matplotlib estão entre os disponíveis, e a mensagem leva à [lista completa](https://pyodide.org/en/stable/usage/packages-in-pyodide.html).

![Um ModuleNotFoundError no painel de saída](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/python-runner-missing-package.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=5dbbfca95ee2b6984e2b3220e500231a)

Um pacote indisponível


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.