Home

Awesome

GitHub Action to Run Common Lisp Programs

This GitHub Action runs Common Lisp programs on GitHub runners where a Common Lisp implementation is already installed.

Continuous Integration

This action is complemented by other actions related to the Common Lisp eco system:

Usage

Create a workflow file in the.github/workflows directory of your working copy. This workflow file should use a MacOS runner or a Ubuntu Runner and use the branch v1 of this action.

An example workflow is available below. See the GitHub Help Documentation for Creating a workflow file to get started with GitHub workflows.

Outcomes

Once the action has been executed succesfully, the required Common Lisp program has been executed on the selected Common Lisp system, using the selected Common Lisp implementation.

Inputs

Outputs

This action has no outputs.

Example Workflow

name: 'Continuous Integration'
on:
  - workflow_dispatch
  - push

jobs:
  exercise-on-tier-1-platforms:
    strategy:
      matrix:
        implementation: ['abcl', 'sbcl']
        os: ['ubuntu-latest', 'macos-11', 'macos-12', 'macos-13']
    runs-on: '${{ matrix.os }}'
    name: 'Install Common Lisp'
    steps:
      - uses: actions/checkout@v3
      - name: 'Install MacPorts'
        if: runner.os == 'macOS'
        uses: melusina-org/setup-macports@v1
      - uses: melusina-org/setup-common-lisp@v1
        with:
          implementation: '${{ matrix.implementation }}'
      - uses: melusina-org/setup-quicklisp@v1
        with:
          implementation: '${{ matrix.implementation }}'
      - uses: melusina-org/run-common-lisp-program@v1
        with:
          implementation: '${{ matrix.implementation }}'
          system: 'uiop'
          entrypoint: 'quit'

License

The scripts and documentation in this project are released under the MIT License