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







審核編輯：劉清