Skip to content
box

GitHub Action

Make a Common Lisp Program

v1.0.1 Latest version

Make a Common Lisp Program

box

Make a Common Lisp Program

Make a Common Lisp program running a specific Common Lisp system

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Make a Common Lisp Program

uses: melusina-org/make-common-lisp-program@v1.0.1

Learn more about this action in melusina-org/make-common-lisp-program

Choose a version

GitHub Action to Make Common Lisp Programs

This GitHub Action makes 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, a Ubuntu Runner or a Windows 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 made under the pathname saved in the build-pathname action output.

Inputs

  • implementation — The Common Lisp implementation to setup QuickLisp for. This can be one of the values ecl sbcl and in the future we would like to support all of abcl clasp clisp ecl gcl sbcl and maybe other implementations. Please open an issue to express interest for other implementations.

  • system: The Common Lisp system where the program resides. This common Lisp system must have specific ASDF annotations, such as build-pathname. See ASDF Best practices

Outputs

  • build-pathname — The pathname to the program made by ASDF.

Example Workflow

name: 'Continuous Integration'
on:
  workflow_dispatch:
  push:
    branches-ignore:
      - v1
    tags-ignore:
      - v1.*

jobs:
  exercise-on-tier-1-platforms:
    strategy:
      matrix:
        implementation: ['sbcl']
        os: ['ubuntu-latest', 'macos-latest', 'windows-latest']
    runs-on: '${{ matrix.os }}'
    name: 'Exercise on Tier 1 Platform'
    steps:
      - uses: actions/checkout@v4
      - name: 'Install MacPorts'
        if: runner.os == 'macOS'
        uses: melusina-org/setup-macports@v1
      - name: 'Setup Common Lisp'
        uses: melusina-org/setup-common-lisp@v1
        with:
          implementation: '${{ matrix.implementation }}'
      - name: 'Setup Quicklisp'
        uses: melusina-org/setup-quicklisp@v1
        id: quicklisp
        with:
          implementation: '${{ matrix.implementation }}'
      - name: 'Install CL-GITHUB-ACTIONS'
        uses: actions/checkout@v4
        with:
          repository: melusina-org/cl-github-actions
          path: ${{ steps.quicklisp.outputs.quicklisp-local-projects }}/cl-github-actions
      - name: 'Run unit tests'
        uses: melusina-org/run-common-lisp-program@v1
        with:
          implementation: '${{ matrix.implementation }}'
          system: 'org.melusina.github-action.make-common-lisp-program/testsuite'
          entrypoint: 'unit-tests'
      - name: 'Checkout Common Lisp Reference Utility'
        uses: actions/checkout@v4
        with:
          repository: melusina-org/reference-utility
          path: ${{ steps.quicklisp.outputs.quicklisp-local-projects }}/reference-utility
      - name: 'Make Common Lisp Reference Utility'
        uses: melusina-org/make-common-lisp-program@v1
        id: make
        with:
          implementation: '${{ matrix.implementation }}'
          system: 'org.melusina.reference-utility/executable'
      - name: 'Run Common Lisp Reference Utility'
        shell: sh
        run: |
          ${{ steps.make.outputs.build-pathname }}
      - name: 'Upload Common Lisp Reference Utility'
        uses: actions/upload-artifact@v3
        with:
          name: Common Lisp Reference Utility ${{ matrix.implementation }} ${{ runner.os }} ${{ runner.arch }}
          path: ${{ steps.make.outputs.build-pathname }}

License

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