https://github.com/ortus-boxlang/BoxLang
Welcome to BoxLang: A Modern Dynamic JVM Language
https://github.com/ortus-boxlang/BoxLang
boxlang dynamic-programming invokedynamic java jsr-223 languages
Last synced: about 2 months ago
JSON representation
Welcome to BoxLang: A Modern Dynamic JVM Language
- Host: GitHub
- URL: https://github.com/ortus-boxlang/BoxLang
- Owner: ortus-boxlang
- License: other
- Created: 2023-06-06T18:30:21.000Z (almost 2 years ago)
- Default Branch: development
- Last Pushed: 2024-10-29T19:40:59.000Z (6 months ago)
- Last Synced: 2024-10-29T21:16:59.297Z (6 months ago)
- Topics: boxlang, dynamic-programming, invokedynamic, java, jsr-223, languages
- Language: Java
- Homepage: https://boxlang.io
- Size: 16.5 MB
- Stars: 35
- Watchers: 11
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.YML
- License: license.txt
- Code of conduct: .github/CODE_OF_CONDUCT.MD
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project
- awesome-java - BoxLang
README
# ⚡︎ Project Jericho - BoxLang JVM Language
> A next generation multi-runtime dynamic programming language for the JVM. InvokeDynamic is our first name!
```
██████ ██████ ██ ██ ██ █████ ███ ██ ██████
██ ██ ██ ██ ██ ██ ██ ██ ██ ████ ██ ██
██████ ██ ██ ███ ██ ███████ ██ ██ ██ ██ ███
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ██████ ██ ██ ███████ ██ ██ ██ ████ ██████
```
----
Because of God's grace, this project exists. If you don't like this, then don't read it, it's not for you.
>"Therefore being justified by faith, we have peace with God through our Lord Jesus Christ:
By whom also we have access by faith into this grace wherein we stand, and rejoice in hope of the glory of God.
And not only so, but we glory in tribulations also: knowing that tribulation worketh patience;
And patience, experience; and experience, hope:
And hope maketh not ashamed; because the love of God is shed abroad in our hearts by the
Holy Ghost which is given unto us. ." Romans 5:5
----
**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.
**BoxLang** has been designed to be a highly adaptable and dynamic language to take advantage of all the modern features of the JVM and was designed with several goals in mind:
* Be a rapid application development (RAD) scripting language and middleware.
* Unstagnate the dynamic language ecosystem in Java.
* Be dynamic, modular, lightweight, and fast.
* Be 100% interoperable with Java.
* Be modern, functional, and fluent (Think mixing CFML, Node, Kotlin, Java, and Clojure)
* Be able to support multiple runtimes and deployment targets:
* Native OS Binaries (CLI Tooling, compilers, etc.)
* MiniServer
* Servlet Containers - CommandBox/Tomcat/Jetty/JBoss
* JSR223 Scripting Engines
* AWS Lambda
* Microsoft Azure Functions (Coming Soon)
* Android/iOS Devices (Coming Soon)
* Web assembly (Coming Soon)
* Compile down to Java ByteCode
* Allow backward compatibility with the existing ColdFusion/CFML language.
* Great IDE, Debugger and Tooling: https://boxlang.ortusbooks.com/getting-started/ide-tooling
* Scripting (Any OS and Shebang) and REPL capabilities
You can find our docs here: https://boxlang.ortusbooks.com/
## License
Apache License, Version 2.0.
## Open-Source & Professional Support
This project is a professional open source project and is available as FREE and open source to use. Ortus Solutions, Corp provides commercial support, training and commercial licenses which include the following:
* Professional Support and Priority Queuing
* Remote Assistance and Troubleshooting
* New Feature Requests and Custom Development
* Custom SLAs
* Application Modernization and Migration Services
* Performance Audits
* Enterprise Modules and Integrations
* Much More
Visit us at [BoxLang.io Plans](https://boxlang.io/plans) for more information.
## JDK Targets
* **JDK 21 LTS** is our compiled code JDK Baseline.
## VSCode Snippets
You will find a `.vscode` folder in the root. This contains our custom shortcuts, mappings, snippets, builds and more.
### Snippets
| Snippet | Description |
|-----------------------|---------------------------------------|
| `header` | Adds a license header |
| `testclass` | Creates a Junit5 test class |
## Basic Gradle Tasks
> The output folder used for the builds are `build/**` which can be found in each of the multi-project folders.
| Task | Description |
|---------------------|---------------------------------------------------------------------------------------------------------------------|
| `assemble` | Build all tasks: `build/libs, build/scripts, build/distributions` |
| `build` | The default lifecycle task that triggers the build process, including tasks like `clean`, `assemble`, and others. |
| `clean` | Deletes the `build` folders. It helps ensure a clean build by removing any previously generated artifacts. |
| `compileJava` | Compiles Java source code files located in the `src/main/java` directory |
| `compileTestJava` | Compiles Java test source code files located in the `src/test/java` directory |
| `getDependencies` | Downloads all the dependencies defined in `build.gradle` and puts them in the `build/dependencies` folder |
| `dependencyUpdates` | Checks for updated versions of all dependencies |
| `jar` | Packages your project's compiled classes and resources into a JAR file `build/libs` folder |
| `spotlessApply` | Runs the Spotless plugin to format the code |
| `spotlessCheck` | Runs the Spotless plugin to check the formatting of the code |
| `tasks` | Show all the available tasks in the project |
| `test` | Executes the unit tests in your project and produces the reports in the `build/reports/tests` folder |
### Example Testing Commands
* Run a single test: `gradle test --tests FooTest`
* Run several tests and then watch them for changes `gradle test --tests FooTest --tests BarTest --continuous`
* Run Tests with a pattern match and watch for changes `gradle test --tests "Array*" --continuous`
## Dependencies
Here is a listing of all of our core dependencies. If you add one, make sure you document it here.
### Runtime
| Dependency | Version | License | Description |
|------------|---------|---------|-------------|
| [apache-commons-lang3](https://commons.apache.org/proper/commons-lang/) | 3.14.0 | Apache2 | Used for many utilities, class helpers and more |
| [boxlang-compiler](https://github.com/ortus-solutions-private/boxlang-compiler) | 1.0.0 | Apache2 | The BoxLang Parser, Compiler, and ByteCode Generator |
| [slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api) | 2.0.13 | MIT | API for SLF4J (The Simple Logging Facade for Java) |
### Compiler
| Dependency | Version | License | Description |
|------------|---------|---------|-------------|
| [antlr4-runtime](https://mvnrepository.com/artifact/org.antlr/antlr4-runtime) | 4.12.0 | BSD 3-clause | ANTLR parser |
| [commons-cli](https://mvnrepository.com/artifact/commons-cli/commons-cli) | 1.5.0 | Apache 2 | Apache Commons CLI provides a simple API for presenting, processing and validating a Command Line Interface. |
| [commons-io](https://mvnrepository.com/artifact/commons-io/commons-io) | 2.16.1 | Apache 2 | The Apache Commons IO library contains utility classes, stream implementations, file filters, file comparators, endian transformation classes, and much more. |
| [commons-text](https://mvnrepository.com/artifact/org.apache.commons/commons-text) | 1.12.0 | Apache 2 | The Commons Text library provides additions to the standard JDK text handling. It includes algorithms for string similarity and for calculating the distance between strings. |
| [javaparser-symbol-solver-core](https://github.com/javaparser/javaparser) | 3.25.10 | Apache 2 | Java 1-17 Parser and Abstract Syntax Tree for Java with advanced analysis functionalities. |
| [slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api) | 2.0.13 | MIT | API for SLF4J (The Simple Logging Facade for Java) |
## Contributing
* All code should be formatted using either our Java Formatter or the CFFormatter.
* All code should have a license/copyright header based on [CodeHeader.txt](workbench/CodeHeader.txt)
Made with ♥️ in USA 🇺🇸, El Salvador 🇸🇻 and Spain 🇪🇸