Pyjaco - Python 到 JavaScript 编译器技术文档

1. 安装指南

Pyjaco 是一个将 Python 代码编译为 JavaScript 代码的工具。以下是几种安装 Pyjaco 的方式：

使用 virtualenv 安装

git clone https://github.com/chrivers/pyjaco
virtualenv nameOfVenv
cd pyjaco
../nameOfVenv/bin/python setup.py install

标准安装

git clone https://github.com/chrivers/pyjaco
cd pyjaco
python setup.py install

使用 make 安装

git clone https://github.com/chrivers/pyjaco
cd pyjaco
make

2. 项目的使用说明

Pyjaco 提供了两种主要的使用方式：将 Python 文件编译为 JavaScript 文件，以及在 Python 脚本中调用编译器。

将 Python 文件编译为 JavaScript 文件

pyjs.py [options] <infile> -o <outfile>

其中 <infile> 是要编译的文件名。如果 <infile> 是一个目录，则该目录中所有扩展名为 .py 或 .pyjaco 的文件将被编译为 .js 文件，并输出到指定目录。

在 Python 脚本中调用编译器

import sys
from pyjaco import Compiler
code = open("tojs.py", "r")
compiler = Compiler()
compiler.append_string(code.read())
print str(compiler)

3. 项目 API 使用文档

Pyjaco 提供了一个简单的 API，允许用户在 Python 脚本中直接调用编译器。以下是 API 的基本用法：

导入编译器

from pyjaco import Compiler

创建编译器实例

compiler = Compiler()

添加要编译的代码

compiler.append_string(code.read())

获取编译后的 JavaScript 代码

print str(compiler)

4. 项目安装方式

Pyjaco 可以通过多种方式安装，具体取决于用户的需求和环境。以下是几种常见的安装方式：

使用 virtualenv 安装

git clone https://github.com/chrivers/pyjaco
virtualenv nameOfVenv
cd pyjaco
../nameOfVenv/bin/python setup.py install

标准安装

git clone https://github.com/chrivers/pyjaco
cd pyjaco
python setup.py install

使用 make 安装

git clone https://github.com/chrivers/pyjaco
cd pyjaco
make

5. 测试

Pyjaco 自带测试工具，但运行测试集需要一个 JS 控制台。以下是运行测试的命令：

运行所有测试

./run_tests.py

运行包含特定名称的测试

./run_tests.py foo

运行所有测试，包括已知失败的测试

./run_tests.py -a

运行测试但忽略错误

./run_tests.py -x

6. 单例测试

使用 casetest 脚本可以持续比较 Pyjaco 和 Python 对同一脚本的输出。这对于调试编译器或标准库非常有用。

./casetest foo.py

7. 许可证

Pyjaco 是自由软件，详细信息请参阅 LICENSE 文件。

---

通过本文档，用户可以详细了解 Pyjaco 的安装、使用、API 调用以及测试方法。希望这些信息能帮助您更好地使用 Pyjaco。