Installing Decision¶

From a pre-built binary¶

You can get the pre-built executables and libraries of Decision from the GitHub repository, which will come in either a zip file or a tarball, depending on the platform. You can then extract the files and start using Decision!

From the source code¶

If for some reason a pre-built binary is not available, or you want to build a custom version of Decision, or just want to try compiling from source, it’s quite easy! Just follow the steps below for your platform:

Windows¶

Dependencies¶

Visual Studio IDE

The program used to compile the project. When installing, make sure that you install C++ support as well!

You can download it here.

CMake

The program used to automatically create the Visual Studio project.

You can download it here.

Git for Windows (Optional)

If you want to clone the GitHub repository rather than downloading a zip of the source code, you can use git to do so. This also has the added bonus of allowing you to update the code easily rather than re-downloading the zip every release. It also has Git Bash, which is a thousand times better than Powershell, fight me.

You can download it here.

Note

If you already use a developer environment like MinGW, CMake should detect it.

Installation¶

Download the source code.
- If you installed git, you can do this by simply entering this command into Git Bash:
```
git clone https://github.com/drwhut/decision.git
```
- Otherwise, you can visit the GitHub page to download the zip file and extract it.
Navigate to the root folder of the project, i.e. where the README.md file exists, and create a folder called build.
Inside that build folder, open up a command prompt (either cmd.exe, Powershell or Git Bash), and enter this command:
```
cmake -DCOMPILER_32=ON ..
```
- This will create the Visual Studio solution inside the build folder.

Note

By default, this step will create a Visual Studio solution for 32-bit Windows (x86). If you want to create a Visual Studio solution for 64-bit Windows (x64), you need to specify this:

cmake -DCOMPILER_32=OFF -A x64 ..

Build the appropiate executable with one of the following commands:
```
cmake --build . --config Debug
cmake --build . --config Release
```
And that’s it! However, if you want to build and run Decision directly from Visual Studio, follow steps 5-8.
Open the Visual Studio solution.
(Optional) If you want to run Decision from within Visual Studio, you should set the “decision” project to be the start-up project by right-clicking on the “decision” project in the solution explorer and clicking “Set as StartUp Project”.
Select either the “Debug” or “Release” version at the top, depending on your needs.
Click Build > Build Solution.

Linux¶

Dependencies¶

GCC: This is the main C/C++ compiler used on Linux.
make: This is the program that builds the project.
CMake: The program used to automatically create the file that make uses to build the project.
git (Optional): If you want to clone the GitHub repository rather than downloading a tarball of the source code, you can use git to do so.

Tip

On Ubuntu, you can install all the dependencies you need by running these commands:

sudo apt-get update
sudo apt-get install build-essential cmake git

Installation¶

Download the source code.
- If you installed git, you can do this by simply entering this command:
```
git clone https://github.com/drwhut/decision.git
```
- Otherwise, you can visit the GitHub page to download the tarball file and extract it:
```
tar -xf decision-master.tar.gz
```
Navigate to the root folder of the project, i.e. where the README.md file exists, and create a directory called build:
```
mkdir build && cd build
```
Inside the build directory, create the CMake project:
```
cmake ..
```
If the CMake project was created, build the project:
```
make
```
(Optional) If you want to, you can install Decision into a standard path on the system so you can run it from anywhere:
```
sudo make install
```
- By default, CMake installs Decision in the /usr/local directory. If you want to change this, add this argument when creating the CMake project, e.g.:
```
cmake -DCMAKE_INSTALL_PREFIX=/usr ...
```

Options¶

32-Bit Mode¶

If you want the interpreter and compiler to store data in 32 bits, add this argument when creating the CMake project:

cmake -DCOMPILER_32=ON ..

Warning

This option will only work properly on 32-bit machines! Applying this option on 64-bit machines will not work since it will not be able to store full 64-bit pointers.

Shared Library¶

By default, a static library for the compiler is generated (.lib/.a). If you want to generate a shared library instead (.dll/.so), add this argument:

cmake -DCOMPILER_SHARED=ON ..

Enable C API Tests¶

If you want CMake to generate tests testing Decision’s C API, add this argument:

cmake -DCOMPILER_C_TESTS=ON ..

Note that this option will generate a lot more executables alongside the compiler executable. See tests/README.md for more details.