modo

README

Modo🧯

Modo🧯 is a documentation generator (DocGen) for the Mojo🔥 programming language. It generates Markdown for static site generators (SSGs) from mojo doc JSON output.

This example in the User guide shows a Mojo🔥 package processed with Modo🧯 and rendered with Hugo, to demonstrate Modo🧯's features.

Features

• Generates Mojo🔥 API docs for Hugo, mdBook or just plain Markdown.
• Super easy to set up for an existing Mojo🔥 project.
• Provides a simple syntax for code cross-references.
• Optionally structures API docs according to package re-exports.
• Optionally extracts doc-tests for mojo test from code blocks.
• Customizable output through user templates.

See the User guide for more information. See the Modo🧯 slides for a feature overview.

Installation

Using Python

Modo🧯 is available on PyPI as pymodo. Install it with pip:

pip install pymodo

This installs the modo command. If the command is not found, try:
python -m pymodo

Using Go

With Go installed, you can install Modo🧯 like this:

go install github.com/mlange-42/modo@latest

With Go, you can also install the latest development version:
go install github.com/mlange-42/modo@main

Precompiled binaries

Pre-compiled binaries for manual installation are available in the Releases for Linux, Windows and MacOS.

Usage

To initialize an existing Mojo🔥 project for Modo🧯 and an SSG like Hugo, run command init once:

modo init hugo

This sets up everything to be able to build Markdown files for the target SSG with command build:

modo build

Finally, serve or build the site with the target SSG (here Hugo):

hugo serve -s docs/site/

See Project setup for details and other supported SSGs.

Packages using Modo🧯

• Larecs🌲 -- a performance-centred archetype-based ECS (docs).
• ExtraMojo -- a collection of useful things that aren't (yet) in the standard library (docs).

License

This project is distributed under the MIT license.

Documentation

Overview

Package modo provides a documentation generator (DocGen) for the Mojo programming language.

⚠️ Warning: Modo is primarily a command line tool, and the Go package is provided without any warranty or support. Semantic versioning refers to the binaries, so breaking changes to the package can happen at any time.