MacOS Environment Setup

To set up your MacOS environment, follow these steps using Homebrew as the main package manager. Aim to install versions specified in build.assets/versions.mk; for others, use the latest Homebrew version.

The instructions below are provided on a best-effort basis. PRs with corrections and updates are welcome!

1. Install Homebrew

2. Install Go

   shellCopy

   brew install go
   

3. Install Rust

   Install rustup with Homebrew:

   shellCopy

   brew install rustup
   
   rustup-init
   # Accept defaults
   

4. Install Node.js

   1. Find the required Node version in build.assets/versions.mk (NODE_VERSION).

   2. Install Node.js (Homebrew only supports MAJOR version):

      shellCopy

      # Replace <version> with the MAJOR value of NODE_VERSION from build.assets/versions.mk (e.g., 22)
      brew install node@<version>
      

   3. Install to PATH and apply the changes to your shell:

      shellCopy

      # Replace <version> with the MAJOR value of NODE_VERSION from build.assets/versions.mk (e.g., 22)
      echo 'export PATH="/opt/homebrew/opt/node@<version>/bin:$PATH"' >> ~/.zshrc
      
      source ~/.zshrc
      

   4. Verify the installed version:

      shellCopy

      node --version
      

5. Install libfido2:

   shellCopy

   brew install libfido2
   

6. Install pkg-config:

   shellCopy

   brew install pkg-config
   

7. Install helm and the helm-unittest plugin:

   shellCopy

   brew install helm
   
   helm plugin install https://github.com/quintush/helm-unittest --version 0.2.11
   

8. Install bats:

   1. Find the required bats-core version from build.assets/Dockerfile (search for bats-core).

   2. Set the version variable and install bats-core:

      shellCopy

      # Replace <version> with the required bats-core version (e.g., 1.12.0)
      BATS_VERSION=1.12.0
      
      curl -L https://github.com/bats-core/bats-core/archive/v${BATS_VERSION}.tar.gz -o ~/Downloads/bats.tar.gz
      cd ~/Downloads
      tar xzvf bats.tar.gz
      sudo mkdir -p /usr/local/libexec
      sudo chown $USER /usr/local/libexec
      cd bats-core-${BATS_VERSION}
      sudo ./install.sh /usr/local
      cd ../
      rm -rf bats-core-${BATS_VERSION} bats.tar.gz
      

   3. Verify bats installation:

      shellCopy

      bats --version
      

9. Increase the maximum number of open files:

   shellCopy

   ulimit -n 2560 # 10x default
   

10. Test the environment by building development artifacts and running tests:

    shellCopy

    make all test
    

Congrats! Your MacOS environment is now ready for development 🎉

If you encounter any issues, please refer to the official documentation or open an issue in the repository for assistance.