LogoActions: GitHub Actions for the NetLogo Community 🚀

Hi everyone!

I’m excited to share my new NetLogo project: LogoActions.

LogoActions is a collection of GitHub Actions designed to facilitate the setup and execution of NetLogo models within GitHub workflows. These actions enable researchers and developers to automate the installation of NetLogo, run and test simulations, and integrate NetLogo with other tools and platforms, such as Quarto, logolink and pyNetLogo.

How It Works

A series of workflows examples are provided to demonstrate how to use the actions in practice. One is highlighted below.

Check NetLogo Models

This workflow shows how to use the check-netlogo action to automatically verify that all BehaviorSpace experiments in a repository’s NetLogo models run without errors. This is particularly useful for continuous integration (CI) workflows, ensuring that any changes to the models or experiments do not introduce issues.

You can view this workflow in action on the repository’s actions page. See the LogoClim model for a real-world example of how this action can catch errors early in the development process.

Below is a basic workflow configuration. Save it as check-netlogo.yaml inside the .github/workflows folder at the root of your repository. It will run on every commit pushed to the main branch.

on:
  push:
    branches: [main, master]

name: NetLogo Check
permissions: read-all

jobs:
  check-netlogo:
    name: Check NetLogo models
    runs-on: ubuntu-latest
    env:
      GH_TOKEN: ${{secrets.GITHUB_TOKEN}}
    steps:
      - name: Check out repository
        uses: actions/checkout@v4

      - name: Set up NetLogo
        uses: danielvartan/logoactions/setup-netlogo@v1

      - name: Check NetLogo models
        uses: danielvartan/logoactions/check-netlogo@v1

Learn more at: GitHub - danielvartan/logoactions: 🚀 GitHub Actions for the NetLogo Community

GitHub Stars are always appreciated! :star:

Cheers,

Daniel Vartanian

1 Like