Getting started / Tutorials

Advanced Installation

Roswell as a scripting environment

Roswell as an implementation manager

Roswell as a Testing Environment

Distributing applications


For Developers/Maintainers

GitHub Actions

GitHub Actions is an automation service from GitHub. Its notable advantages are seamless GitHub integration and better OS support -- Ubuntu, macOS and Windows.

It's still in limited public beta and the API is likely to change. We're working on to improve its experience with Roswell, but please remember it is still quite experimental.

Getting Started

Add a workflow YAML file at .github/workflows/ci.yml something like this:

name: CI

on: [push]

    name: ${{ matrix.lisp }} on ${{ matrix.os }}
    runs-on: ${{ matrix.os }}
        lisp: [sbcl-bin]
        os: [ubuntu-latest, macOS-latest]

      - uses: actions/checkout@v1
      - name: Install Roswell
          LISP: ${{ matrix.lisp }}
        run: |
          curl -L | sh
      - name: Install Rove
        run: ros install rove
      - name: Run tests
        run: |
          rove qlot.asd

Known issues

  • The latest is required until 158bdeb6 will have been released.
  • [Windows] ROSWELL_INSTALL_DIR has to be set /c/roswell on Windows
  • Because /usr/local/bin is not in PATH.
  • /usr/bin is in PATH, but its actual directory path is under C:/Program Files/ and Roswell can't be executed when its pathname containing spaces.
  • Roswell exe file will be installed at /c/roswell/bin/ros.
  • [Windows] Roswell scripts can't be executed with cmd.exe
  • Execute them through ros command like C:\roswell\bin\ros %userprofile%\.roswell\bin\rove
  • Use bash by setting jobs.<job-id> to bash.
  • [Windows] ASDF configuration is not set
  • Set the source registry by yourself like /c/roswell/bin/ros -S . -s rove -e ...

See Also