We're excited to announce the release of the Setup BoxLang GitHub Action – a powerful new tool that makes it incredibly easy to integrate BoxLang into your continuous integration and deployment workflows with GitHub actions. Whether you're building applications, running tests, or deploying BoxLang projects, this action eliminates the complexity of environment setup and gets you coding faster.
Why This Matters
Setting up BoxLang in CI environments has traditionally required multiple manual steps: installing Java, downloading BoxLang binaries, configuring paths, and installing necessary modules. With the Setup BoxLang Action, all of this complexity disappears into a single, simple step in your GitHub workflow.
Key Features
🚀 One-Step Installation: Get BoxLang running in your GitHub Actions workflow with just a few lines of YAML.
📦 Automatic Module Management: Install any BoxLang modules you need directly during setup – no additional scripts required.
⚡ Version Flexibility: Choose from the latest stable release, bleeding-edge snapshots, or pin to specific versions for consistent builds.
🔧 Zero Configuration: The action automatically handles Java installation and environment setup, so you can focus on your code.
Getting Started
The simplest usage couldn't be easier:
- name: Setup BoxLang
uses: ortus-boxlang/setup-boxlang@1.0.0
That's it! This single step will install the latest stable version of BoxLang and have it ready for your workflow.
Advanced Usage Examples
Installing Specific Modules
Need AI capabilities, ORM functionality, or PDF generation? Install multiple modules at once:
- name: Setup BoxLang with modules
uses: ortus-boxlang/setup-boxlang@1.0.0
with:
modules: bx-ai bx-orm bx-pdf
Version Control
For production deployments, you might want to pin to a specific version:
- name: Setup BoxLang with specific version
uses: ortus-boxlang/setup-boxlang@1.0.0
with:
version: 1.1.0
Or if you're feeling adventurous and want the latest features:
- name: Setup BoxLang snapshot
uses: ortus-boxlang/setup-boxlang@1.0.0
with:
version: snapshot
Complete Workflow Example
Here's how you might use the Setup BoxLang Action in a real CI workflow:
name: BoxLang CI
on:
push:
branches: [ main, develop ]
pull_request:
branches: [ main ]
jobs:
test:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup BoxLang
uses: ortus-boxlang/setup-boxlang@1.0.0
with:
modules: bx-orm bx-pdf
version: latest
- name: Run tests
run: boxlang tests.bx
- name: Build application
run: boxlang Build.bx
System Requirements Made Simple
Don't worry about Java installation – the action automatically installs OpenJDK 21 if it's not already available on the runner. Everything is handled for you behind the scenes.
Available Configuration Options
| Option | Description | Default |
|---|---|---|
modules | Space-delimited list of BoxLang modules to install | None |
version | BoxLang version (latest, snapshot, or specific version) | latest |
Real-World Benefits
Faster Onboarding: New team members can contribute immediately without complex local setup procedures.
Consistent Environments: Every build runs in the same BoxLang environment, eliminating "works on my machine" issues.
Simplified Maintenance: No more maintaining custom installation scripts or Docker images just for BoxLang setup.
Module Management: Easily test different module combinations across different branches or environments.
Getting Started Today
The Setup BoxLang Action is available now in the GitHub Marketplace. Simply add it to your workflow file and start building with BoxLang in minutes, not hours.
Visit the ortus-boxlang/setup-boxlang repository for complete documentation, examples, and the latest updates.
Ready to supercharge your BoxLang CI/CD pipeline? Give the Setup BoxLang Action a try and let us know how it improves your development workflow!
Professional Open Source
BoxLang is a professional open-source product, with three different licences:
- Open-Source Apache2
- BoxLang +
- BoxLang ++
BoxLang is free, open-source software under the Apache 2.0 license. We encourage and support community contributions. BoxLang+ and BoxLang ++ are commercial versions offering support and enterprise features. Our licensing model is based on fairness and the golden rule: Do to others as you want them to do to you. No hidden pricing or pricing on cores, RAM, SaaS, multi-domain or ridiculous ways to get your money. Transparent and fair.
BoxLang is more than just a language; it's a movement.
Join us and redefine development on the JVM Ready to learn more? Explore BoxLang's Features, Documentation, and Community.
Join the BoxLang Community ⚡️
Be part of the movement shaping the future of web development. Stay connected and receive the latest updates on surrounding anything BoxLang
Subscribe to our newsletter for exclusive content.
Follow Us on Social media and don’t miss any news and updates:
Add Your Comment