Browse Source

Update CLI command from `region bulk` to `region def`

pull/2540/head
agessaman 2 months ago
parent
commit
f3c6c34883
  1. 16
      docs/cli_commands.md
  2. 8
      src/helpers/CommonCLI.cpp

16
docs/cli_commands.md

@ -756,9 +756,9 @@ This document provides an overview of CLI commands that can be sent to MeshCore
---
#### Bulk-define region hierarchy (single line)
#### Define region hierarchy (single line)
**Usage:**
- `region bulk <token> [<token> ...]`
- `region def <token> [<token> ...]`
**Parameters (tokens):** Space-separated. A logical **cursor** starts at the wildcard `*`.
@ -771,26 +771,26 @@ This document provides an overview of CLI commands that can be sent to MeshCore
**Note:** On error, the reply is a short `Err - ...` message; regions placed before the failure remain (same as a partial chain of `region put`).
**Note:** Repeater serial accepts one line up to **160 characters** total; split very large trees across multiple `region bulk` commands.
**Note:** Repeater serial accepts one line up to **160 characters** total; split very large trees across multiple `region def` commands.
**Note:** `|` only splits once per token. `region bulk a|b|c|d` is **not** a flat-list shorthand — use `region bulk a|* b|* c|* d|*` for multiple children of `*`.
**Note:** `|` only splits once per token. `region def a|b|c|d` is **not** a flat-list shorthand — use `region def a|* b|* c|* d|*` for multiple children of `*`.
**Example — linear chain:**
```
region bulk west pnw wa w-wa sea
region def west pnw wa w-wa sea
region save
```
**Example — branched tree** (equivalent to `region put west``region put sw-wa wa`):
```
region bulk west pnw or pdx|pnw wa sw-wa
region def west pnw or pdx|pnw wa sw-wa
region save
```
Same with comma as jump delimiter: `region bulk west pnw or pdx,pnw wa sw-wa`
Same with comma as jump delimiter: `region def west pnw or pdx,pnw wa sw-wa`
**Example — flat list** (each region child of `*`):
```
region bulk west|* pnw|* or|* pdx|* wa|* sw-wa
region def west|* pnw|* or|* pdx|* wa|* sw-wa
region save
```

8
src/helpers/CommonCLI.cpp

@ -898,15 +898,15 @@ void CommonCLI::handleGetCmd(uint32_t sender_timestamp, char* command, char* rep
void CommonCLI::handleRegionCmd(char* command, char* reply) {
reply[0] = 0;
// `region bulk ...` — cursor-walk over space-separated tokens (must run before
// `region def ...` — cursor-walk over space-separated tokens (must run before
// parseTextParts, which only keeps 4 segments and mutates the buffer).
char* cmd = command;
while (*cmd == ' ') cmd++;
if (strncmp(cmd, "region bulk", 11) == 0 && (cmd[11] == ' ' || cmd[11] == '\0')) {
char* payload = cmd + 11;
if (strncmp(cmd, "region def", 10) == 0 && (cmd[10] == ' ' || cmd[10] == '\0')) {
char* payload = cmd + 10;
while (*payload == ' ') payload++;
if (*payload == '\0') {
snprintf(reply, 160, "Err - empty bulk");
snprintf(reply, 160, "Err - empty def");
return;
}
RegionEntry* cursor = &_region_map->getWildcard();

Loading…
Cancel
Save