Piccolo - 用純Rust實(shí)現(xiàn)的無(wú)棧Lua虛擬機(jī)

Piccolo，原名luster，在經(jīng)過(guò)數(shù)年的中斷后，于2023年4月悄然恢復(fù)了開(kāi)發(fā)。曾經(jīng)開(kāi)發(fā)過(guò) rlua 的 kyren，在底層gc-arenacrate 取得突破后，回到了piccolo項(xiàng)目。這兩個(gè)項(xiàng)目現(xiàn)在已經(jīng)（小心地）在生產(chǎn)中使用，比如 Fish Folk 用在了游戲腳本中，Ruffle 用于其 ActionScript 虛擬機(jī)。 如今兩個(gè)重要版本的發(fā)布了：piccolo v0.3.0 和 gc-arena v0.5。 Piccolo項(xiàng)目的目標(biāo)，按大致優(yōu)先級(jí)降序排列：

成為一個(gè)可以工作、有用的 Lua 解釋器。

成為一種簡(jiǎn)單而可靠的方式，用于安全地隔離不受信任的Lua腳本。

抵御來(lái)自不受信任腳本的 DoS 攻擊（腳本不能夠?qū)е陆忉屍鞅罎⒒蚴褂脽o(wú)限量的內(nèi)存，并應(yīng)保證在有限時(shí)間內(nèi)返回控制權(quán)給調(diào)用者）。

提供一種安全地將 Rust API 綁定到 Lua 的簡(jiǎn)便方法，具有對(duì)異常情況和邊緣情況具有處理的綁定系統(tǒng)，并且用戶(hù)類(lèi)型可以安全地參與運(yùn)行時(shí)垃圾回收。

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

不要過(guò)于緩慢（例如，避免不必要的抽象化）。

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

看起來(lái)像是這樣：

原文是一個(gè)詳盡的教程，告訴讀者如何一步一步的實(shí)現(xiàn)這個(gè)例子，感興趣的可以查看原文。最終實(shí)現(xiàn)其實(shí)代碼很簡(jiǎn)潔：

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(())
}







審核編輯：劉清