Mojo FFI: Build and Publish a mojo package based on the Rust library

[hhstore]

📖 Abstract:

• ✅ 构建并发布一个基于 Rust 库 + FFI binding 实现的 Mojo 包。

💯 Related:

• ✅ #433
• ✅ #432
• ✅ #355

[hhstore]

构建+发布一个 Mojo 包（基于 rust 库 + FFI binding 实现）

目标：

• 基于一个 rust-lib 库，开发一个 rust-lib-ffi 库，并发布到 prefix.dev 包平台。
• 基于 rust-lib-ffi库，开发一个 mojo 库，并发布到 prefix.dev 平台。
• 也就是说：需要发布2个库(前者是 libxxx.dylib or .so or .dll, 后者是 .mojopkg 格式)

工具：

conda-build

• https://prefix.dev/channels/conda-forge/packages/conda-build
• https://github.com/conda/conda-build

pixi add conda-build

参考：

• https://conda.org/blog/2023-05-18-how-to-use-conda-build/
• https://docs.conda.io/projects/conda-build/en/latest/install-conda-build.html
• https://github.com/conda/conda-build/issues/4127

pixi + rattler-build

• https://github.com/prefix-dev/pixi
• https://github.com/prefix-dev/rattler-build
• 截至当前， rattler-build 尚未支持直接打包一个 rust lib 到包平台。

参考：

• https://prefix-dev.github.io/rattler-build/latest/tutorials/rust/
• https://pixi.sh/latest/tutorials/rust/
• https://pixi.sh/latest/FAQ/#where-is-pixi-build
• https://github.com/prefix-dev/pixi-build

[hhstore]

magic 打包 mojo 包目录格式：

• 截至目前， magic 工具，目前只支持打包 2 种包格式：

# support
src/xxx_package/__init__.mojo

# support
xxx_package/__init__.mojo

# not support
src/__init__.mojo

• 不支持 src/__init__.mojo 这种包格式，（踩坑，单元测试也不支持）
• 后续应该可以在 mojoproject.toml 增加配置项来支持。

[hhstore]

mojo 包安装路径：

• 使用 magic 打包 mojo 包，打包配置文件，需要把包路径指定为 /lib/mojo
• 这样安装包时， 会把包安装到 .magic/envs/default/lib/mojo/ 路径下， 这样才能正常导包

[hhstore]

Mojo 打包示例项目

jojo-core

• https://github.com/better-mojo/jojo/tree/main/packages/jojo-core
• 这是一个 mojo lib， 已经发布到 prefix.dev 平台: jojo_core
• 项目内，包含所有的发布配置和构建脚本。

jojo-cli

• https://github.com/better-mojo/jojo/tree/main/packages/jojo-cli
• 这是 jojo 项目的脚手架，包含对 jojo-core 包的使用示例代码。

[hhstore]

使用 conda-build 构建 rust lib

• 目标：将一个普通的 rust lib, 构建为 .conda 包，并发布到包平台。

docs:

• https://docs.conda.io/projects/conda-build/en/latest/user-guide/recipes/sample-recipes.html

rust lib 构建示例：

• https://github.com/conda-forge/kornia-rs-feedstock
• https://github.com/conda-forge/rustworkx-feedstock
• 找到一个基于 conda-build 打包 rust 库的构建项目
• 参考此项目，应该可以解决构建问题

[hhstore]

1

[hhstore]

1

[hhstore]

1

[hhstore]

1

[hhstore]

1

[hhstore]

1

[hhstore]

1

[hhstore]

1

[hhstore]

1