Getting Started¶

In this section, we'll discuss :

Installing Marcel
Writing and running a Marcel program that prints Hello World

Installation¶

Marcel comes with :

Install from release¶

Using the script¶

You can run the below command in order to install a Marcel release in a specific directory.

curl -s https://raw.githubusercontent.com/tambapps/marcel/main/install/install-from-release.sh | bash -s

It will install Marcel in the $HOME/.marcel folder.

You can also specify a directory by passing it as an argument as shown below

# Will install in ./my-folder
curl -s https://raw.githubusercontent.com/tambapps/marcel/main/install/install-from-release.sh | bash -s ./my-folder

Downloading the release¶

You can download the release.zip of a Marcel Release. Unzip it where you want.

Set MARCEL_HOME¶

Set the MARCEL_HOME environment to the path of the release you just unzipped. You can set it in your .bashrc or .zshrc so that this variable is set in all your sessions. You can also add $MARCEL_HOME/bin to your PATH so your shell recognize marcel commands.

Install from source code¶

There is a script in marcel repository for that.

Note that this script only works on Linux and Mac and requires Maven being installed.

git clone https://github.com/tambapps/marcel.git
cd marcel
./install/install-from-source.sh

Prerequisites¶

You'll need Maven for the installation.

Run script¶

Clone the repository

git clone https://github.com/tambapps/marcel.git
cd marcel

And then run the script

./install-from-source.sh

The script basically runs a lot of mvn clean package and then copy/create some files in $HOME/.marcel/.

Lastly, you can add the following lines into your $HOME/.bashrc (or $HOME/.zshrc or whatever) to easily use marcel tools

MARCEL_HOME="$HOME/.marcel"
PATH="$PATH:$MARCEL_HOME/bin"

Hello World¶

Let's dive in some code now. Marcel can be used as a scripting language, so you don't need to declare a main() function if you just want to run some code.

// HelloWorld.mcl
println("Hello World!")

That's it! One line is all it takes to write the famous Hello World program.

To execute it, use marcl.

marcl HelloWorld.mcl