Mops

Mops is a package manager for the Motoko programming language.

• Motoko Package Registry
• Documentation
• Blog
• CLI

Setup

1. Check system requirements

• Node.js
• DFX >= 0.10.0

2. Install CLI tool

curl -fsSL cli.mops.one/install.sh | sh

or

npm i -g ic-mops

Install Packages

1. Configure dfx.json

Add mops as a packtool to your dfx.json

{
  "defaults": {
    "build": {
      "packtool": "mops sources"
    }
  }
}

2. Initialize

Run this command in the root directory of your project (where is dfx.json placed)

mops init

3. Install Motoko Packages

Use mops add <package_name> to install a specific package and save it to mops.toml

mops add base

You can also add packages from GitHub like this

mops add https://github.com/dfinity/motoko-base

For GitHub-packages you can specify branch, tag, or commit hash by adding #<branch/tag/hash>

mops add https://github.com/dfinity/motoko-base#moc-0.9.1

You can also add local packages like this (put source files inside src directory)

mops add ./shared

Use mops install to install all packages specified in mops.toml

mops install

4. Import Package

Now you can import installed packages in your Motoko code

import PackageName "mo:<package_name>";

for example

import Itertools "mo:itertools/Iter";

Publish a Package

1. Import Identity

Create new identity to publish packages

dfx identity new mops

Import identity into mops

mops user import -- "$(dfx identity export mops)"

2. Initialize

Run this command in your package root and select type "Package"

mops init

Edit description and repository fields in mops.toml file.

Write your package code in *.mo source files in the src/ directory.

Create README.md file with information on how to use your package.

3. Publish

Publish package to the mops registry!

mops publish

Built for the Supernova Hackathon