⚡ Setup BoxLang GitHub Action

🚀 Automate your BoxLang setup - This GitHub Action sets up the BoxLang Dynamic JVM Language runtime for CI/CD workflows with optional CommandBox CLI and module installation.

📋 Inputs

Configure your BoxLang setup using these input parameters:

Input	Type	Default	Description
with-commandbox	boolean	false	If true, it will install the latest CommandBox as well.
commandbox_version	string	latest	The CommandBox version to install. Only used if with-commandbox is true.
commandbox_modules	string	---	If added, a comma-delimited list of CommandBox packages to install. Only used if with-commandbox is true.
forgeboxAPIKey	string	---	If added, it will configure the ForgeBox API Key in CommandBox. Only used if with-commandbox is true.
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.

🚀 Usage

Simple Setup

- name: Setup BoxLang
  uses: ortus-boxlang/setup-boxlang@1.1.0

📦 With BoxLang Modules

- name: Setup BoxLang
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    modules: bx-ai bx-orm bx-pdf

🎯 Specific Version

- name: Setup BoxLang with specific version
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    version: snapshot

📦 With CommandBox

- name: Setup BoxLang with CommandBox
  uses: ortus-boxlang/setup-boxlang@1.1.0
    with:
        with-commandbox: true

🔧 CommandBox with Specific Version

- name: Setup BoxLang with specific CommandBox version
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    with-commandbox: true
    commandbox_version: 6.0.0

🛠️ CommandBox with Modules

- name: Setup BoxLang with CommandBox and modules
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    with-commandbox: true
    commandbox_modules: commandbox-cfconfig,commandbox-dotenv

⚙️ Full Configuration Example

- name: Setup BoxLang with CommandBox (full setup)
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    with-commandbox: true
    commandbox_version: 6.0.0
    commandbox_modules: commandbox-cfconfig,commandbox-dotenv,commandbox-fusionreactor

Install BoxLang with CommandBox and ForgeBox API Key:

- name: Setup BoxLang with CommandBox and ForgeBox API Key
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    with-commandbox: true
    forgeboxAPIKey: ${{ secrets.FORGEBOX_API_KEY }}

Here is another one:

- name: Setup BoxLang with specific version
  uses: ortus-boxlang/setup-boxlang@1.1.0
  with:
    version: 1.1.0

📦 Action Outputs

This action provides the following outputs for use in subsequent workflow steps:

• boxlang-version: The version of BoxLang that was installed
• installation-path: The path where BoxLang was installed

🚀 About BoxLang

BoxLang is a modern dynamic JVM language that can be deployed on multiple runtimes: operating system (Windows/Mac/*nix/Embedded), web server, lambda, iOS, Android, web assembly, and more. BoxLang combines many features from different programming languages, including Java, CFML, Python, Ruby, Go, and PHP, to provide developers with a modern and expressive syntax.

✨ Why BoxLang?

• 🏎️ Rapid Application Development (RAD)
• 🔄 Dynamic, modular, and lightweight
• ☕ 100% Java & JVM-friendly
• 🎯 Multi-runtime: CLI, Web, Lambda, Mobile, and more
• 🔥 Not only a language but a framework

📚 Resources

• 🌐 Website
• 🧑‍💻 Try BoxLang Online
• 📖 Documentation
• 🎥 YouTube Channel
• 🎓 BoxLang Academy
• 💻 GitHub Organization
• 💬 Community Slack
• 💬 Community Forums
• 🕸️ Module Registry
• 🐦 Twitter
• 👔 LinkedIn
• 📘 Facebook
• 🫶 Support Us

---

Made with ❤️ by Ortus Solutions