camel-cli 0.5.0

Command-line interface for Apache Camel in Rust
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155

# camel-cli

Command-line interface for Apache Camel in Rust.

## Installation

```bash
cargo install camel-cli
```

## Usage

```
camel <COMMAND>

Commands:
  run    Start a Camel context from YAML route files with hot-reload
  help   Print help

Options:
  -h, --help     Print help
  -V, --version  Print version
```

## `camel run`

Starts a Camel context and loads routes from YAML files. Hot-reload is **disabled
by default** — enable it with `--watch` or via `Camel.toml`.

```bash
camel run [OPTIONS]

Options:
  --routes <GLOB>   Glob pattern for route YAML files
  --config <FILE>   Path to Camel.toml (default: Camel.toml)
  --watch           Enable file-watcher hot-reload
  --no-watch        Disable file-watcher hot-reload (overrides Camel.toml)
```

### Quick start — no config file

```bash
# Runs routes/*.yaml without hot-reload
camel run --routes "routes/*.yaml"

# Same but with hot-reload enabled
camel run --routes "routes/*.yaml" --watch
```

### With a `Camel.toml`

Create a `Camel.toml` next to your route files:

```toml
[default]
routes = ["routes/**/*.yaml"]
log_level = "INFO"
watch = false

[default.supervision]
max_attempts = 5
initial_delay_ms = 1000
backoff_multiplier = 2.0
max_delay_ms = 60000

[development]
log_level = "DEBUG"
watch = true

[production]
log_level = "ERROR"
watch = false
```

Then run:

```bash
camel run
# or with an explicit profile (development enables watch = true):
CAMEL_PROFILE=development camel run
# or force watch regardless of profile:
camel run --watch
```

The `--routes` flag overrides whatever `routes` is set to in the config file.
`--watch` / `--no-watch` override the `watch` field in `Camel.toml`.

### Hot-reload

Hot-reload is **off by default**. Enable it with `--watch`, or set `watch = true`
in the active profile of `Camel.toml`:

```toml
[development]
watch = true
```

```bash
CAMEL_PROFILE=development camel run   # watch ON via profile
camel run --watch                      # watch ON via flag
camel run --no-watch                   # watch OFF, overrides Camel.toml
```

While the watcher is active, edit any watched YAML file and save — the route
diff is computed and applied within ~300 ms:

| Change | Effect |
|--------|--------|
| Edit pipeline steps | Atomic `swap_pipeline` — zero downtime |
| Add a new route | Route compiled and started |
| Delete a YAML file | Corresponding routes stopped and removed |

### Route YAML format

```yaml
routes:
  - id: "my-route"
    from: "timer:tick?period=1000"
    steps:
      - log: "message=Hello from ${routeId}"
      - to: "mock:out"
```

See [camel-dsl](../crates/camel-dsl) for the full step reference.

## Configuration reference

| Key | Type | Default | Description |
|-----|------|---------|-------------|
| `routes` | `[String]` | `[]` | Glob patterns for route YAML files |
| `watch` | `bool` | `false` | Enable file-watcher hot-reload |
| `runtime_journal_path` | `String?` | disabled | Optional flag to enable local runtime durability/replay |
| `log_level` | `String` | `"INFO"` | Tracing log level |
| `timeout_ms` | `u64` | `5000` | Default operation timeout (ms) |
| `components.timer.period` | `u64` | `1000` | Default timer period (ms) |
| `components.http.connect_timeout_ms` | `u64` | `5000` | HTTP connect timeout (ms) |
| `components.http.max_connections` | `usize` | `100` | HTTP connection pool size |
| `observability.metrics_enabled` | `bool` | `false` | Enable metrics endpoint |
| `observability.metrics_port` | `u16` | `9090` | Metrics server port |
| `supervision.max_attempts` | `u32?` | `5` | Max route restart attempts (`null` = unlimited) |
| `supervision.initial_delay_ms` | `u64` | `1000` | Initial restart delay (ms) |
| `supervision.backoff_multiplier` | `f64` | `2.0` | Backoff multiplier per retry |
| `supervision.max_delay_ms` | `u64` | `60000` | Max restart delay cap (ms) |

Environment variable overrides use the `CAMEL_` prefix, e.g.
`CAMEL_LOG_LEVEL=DEBUG`.

## Example

See [`examples/camel-cli-run`](../../examples/camel-cli-run) for a ready-to-run
project layout with a `Camel.toml` and example routes.

## License

Apache-2.0