PyExecJS 技术文档

1. 安装指南

由于 PyExecJS 项目已经停止维护，建议用户考虑使用其他替代库。如果仍需使用 PyExecJS，可以通过以下方式进行安装：

$ pip install PyExecJS

或者使用 easy_install：

$ easy_install PyExecJS

2. 项目的使用说明

PyExecJS 是一个从 Ruby 的 ExecJS 移植过来的 Python 库，允许在 Python 中运行 JavaScript 代码。PyExecJS 会自动选择最佳的 JavaScript 运行时来执行代码。

2.1 基本用法

以下是一个简单的示例，展示了如何在 Python 中使用 PyExecJS 运行 JavaScript 代码：

import execjs

# 直接执行 JavaScript 表达式
result = execjs.eval("'red yellow blue'.split(' ')")
print(result)  # 输出: ['red', 'yellow', 'blue']

# 编译并执行 JavaScript 函数
ctx = execjs.compile("""
    function add(x, y) {
        return x + y;
    }
""")
result = ctx.call("add", 1, 2)
print(result)  # 输出: 3

2.2 选择运行时

PyExecJS 支持多种 JavaScript 运行时，包括 Node.js、PhantomJS、Nashorn 等。可以通过设置环境变量 EXECJS_RUNTIME 来指定默认的运行时：

import os
import execjs

os.environ["EXECJS_RUNTIME"] = "Node"
runtime_name = execjs.get().name
print(runtime_name)  # 输出: Node.js (V8)

也可以通过 execjs.get() 手动选择运行时：

import execjs
import execjs.runtime_names

# 选择 Node.js 运行时
node = execjs.get(execjs.runtime_names.Node)
result = node.eval("1 + 2")
print(result)  # 输出: 3

3. 项目API使用文档

3.1 execjs.eval(expression)

• 功能: 直接执行 JavaScript 表达式并返回结果。
• 参数:
  • expression (str): 要执行的 JavaScript 表达式。
• 返回值: 表达式的执行结果。

3.2 execjs.compile(source)

• 功能: 编译 JavaScript 代码，返回一个可调用的上下文对象。
• 参数:
  • source (str): 要编译的 JavaScript 代码。
• 返回值: 一个可调用的上下文对象。

3.3 ctx.call(function_name, *args)

• 功能: 调用编译后的 JavaScript 函数。
• 参数:
  • function_name (str): 要调用的函数名。
  • *args: 传递给函数的参数。
• 返回值: 函数的执行结果。

3.4 execjs.get(runtime_name=None)

• 功能: 获取指定的 JavaScript 运行时。如果不指定 runtime_name，则自动选择最佳运行时。
• 参数:
  • runtime_name (str, 可选): 运行时名称，如 Node、PhantomJS 等。
• 返回值: 一个运行时对象。

4. 项目安装方式

PyExecJS 可以通过 pip 或 easy_install 进行安装：

$ pip install PyExecJS

或者：

$ easy_install PyExecJS

安装完成后，即可在 Python 代码中导入并使用 execjs 模块。

---

注意: 由于 PyExecJS 已经停止维护，建议用户考虑使用其他替代库，如 js2py 或 dukpy。