Piccolo-用纯Rust实现的无栈Lua虚拟机

Piccolo - 用纯Rust实现的无栈Lua虚拟机

Piccolo，原名luster，在经过数年的中断后，于2023年4月悄然恢复了开发。曾经开发过 rlua 的 kyren，在底层gc-arenacrate 取得突破后，回到了piccolo项目。这两个项目现在已经（小心地）在生产中使用，比如 Fish Folk 用在了游戏脚本中，Ruffle 用于其 ActionScript 虚拟机。 如今两个重要版本的发布了：piccolo v0.3.0 和 gc-arena v0.5。 Piccolo项目的目标，按大致优先级降序排列：

成为一个可以工作、有用的 Lua 解释器。

成为一种简单而可靠的方式，用于安全地隔离不受信任的Lua脚本。

抵御来自不受信任脚本的 DoS 攻击（脚本不能够导致解释器崩溃或使用无限量的内存，并应保证在有限时间内返回控制权给调用者）。

提供一种安全地将 Rust API 绑定到 Lua 的简便方法，具有对异常情况和边缘情况具有处理的绑定系统，并且用户类型可以安全地参与运行时垃圾回收。

与某些版本的 PUC-Rio Lua 兼容。

不要过于缓慢（例如，避免不必要的抽象化）。

使用 Rust 生成 IP 地址的 PNG 图片

看起来像是这样：

原文是一个详尽的教程，告诉读者如何一步一步的实现这个例子，感兴趣的可以查看原文。最终实现其实代码很简洁：

use std::{io::Cursor, net::SocketAddr, sync::OnceLock};

use axum::{
extract::ConnectInfo,
http::{header, StatusCode},
response::IntoResponse,
routing::get,
Router,
};
use image::{ImageBuffer, ImageOutputFormat, Rgb};
use imageproc::drawing::draw_text_mut;
use rusttype::{Font, Scale};

const X: i32 = 8;
const Y: i32 = 96;
const WIDTH: u32 = 256;
const HEIGHT: u32 = WIDTH;
const TEXT_COLOR: Rgb= Rgb([235, 219, 178]);
const BACKGROUND_COLOR: Rgb= Rgb([177, 98, 134]);
const SCALE: Scale = Scale { x: 32.0, y: 32.0 };
const FONT_DATA: &[u8] = include_bytes!(concat!(
env!("CARGO_MANIFEST_DIR"),
"/fonts/UbuntuMono-R.ttf"
));

#[derive(Debug, thiserror::Error)]
#[error("Failed to generate image: {0}")]
struct AvatarError(#[from] image::ImageError);

impl IntoResponse for AvatarError {
fn into_response(self) -> axum::response::Response {
(StatusCode::INTERNAL_SERVER_ERROR, self.to_string()).into_response()
}
}

fn font() -> &'static Font<'static> {
static FONT: OnceLock= OnceLock::new();
FONT.get_or_init(|| Font::try_from_bytes(FONT_DATA).expect("Built-in font data was invalid"))
}

async fn avatar(
ConnectInfo(addr): ConnectInfo,
) -> Result {
// Wow, IPv6 causes a lot of headache.
let ip = addr.ip().to_canonical();
letmut img = ImageBuffer::from_pixel(WIDTH, HEIGHT, BACKGROUND_COLOR);

draw_text_mut(&mut img, TEXT_COLOR, X, Y, SCALE, font(), "Hello,");
let y = Y + SCALE.y asi32;
draw_text_mut(&mut img, TEXT_COLOR, X, y, SCALE, font(), &format!("{ip}!"));

letmut cursor = Cursor::new(vec![]);
img.write_to(&mut cursor, ImageOutputFormat::Png)?;

Ok(([(header::CONTENT_TYPE, "image/png")], cursor.into_inner()))
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
let app = Router::new().route("/avatar.png", get(avatar));

let listener = tokio::net::TcpListener::bind("[::]:3000").await?;
let make_service = app.into_make_service_with_connect_info::();
axum::serve(listener, make_service).await?;
Ok(())
}







审核编辑：刘清