swarmauri_tool_jupyterexportpython 0.11.0.dev1

Swarmauri code-extraction tool for converting Jupyter notebooks into Python scripts with nbconvert.

Swarmauri Jupyter Export Python Tool

swarmauri_tool_jupyterexportpython converts notebook objects into Python scripts through nbconvert.PythonExporter, making it useful for code extraction, audit, and migration workflows.

Why

• Extract runnable Python from notebooks for review or reuse.
• Bridge notebook prototypes into script-based workflows.
• Keep notebook-to-script export inside a Swarmauri tool interface.

Features

• Accepts notebook objects compatible with nbconvert.
• Exports Python source through nbconvert.PythonExporter.
• Supports optional custom templates.
• Returns the generated script as a string.
• Returns a structured error payload on export failure.

FAQ

Does this package write a .py file?

No. It returns the exported script text in exported_script.

What kind of input does it expect?

It expects a notebook object, not a file path and not a JSON string.

When should I use a custom template?

Use a custom template when you need a specific script layout, preamble, or code-cell transformation strategy.

Installation

uv add swarmauri_tool_jupyterexportpython

pip install swarmauri_tool_jupyterexportpython

Usage

from swarmauri_tool_jupyterexportpython import JupyterExportPythonTool

notebook = {
    "cells": [{"cell_type": "code", "metadata": {}, "source": "print('hello')", "outputs": []}],
    "metadata": {},
    "nbformat": 4,
    "nbformat_minor": 5,
}

result = JupyterExportPythonTool()(notebook=notebook)
print(result["exported_script"])

Examples

Export a notebook to Python

result = JupyterExportPythonTool()(notebook=notebook)
script = result["exported_script"]

Export with a custom template

result = JupyterExportPythonTool()(
    notebook=notebook,
    template_file="templates/python-export.tpl",
)

Related Packages

• swarmauri_tool_jupyterexporthtml
• swarmauri_tool_jupyterexportmarkdown
• swarmauri_tool_jupyterexportlatex
• swarmauri_tool_jupyterreadnotebook
• swarmauri_tool_jupyterwritenotebook

Foundational Swarmauri Packages

• swarmauri
• swarmauri_core
• swarmauri_base
• swarmauri_standard

More Documentation

• Swarmauri SDK repository
• nbconvert Python exporter docs
• Jupyter documentation