PocketPy

PocketPy是一个轻量级的Python解释器，为嵌入至游戏引擎而设计。

它包含一个编译器和基于字节码的虚拟机，以及交互式命令窗的实现。所有功能均集成在单个头文件pocketpy.h中，不包含外部依赖项，能很方便地嵌入至你的应用。

你可以在浏览器中体验 PocketPy的交互式界面（REPL）。

支持的语法特性

特性	示例	支持
分支	`if..else..elif`	YES
循环	`for/while/break/continue`	YES
函数	`def f(x,*args,y=1):`	YES
类与继承	`class A(B):`	YES
列表	`[1, 2, 'a']`	YES
列表生成式	`[i for i in range(5)]`	YES
切片	`a[1:2], a[:2], a[1:]`	YES
元组	`(1, 2, 'a')`	YES
字典	`{'a': 1, 'b': 2}`	YES
格式化字符串	`f'value is {x}'`	YES
序列解包	`a, b = 1, 2`	YES
异常	`raise/try..catch`	YES
动态分发	`eval()/exec()`	YES
反射	`hasattr()/getattr()/setattr()`	YES
导入模块	`import/from..import`	YES
上下文管理器	`with <expr> as <id>:`	YES
类型标注	`def f(a:int, b:float=1)`	YES
生成器	`yield i`	YES
装饰器	`@cache`	YES

快速上手

根据你所使用的语言和平台选择对应的插件。

C/C++

你可以在 Github Release 页面下载pocketpy.h，并加入到你的工程中。请参考C-API相关的说明，对于C++，你也可以使用VM类的方法操作虚拟机。

#include "pocketpy.h"

int main(){
    // 创建一个虚拟机
    auto vm = pkpy_new_vm(true);
    
    // Hello world!
    pkpy_vm_exec(vm, "print('Hello world!')");

    // 构建一个列表
    pkpy_vm_exec(vm, "a = [1, 2, 3]");

    // 对列表进行求和
    char* result = pkpy_vm_eval(vm, "sum(a)");
    printf("%s", result);   // 6

    // 释放资源
    pkpy_delete(result);
    pkpy_delete(vm);
    return 0;
}

Unity Engine

你可以在Unity资源商店下载PocketPy的C#插件，支持Windows/MacOS/Android/iOS平台。

https://assetstore.unity.com/packages/slug/241120

using UnityEngine;

public class Test01 : MonoBehaviour
{
    void Start()
    {
        // 创建一个虚拟机
        pkpy.VM vm = new pkpy.VM();

        // 构造一个列表
        vm.exec("a = [1, 2, 3]");

        // 对列表进行求和
        string result = vm.eval("sum(a)");
        Debug.Log(result);   // 6

        // 打印变量`a`，并读取标准输出
        vm.exec("print(a)");
        pkpy.PyOutput o = vm.read_output();
        Debug.Log(o.stdout); // [1, 2, 3]

        // 构造一个函数绑定
        vm.bind("builtins", "test", (double x) => x+1);  
        Debug.Log(vm.eval("test(3.14)")); // '4.14'
    }
}

Flutter

使用下列命令安装pocketpy的Flutter插件，支持Windows/Android/iOS/Web平台。

flutter pub add pocketpy

详细配置请参考 https://pocketpy.dev/getting-started/flutter/

预编译库

你可以在 Github Release 页面下载artifact.zip，这个压缩包中包含了一套预编译库。结构如下。

- android/
  - arm64-v8a/
    - libpocketpy.so
  - armeabi-v7a/
    - libpocketpy.so
  - x86_64/
    - libpocketpy.so
- linux/
  - x86_64/
    - pocketpy
    - pocketpy.so
- macos/
  - pocketpy.bundle/
- web/
  - lib/
    - pocketpy.js
    - pocketpy.wasm
- windows/
  - x86_64/
    - pocketpy.dll
    - pocketpy.exe

参考

开源协议

MIT License

4.8 KiB Raw Blame History Unescape Escape