# Usage

## Getting started

Create a file named `coke.lua` in the root of your project.

```lua
task.build = {
    desc = 'Build project',
 	run = function ()
    	os.execute('cargo build')
	end
}
```

Run the task.

```bash
coke build
```

## Environment variables

You can use the functions `coke.getenv`, `coke.setenv` and `coke.unsetenv` to get, set and unset environment variables respectively.

```lua
coke.setenv('VERSION', '1.0.0')

task.example = {
    desc = 'example',
    run = function ()
    	print(coke.getenv('VERSION'))
	end
}

coke.unsetenv('VERSION')
```

## Get OS and architecture information

You can use the variables `coke.os` and `coke.arch` to get OS, architecture information.

```lua
task.example = {
    desc = 'example',
    run = function ()
    	print('OS: '..coke.os)
    	print('Arch: '..coke.arch)
    end
}
```