Merge pull request #293 from ortus-boxlang/development

v1.4.0 Release

Author: lmajano

.github/copilot-instructions.md

@@ -0,0 +1,58 @@
+# Copilot Instructions for BoxLang
+
+## Project Overview
+
+- **BoxLang** is a dynamic JVM language and runtime, supporting multiple deployment targets (CLI, web, lambda, etc.).
+- The main entry point is `ortus.boxlang.runtime.BoxRunner` (see `build.gradle: mainClass`) for the CLI.
+- The runtime is modular, allowing for extensible components, functions, and services.
+- Core runtime logic is in `src/main/java/ortus/boxlang/runtime/`.
+- Language parsing uses ANTLR grammars in `src/main/antlr/`.
+- Built-in services (e.g., `ComponentService`, `FunctionService`) are in `runtime/services/` and auto-registered via the `IService` interface.
+- Components and functions are extensible via annotations (`@BoxComponent`) and service registration.
+- Modules (see `modules/`) can provide BIFs, interceptors, tags, and Java libs, and are loaded with their own classloader.
+
+## Key Developer Workflows
+
+- **Development:** Use IntelliJ IDEA or VSCode with the BoxLang extension for code editing and navigation.
+- **Build & Test:** Use Gradle for building and testing. The project is structured with a `build.gradle` file in the root directory.
+- **Run:** Use the CLI binary (`boxlang`) or run `BoxRunner` directly for scripts/classes.
+- **Build:** Use Gradle (`./gradlew build`) to compile, test, and package. The project targets JDK 21.
+- **Test:** JUnit 5 is used for tests in `src/test/java/`. Run with `./gradlew test`.
+- **Assertions:** Uses Google Truth for assertions in tests.
+- **Run:** Use the CLI binary (`boxlang`) or run `BoxRunner` directly for scripts/classes.
+- **Debug:** The BoxLang VSCode extension provides debugging, code navigation, and language tooling.
+
+## Project Conventions & Patterns
+
+- **Services:** Implement `IService` and register in `BoxRuntime` for global services.
+- **Components:** Annotate with `@BoxComponent` and place in `runtime/components/` for auto-discovery.
+- **Functions (BIFs):** Register via `FunctionService` and use `BIFDescriptor`/`BoxBIF` patterns.
+- **Modules:** Each module has a `ModuleConfig.bx` and `box.json` for metadata/configuration.
+- **Configuration:** Runtime config is loaded via CLI flags or config files (see `BoxRunner` docs).
+- **Testing Modules:** Example: `modules/bx-derby` is used for DB testing in CI.
+- **Code Style:** Follow Java conventions found in the workbench/ortus-java-style.xml file.
+- **New Files**: Must have the workbench header comment at the top of the file.
+- **Documentation:** Use Javadoc for public APIs and inline comments for complex logic.
+- **Error Handling:** Use `BoxRuntimeException` for runtime errors, and `BoxParseException` for parsing errors.
+
+## Integration Points
+
+- **Java Interop:** 100% Java interop; Java classes can be used directly in BoxLang code.
+- **ANTLR:** Language grammar and parsing are defined in `src/main/antlr/`.
+- **ServiceLoader:** Used for dynamic service/component/function discovery.
+- **VSCode Extension:** See [marketplace](https://marketplace.visualstudio.com/items?itemName=ortus-solutions.vscode-boxlang) for IDE integration.
+
+## Examples
+
+- To add a new component: create a class in `runtime/components/`, annotate with `@BoxComponent`, and implement logic.
+- To add a new service: implement `IService`, place in `runtime/services/`, and register in `BoxRuntime`.
+- To add a new BIF: create a class in `runtime/bifs/`, annotate with `@BoxBIF`, and register in `FunctionService`.
+- To add a module: create a folder in `modules/` with `ModuleConfig.bx` and `box.json`.
+
+## References
+
+- [README.md](../../README.md) for high-level project info
+- [BoxLang Docs](https://boxlang.ortusbooks.com/) for language and runtime details
+
+---
+If any conventions or workflows are unclear, please ask for clarification or examples from the codebase.

.github/dependabot.yml

@@ -1,10 +1,13 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
 version: 2
 updates:
-  - package-ecosystem: "gradle" # See documentation for possible values
-    directory: "/" # Location of package manifests
+  # GitHub Actions - updates uses: statements in workflows
+  - package-ecosystem: "github-actions"
+    directory: "/" # Where your .github/workflows/ folder is
     schedule:
-      interval: "weekly"
+      interval: "monthly"
+
+  # Gradle - updates dependencies in build.gradle or build.gradle.kts
+  - package-ecosystem: "gradle"
+    directory: "/" # Adjust if build.gradle is in a subfolder
+    schedule:
+      interval: "monthly"

.github/workflows/release.yml

@@ -76,7 +76,7 @@ jobs:
           fi
 
       - name: Update changelog [unreleased] with latest version
-        uses: thomaseizinger/keep-a-changelog-new-release@2.0.0
+        uses: thomaseizinger/keep-a-changelog-new-release@3.1.0
         if: env.SNAPSHOT == 'false'
         with:
           changelogPath: ./changelog.md
@@ -169,7 +169,7 @@ jobs:
           MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}
 
       - name: Create Github Release
-        uses: taiki-e/create-gh-release-action@v1.8.0
+        uses: taiki-e/create-gh-release-action@v1.9.1
         continue-on-error: true
         if: env.SNAPSHOT == 'false'
         id: create_release

.github/workflows/snapshot.yml

@@ -39,7 +39,7 @@ jobs:
         run: ./gradlew spotlessApply --stacktrace
 
       - name: Commit Format Changes
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v6
         with:
           commit_message: Apply cfformat changes
 

.github/workflows/tests.yml

@@ -26,6 +26,9 @@ jobs:
         jdkVersion: [ "21" ]
         experimental: [ false ]
         compiler: [ "java", "asm" ]
+        exclude:
+          - os: windows-latest
+            compiler: java
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
@@ -48,9 +51,11 @@ jobs:
         run: box install testbox@be src/test/resources --verbose --noSave
 
       - name: Test Module
+        env:
+          BOXLANG_EXPERIMENTAL_COMPILER: ${{ matrix.compiler }}
         run: |
-          ./gradlew :src:modules:test:build "-Dboxlang.experimental.compiler=${{ matrix.compiler }}" --stacktrace --console=plain
-          ./gradlew test "-Dboxlang.experimental.compiler=${{ matrix.compiler }}" --stacktrace --console=plain
+          ./gradlew :src:modules:test:build --stacktrace --console=plain
+          ./gradlew test --stacktrace --console=plain
 
       - name: Upload Test Results
         if: always()

build.gradle

@@ -13,9 +13,9 @@ plugins {
 	id "application"
 	id 'antlr'
 	// For source code formatting
-	id "com.diffplug.spotless" version "7.0.4"
+	id "com.diffplug.spotless" version "7.2.0"
 	// Shadow
-	id "com.gradleup.shadow" version "9.0.0-beta16"
+	id "com.gradleup.shadow" version "9.0.0-rc1"
 	// For dependency updates
 	id 'com.github.ben-manes.versions' version '0.52.0'
 	// For building service loader files
@@ -95,7 +95,7 @@ repositories {
  */
 dependencies {
     // Testing Dependencies
-    testImplementation "org.junit.jupiter:junit-jupiter:5.13.1"
+    testImplementation "org.junit.jupiter:junit-jupiter:5.13.4"
 	testImplementation "org.mockito:mockito-core:5.+"
 	testImplementation "com.google.truth:truth:1.+"
 	testImplementation "commons-cli:commons-cli:1.9.0"
@@ -110,24 +110,24 @@ dependencies {
 
 	// Implementation Dependencies
 	// https://mvnrepository.com/artifact/commons-io/commons-io
-	implementation "commons-io:commons-io:2.19.0"
+	implementation "commons-io:commons-io:2.20.0"
 	// https://mvnrepository.com/artifact/com.github.javaparser/javaparser-symbol-solver-core
 	implementation 'com.github.javaparser:javaparser-symbol-solver-core:3.27.0'
 	// https://mvnrepository.com/artifact/org.apache.commons/commons-lang3
-	implementation 'org.apache.commons:commons-lang3:3.17.0'
+	implementation 'org.apache.commons:commons-lang3:3.18.0'
 	// https://mvnrepository.com/artifact/org.apache.commons/commons-text
 	// Many of these classes ( e.g. StringEscapeUtils ) are currently deprecated in commons-lang and others will be moved in the future
-	implementation 'org.apache.commons:commons-text:1.13.1'
+	implementation 'org.apache.commons:commons-text:1.14.0'
 	// https://mvnrepository.com/artifact/org.apache.commons/commons-cli
 	implementation "commons-cli:commons-cli:1.9.0"
 	// https://mvnrepository.com/artifact/com.fasterxml.jackson.jr/jackson-jr-objects
-	implementation 'com.fasterxml.jackson.jr:jackson-jr-objects:2.19.1'
+	implementation 'com.fasterxml.jackson.jr:jackson-jr-objects:2.19.2'
 	// https://mvnrepository.com/artifact/com.fasterxml.jackson.jr/jackson-jr-extension-javatime
-	implementation 'com.fasterxml.jackson.jr:jackson-jr-extension-javatime:2.19.1'
+	implementation 'com.fasterxml.jackson.jr:jackson-jr-extension-javatime:2.19.2'
 	// https://mvnrepository.com/artifact/com.fasterxml.jackson.jr/jackson-jr-stree
-	implementation 'com.fasterxml.jackson.jr:jackson-jr-stree:2.19.1'
+	implementation 'com.fasterxml.jackson.jr:jackson-jr-stree:2.19.2'
 	// https://mvnrepository.com/artifact/com.fasterxml.jackson.jr/jackson-jr-annotation-support
-	implementation 'com.fasterxml.jackson.jr:jackson-jr-annotation-support:2.19.1'
+	implementation 'com.fasterxml.jackson.jr:jackson-jr-annotation-support:2.19.2'
 	// https://mvnrepository.com/artifact/org.slf4j/slf4j-api
 	implementation 'org.slf4j:slf4j-api:2.0.17'
 	// https://mvnrepository.com/artifact/ch.qos.logback/logback-classic
@@ -138,12 +138,14 @@ dependencies {
 	implementation 'org.ow2.asm:asm-tree:9.8'
 	// https://mvnrepository.com/artifact/org.ow2.asm/asm-util
 	implementation 'org.ow2.asm:asm-util:9.8'
+	// https://mvnrepository.com/artifact/org.ow2.asm/asm-commons
+	implementation 'org.ow2.asm:asm-commons:9.8'
 	// https://mvnrepository.com/artifact/org.semver4j/semver4j
-	implementation 'org.semver4j:semver4j:5.7.1'
+	implementation 'org.semver4j:semver4j:6.0.0'
 
 	// Compile Only Dependencies
 	// Java Annotations Checks, this are for compile documentation only. It's not included in the final build
-	compileOnly 'org.checkerframework:checker-qual:3.49.4'
+	compileOnly 'org.checkerframework:checker-qual:3.49.5'
 
 }
 

gradle.properties

@@ -1,4 +1,4 @@
-#Thu May 29 14:59:26 UTC 2025
+#Mon Jun 23 16:02:13 UTC 2025
 antlrVersion=4.13.1
 jdkVersion=21
-version=1.3.0
+version=1.4.0