mojo_sdk

Summary

Sets up a new Mojo development environment for Linux (currently only works on x86_64).

Table of Contents

• mojo_sdk
  • Summary
  • Setup
  • Quickstart
  • Development
  • TODO
  • Further Reading

Setup

• Sign up for a free developer account at Modular
• Install
  • make
    • Debian/Ubuntu
    • macOS
  • Docker
  • editorconfig
  • wsl

Quickstart

• Docker

  # build docker container
  docker-compose build --pull
  
  # run oneshot docker container
  docker run -it --rm -v $(pwd):/app --workdir=/app --env-file=.env mojo_sdk-app bash
  
  # start docker container
  docker-compose up -d
  
  # exec into docker container
  docker-compose exec -it mojo-sdk bash
  
  # stop docker container
  docker-compose stop
  
  # remove docker container with volumes
  docker-compose down -v

• Mojo
  • Authenticate and install the Mojo SDK

    # authenticate
    modular auth $MODULAR_AUTH
    
    # install mojo
    modular install mojo

Development

# install dependencies (e.g., git, ansible, etc.)
./bootstrap install

# install tools and runtimes (cf. xcode, brew, asdf, poetry, etc.)
./bootstrap <run|run-dev>   # dev only runs plays w/tags and is verbose

# install git hooks
./bootstrap install-precommit

# update git hooks
./bootstrap update-precommit

TODO

• Open Issues
• Test on x86_64
  • macOS
    • Not supported yet
  • Ubuntu
  • Fedora
• QA Ansible playbook
• Write boilerplate pytest tests
• CI/CD

Further Reading

• Mojo Developer Console
• Modular Docs - Hello, world!
• python
• asdf
• poetry
• docker-compose
• pre-commit hooks