Mojo Build Package Skill

Build compiled Mojo packages for distribution and reuse.

When to Use

• Creating distributable libraries
• Packaging phase of development
• Preparing for package installation
• Building modular components

Quick Reference

# Build single package
mojo package src/tensor -o packages/tensor.mojopkg

# Build and test
./scripts/build_package.sh tensor --test

# Build all packages
./scripts/build_all_packages.sh

Workflow

1. Verify structure - Check __init__.mojo exists
2. Build package - Run mojo package or script
3. Test imports - Verify package can be imported
4. Verify exports - Check __all__ in __init__.mojo

Mojo-Specific Notes

• Every package needs __init__.mojo entry point
• Export public API in __all__ list
• Packages compile to .mojopkg binary format
• No circular dependencies allowed

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | Missing __init__.mojo | No package entry point | Add __init__.mojo to package dir | | Circular dependency | Modules depend on each other | Refactor to break cycle | | Export not found | Missing from __all__ | Add name to __all__ list | | Build failed | Syntax errors in module | Fix syntax before building |

References

• .claude/shared/mojo-guidelines.md - Function definition patterns
• Package metadata template: templates/package_toml.toml