This project has been rebranded, check out the new repo - (https://github.com/simulanics/CrossBasic)
This repo will remain intact for historical purposes. For latest updates, see the CrossBasic repo.
This is the very first cross-platform Compiler and VM written by AI and an Agent Team, under direction of Matthew A Combatti. An AI powered plugin creator app is in the works for other developers to rapidly generate plugins for themselves and the community, using natural language. Plugins are currently under development to bring native AI and machine learning to open source XojoScript. Huggingface models, Ollama, and commercial models will also be easily accessible. 🤗
An open-source XojoScript compiler and virtual machine for the Xojo language. Compile and Run XojoScript at native C++ machine-code speed, on any system or architecture supporting C++ compilers [GNU/GCC/G++/clang]. This includes 99.9% of devices - even the web [using emscripten]! 🙏
Welcome to the XojoScript Bytecode Compiler and Virtual Machine! This project is a bytecode compiler and virtual machine written in C++ that handles XojoScript execution—including functions, classes, and more - entirely cross-platform. It compiles XojoScript into bytecode and executes it on a cross-platform custom virtual machine like C#'s design, and is memory-safe like Go and Rust. 🤯
- Compile Standalone Executable Applications: Use the
xcompiletool to compile your scripts to standalone XojoScript executable applications. 🤗 - Cross-platform Plugin Support: Compile and place plugins in a "libs" directory located beside the xojoscript executable. Plugins will automatically be found, loaded, and ready for use in your xojoscript programs.
- Cross-platform Library Support: Load system-level APIs using 'Declare' and use them as you would in Xojo.
- Function Support: Compile and execute user-defined functions and built-in ones. Overloading of functions is permitted.
- Module Support: Create XojoScript Modules. ("extends" is in the works).
- Class & Instance Support: Create classes, define methods, and instantiate objects.
- Intrinsic Types: Handles types like Color, Integer, Double, Boolean, Variant and String.
- Bytecode Execution: Runs compiled bytecode on a custom VM.
- Debug Logging: Step-by-step debug logs to trace lexing, parsing, compiling, and execution.
- Intuitive Syntax: Matches Xojo language syntax (Currently, functions require parenthesis - this is strictly for debugging purposes as other datatypes are added and tested. Parenthesis will be optional at a later date, as in Xojo's implementation, for interoperability and consistency.)
- Console / Web / GUI: Build all sorts of applications from a single code-base.
- Embeddable Library Support: Embed Open Source XojoScript as a static or dynamic linked library for use with other language.
- Open Source: Released under the MIT License.
Check the Releases section for latest binaries. If you prefer to compile the repository yourself, continue reading below.
-
A C++ compiler with C++17 support (e.g. g++, clang++)
-
libffi (https://github.com/libffi/libffi) - handles cross-platform plugin and system-level API access.
-
libcurl (https://curl.se/download.html) - handles cross-platform socket and web request API's. (for use in web-accessible plugins ie. LLMConnection.dll/so/dylib)
-
(Optional) Rust/Go/C#/etc - to build plugins using other languages than C++
Windows XojoDevKit contains all necessary libraries and the build-environment for OS XojoScript and it's Plugins. Windows users using the XojoDevKit, will only need to install git and 64-bit Rust (https://www.rust-lang.org/tools/install).
-
Clone the Repository:
git clone https://github.com/simulanics/XojoScript cd XojoScript
Automated Building
Use the included build_xojoscript.bat / ./build_xojoscript.sh and build_plugins.bat / ./build_plugins.sh scripts to automatically build and compile a release version for testing. Debugging is always available using the debug trace and profiling commandline flag (see below).
Linux users will need to chmod the build directory or individual scripts using:
chmod -R 755 ./XojoScript
chmod 755 build_xxxx.sh
Otherwise "Permission denied" error will appear when attempting to execute the build scripts.
Manual Building
- Compile the Project:
For example, using g++:
g++ -std=c++17 -o xojoscript xojoscript.cpp -lffi
With speed optimizations:
g++ -o xojoscript xojoscript.cpp -lffi -O3 -march=native -mtune=native -flto
- Prepare Your Script:
Create a file named test.txt with your XojoScript code. For example:
Function addtwonumbers(num1 As Integer, num2 As Integer) As Integer
Return num1 + num2
End Function
Public Sub Main()
Dim result As Integer = addtwonumbers(2, 3)
Print(str(result))
End Sub
Main() is reserved for GUI applications primarily, but is not strictly for this purpose. Xojo's implementation of XojoScript does not contain this natively, but this Sub() acts as each OS XojoScript's program entry-point if supplied, and will be executed before any other top-down code.
- Run the Compiler on a script:
./xojoscript --s filename
Debugging 🔍
Debug trace and profile logging is enabled via the DEBUG_MODE "--d true/false" commandline flag. Set it to true or false to enable debugging:
./xojoscript --s filename --d true > debugtrace.log
This will output detailed logs for lexing, parsing, compiling, and execution.
For optimal analysis, it is advisable to save debug trace profiles to a file, as even basic program traces can reach hundreds of megabytes due to the detailed logging of each logical step, along with any potential errors or warnings.
Contributing 🤝
Contributions are welcome! Please feel free to open issues or submit pull requests. Your help is appreciated! 🎉
License 📄
This project is licensed under the MIT License. See the LICENSE file for details.
🤗 Happy Coding! 😄