Rayonix -- the command-line preprocessor

[ntech]

Rayonix is a pre-processor and processes commented flags. You can download a release here. (For mac, windows, linux, and Raspberry Pi). Those flags are specified below:

Features:

-The flag '!rayonix import /absolute/path/to/import.bas (windows: '!rayonix import C:\\path\to\import.bas)
-Relative imports: '!rayonix import something.bas (windows: '!rayonix import something.bas)
-Meta imports: '!rayonix meta website.com/BASIC/something.bas
-These flags include all text inside specified .bas files in the output file. Note that those imported .bas files can also contain '!rayonix flags.
-This makes possible large projects with ease, as well as building reusable code by creating "libraries".

In the future:

-Translation (for example, to Spanish)
-A standard library to do cool things such as parse CSV, JSON, XML, and more -- all natively (that is, in JustBasic or LibertyBasic).

To pre-process something, type in the terminal "rayonix build main.bas out.bas" and it'll parse main.bas then put the output in out.bas.

Rayonix also has more commands, which you can see by typing in the terminal rayonix.

If you like, you can write up a script to call Rayonix automatically. Something like this:


input "Enter path to Rayonix:"; ray$
input "Enter path to file to parse:"; fp$
input "Enter desired output:"; out$
run ray$ + " build " + fp$ + " " + out$

[tsh73]

Is it written in LB/JB?
Could we see the source?

[ntech]

Here's the source: source. While it is written in another language, the standard library (which can be included in the future) shall be in JustBasic and LibertyBasic, per "library."

[Rod]

To get any interest in this at all my advice would be to put more effort into explaining its purpose and it’s benefit to BASIC users. You may know what all the words and phrases you use mean but others don’t.

[ntech]

Sure. So Rayonix is a preprocessor, and it scans a justbasic/libertybasic file for comments which begin with "'!rayonix". Rayonix process commands that are formatted as comments.

A comment can be "'!rayonix import pathToImport" and Rayonix would read pathToImport, and include all of its contents in the output file (large projects can be spread across multiple files). Another helpful thing is "'!rayonix meta url" which would read the url (supposing it's a .bas file) and put all of its contents in the output file too.

In the future, I plan to add a standard library (things that can be included, that are 100% LibertyBasic or JustBasic, and do things such as parse JSON, CSV, XML, and some stuff other than file formats) that can be included, as well as the ability to include a single function or subroutine from another file. I also plan to make Rayonix capable of translating strings (marked with "'!rayonix translate") in files to another language, so that whole projects can be translated.

Also, perhaps Rayonix can package pre-built binaries that unpack LibertyBasic or JustBasic along with all necessary support files and the TKN to virtual memory, and run them; thatway in the end there's only one binary that has to be distributed -- binaries would be crossplatform too.

[tsh73]

binaries would be crossplatform too

Is it possible?

[ntech]

Dec 11, 2019 18:50:47 GMT tsh73 said:

binaries would be crossplatform too

Is it possible?

Yes, crossplatform as in a binary can be packaged for Mac, Windows, Linux or RaspberryPi -- but one binary for one system won't run on another.