You can install ucg using Rust's Cargo package manager.
```sh
cargo install ucg
```
### Compiling
You can also install from source yourself. First ensure that you have the latest
version of Rust installed. You can find install instructions for Rust
[here](https://www.rust-lang.org/en-US/install.html). Then you can get the source
from github and use cargo to build.
```sh
# Get the source code from github
git clone https://github.com/zaphar/ucg
cd ucg
# optionally checkout the current version
git checkout v0.2.3
# use cargo to build and install
cargo install --path .
```
A simple configuration
----------------------
To create a configuration and build it in ucg you must first create a ucg file. Copy the below contents into a file called `sample.ucg`. All ucg files must end in the ucg
extension.
```
let hostname = "www.example.com";
let mysql_host = "localhost";
let mysql_port = 3306;
let config = {
// This uses a format string to put the hostname into
// the baseUrl.
baseUrl = "http://@" % (hostname),
db = {
host = mysql_host,
port = myssql_port,
},
}
// Generate a yaml file from that config.
out yaml config;
```
The above binds 3 values to names and then creates a config tuple using those values.
We'll look in more detail at ucg's syntax later.
To generate a yaml file from the above run the ucg build command.
```sh
ucg build sample.ucg
cat sample.yaml
```
Ucg will generate the yaml file with the same name as the file containing the out statement.
