# build casual

## prerequisites

The following packages need to be installed:

 * git
 * python
 * gcc (version >= 13.3)
 * g++ (version >= 13.3)

*Note: casual will not build on a 32-bit system*

**system environment variables**

variable        | used for
----------------|------------------------------
`TMPDIR`        | well, temporary files...


## clone

if you're planning on trying some of the examples there might be a good idea to use `$HOME/git` as your repo-root, then 
the examples correspond exactly to your setup.

```bash
$ git clone https://github.com/casualcore/casual-make.git && cd casual-make && git checkout 1.7 && cd ..
$ git clone https://github.com/casualcore/casual-thirdparty.git && cd casual-thirdparty && git checkout 1.7 && cd ..
$ git clone https://github.com/casualcore/casual.git
```


## set up the environment

Enter the casual repo.

```bash
$ cd $HOME/git/casual
```

It should be enough to just source the example environment set up file.
(if the casual and casual-thirdparty repo's are next to eachother)

```bash
$ source middleware/example/env/casual.env
```

### custom setup 

If you got another setup or there are some platform specific problem, you need
to edit the _casual.env_ file to suit your platform setup.

```bash
$ cp middleware/example/env/casual.env .
$ vim casual.env # edit to suit your needs
$ source casual.env
```


## build casual
     
```bash
$ casual-make
```
     
If you want to compile as much as possible in parallel you can use:

```bash
$ casual-make compile && casual-make link
```

## test casual

```bash
$ casual-make test
```

## feedback

If this _how-to_ is not to your liking, or does not describe your platform
please provide a pull-request to fix it.