hat 🎩

A thin wrapper over pixi to make common mojo related task easier.

Install

pixi global install \
  --channel conda-forge \
  --channel https://conda.modular.com/max-nightly \
  --channel https://repo.prefix.dev/modular-community \
  --git https://github.com/sstadick/hat

# Add the pixi dir to your path
export PATH="$HOME/.pixi/bin:$PATH"

Usage

# Create a new binary project
hat new --name mojo-grep --nightly

# Create a new lib project
hat new --lib --nightly --name amazing-lib

# Build project (defaults to release build)
hat build 

# Build with debug and asserts on
hat build --debug

# Test your project
hat test

Note that this sets up a fully functioning pixi project that relies on the 'pixi-build-mojo` backend. There is no magic here, you can look at the pixi.toml and fall back to running pixi / mojo commands as needed.

Libraries and packages created this way can be relied on via git paths and don't technically need to be published on conda to be used by others. If you do wish to publish on modular-community you will need to create recipe.yml and go through the steps outlined in that repo. (Automatic creation of the recipe file is on the roadmap for this tool).

Warning

Since hat relies on the pixi.toml, and some tasks defined there, changing any of the pre-defined tasks may break hat.

Known issues

• Some of the text-forwarding from running pixi commands gets odd re-formatting.

Future directions

• Reduce reliance on pixi the cli tool, add bindings to the core pixi libs and call them directly.

TODOs

• Add a generate-recipe subcommand to export a recipe that can be used for rattler
• Add some ENV VARS to the build env that hat uses such as project version, project name, etc by parsing the pixi toml file. This allows CLI tools to pull those in at comptime.