# Nunjucks-cli

Simple Nunjucks CLI Wrapper and templates watcher, to generate static HTML files.

## Installation

```bash
npm i -D nunjucks-cli # local
npm i -g nunjucks-cli # global
```

## Usage

```bash
nunjucks <file|glob> [context] [options]
```

_For convenience, `process.env` object is added to the context as `env`._

#### Basic examples

```bash
nunjucks foo.tpl data.json
```

Compiles `foo.tpl` to `foo.html` with data from `data.json` (and variables from `process.env` as `env`).

```bash
nunjucks **/*.tpl
```

Compiles all `.tpl` files (including subdirectories), except the ones starting by `_` (so you can use them as layouts).

## Options

### `--path <directory>`

`-p <directory>`

Path where the templates live. Default to the current working directory.
See <https://mozilla.github.io/nunjucks/api.html#configure>

### `--out <directory>`

`-o <directory>`

Output directory.

### `--watch`

`-w`

Allows to keep track of file changes and render accordingly (except files starting by `_`).

### `--extension <ext>`

`-e <ext>`

Extension for rendered files. Defaults to `html`.

### `--options <file>`

`-O <file>`

Takes a json file as Nunjucks options. Defaults are :

```json
trimBlocks: true,
lstripBlocks: true,
noCache: true
```

See <https://mozilla.github.io/nunjucks/api.html#configure>

#### Advanced examples

```bash
nunjucks foo.tpl -p src -o dist -O nj.json
```

Compiles `src/foo.tpl` to `dist/foo.html`, with `nj.json` as nunjucks environnement options.

```bash
nunjucks *.tpl data.json -w -p src
```

Compiles all `.tpl` files (except ones starting with `_`) in the `src` folder to the current working directory, with `data.json` as metadata, and keeps running in the background for files changes.