GitHub Actions
Run BoxLang in your GitHub actions seamlessly.
To run BoxLang in your GitHub Actions workflow, you need to add a step to your workflow file to set up and execute BoxLang. Below is an example of how you can use the action to run BoxLang with default settings:
name: Run BoxLang
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Set up BoxLang
uses: ortus-boxlang/[email protected]
with:
version: latest # or specify a version like '1.2.3'
modules: "module1 module2" # optional: specify modules to install
- name: Run BoxLang Script
run: boxlangyour_script.bx
This setup installs BoxLang, optionally installs modules, and runs a BoxLang script within your repository. Adjust the version
and modules
as needed.
Inputs
The following are all the different input variables you can use with the action, allowing you to set up BoxLang in your GitHub Actions workflow.
modules
string
---
If added, a space-delimited list of modules to install upon installation of the binary for you.
version
semver
latest
The BoxLang version to install, if not passed we use the latest stable.
Tip: You can use snapshot
version to install the latest bleeding-edge version.
Usage Examples
Simple usage:
- name: Setup BoxLang
uses: ortus-boxlang/[email protected]
With Specific Modules:
- name: Setup BoxLang
uses: ortus-boxlang/[email protected]
with:
modules: bx-ai bx-orm bx-pdf
Install a specific version of BoxLang:
- name: Setup BoxLang with specific version
uses: ortus-boxlang/[email protected]
with:
version: snapshot
Here is another one:
- name: Setup BoxLang with specific version
uses: ortus-boxlang/[email protected]
with:
version: 1.1.0
System Requirements
This action will automatically install the following system packages if they are not already available:
openjdk-21-jre
(or equivalent) - Java Runtime Environment for BoxLang
Last updated
Was this helpful?