在现代软件开发中，常常需要将不同语言的代码进行整合，以便充分利用各语言的优势。Node.js 和 Python 作为两种流行的语言，各有千秋，而 Python-Shell 库则为它们之间搭建了一座桥梁，使得开发者能够轻松地在 Node.js 中运行 Python 代码，并实现高效的数据交互。
Python-Shell 库概述
Python-Shell 是一个轻量级的 Node.js 库，它允许开发者在 Node.js 环境中执行 Python 脚本，并实现与 Python 代码的双向通信。该库的核心功能是通过子进程的方式启动 Python 解释器，并利用标准输入输出流 (stdin/stdout) 进行数据传递。
Python-Shell 库的功能特点
• 可靠地启动 Python 脚本： Python-Shell 使用 Node.js 的 child_process 模块，能够可靠地创建 Python 子进程并执行脚本。
• 多种数据模式： 支持文本 (text)、JSON 和二进制 (binary) 数据模式，满足不同场景下的数据交换需求。
• 自定义解析器和格式化器： 提供可扩展性，允许开发者根据需要自定义数据解析和格式化方式。
• 高效的数据传递： 通过标准输入输出流进行数据传递，确保数据的快速传输。
• 错误处理机制： 当 Python 脚本出现错误时，Python-Shell 会捕获并抛出错误，并提供详细的错误信息和堆栈跟踪信息。
安装 Python-Shell 库
使用 npm 包管理器安装 Python-Shell 库：
npm install python-shell
使用 Python-Shell 库执行 Python 代码
1. 运行 Python 字符串
import {PythonShell} from'python-shell';PythonShell.runString('x=1+1;print(x)', null).then(messages => {console.log('finished');});
该示例展示了如何使用 runString 方法直接执行 Python 代码字符串。如果脚本执行成功，then 方法中的回调函数会被调用，并传入一个包含脚本输出结果的消息数组。
2. 运行 Python 脚本
import {PythonShell} from'python-shell';PythonShell.run('my_script.py', null).then(messages => {console.log('finished');});
该示例展示了如何使用 run 方法执行指定路径的 Python 脚本。参数 null 表示使用默认选项。
3. 使用参数和选项运行 Python 脚本
import {PythonShell}from'python-shell';let options ={mode:'text',pythonPath:'path/to/python',scriptPath:'path/to/my/scripts',args:['value1','value2','value3']};PythonShell.run('my_script.py', options).then(messages =>{console.log('results: %j', messages);});
该示例展示了如何使用 options 对象传递参数和选项。mode 用于指定数据模式，pythonPath 指定 Python 解释器路径，scriptPath 指定脚本搜索路径，args 用于传递参数。
与 Python 代码交换数据
import {PythonShell}from'python-shell';let pyshell =newPythonShell('my_script.py');// 发送消息到 Python 脚本pyshell.send('hello');pyshell.on('message',function(message){// 接收 Python 脚本发送的消息console.log(message);});// 关闭输入流，允许进程退出pyshell.end(function(err, code, signal){if(err)throw err;console.log('The exit code was: '+ code);console.log('The exit signal was: '+ signal);console.log('finished');});
该示例展示了如何使用 send 方法向 Python 脚本发送消息，以及如何使用 on 方法监听 Python 脚本发送的消息。end 方法用于关闭输入流，允许 Python 脚本正常退出。
总结
Python-Shell 库为开发者提供了一个简单而强大的工具，使得在 Node.js 环境中运行 Python 代码变得更加容易。该库支持多种数据模式、自定义解析器和格式化器，以及错误处理机制，可以满足各种开发需求。
项目地址：https://github.com/extrabacon/python-shell
