Align formatter baseline with esptoolkit-template

.clang-format

@@ -0,0 +1,11 @@
+BasedOnStyle: LLVM
+ColumnLimit: 100
+BinPackArguments: false
+BinPackParameters: false
+AllowAllArgumentsOnNextLine: false
+AlignAfterOpenBracket: BlockIndent
+UseTab: ForIndentation
+IndentWidth: 4
+TabWidth: 4
+ContinuationIndentWidth: 4
+AllowShortFunctionsOnASingleLine: None

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+
+[*.{c,cc,cpp,h,hpp,ino}]
+indent_style = tab
+indent_size = tab
+tab_width = 4

.gitignore

@@ -1,4 +1,3 @@
 .venv
 build/
 build_prev_runner/
-.vscode

.vscode/bin/clang-format

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+if command -v clang-format >/dev/null 2>&1; then
+    exec clang-format "$@"
+fi
+
+_home_dir="${HOME:-}"
+if [ -n "$_home_dir" ]; then
+    _candidate="$(ls -1d "$_home_dir"/.vscode/extensions/ms-vscode.cpptools-*-linux-x64/LLVM/bin/clang-format 2>/dev/null | tail -n 1 || true)"
+    if [ -n "$_candidate" ] && [ -x "$_candidate" ]; then
+        exec "$_candidate" "$@"
+    fi
+fi
+
+echo "clang-format executable not found." >&2
+echo "Install clang-format system-wide or install/update ms-vscode.cpptools." >&2
+exit 127

.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+    "recommendations": [
+        "pioarduino.pioarduino-ide",
+        "xaver.clang-format"
+    ],
+    "unwantedRecommendations": [
+        "ms-vscode.cpptools-extension-pack"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,30 @@
+{
+    "files.associations": {
+        "*.ino": "cpp"
+    },
+    "editor.defaultFormatter": "xaver.clang-format",
+    "C_Cpp.formatting": "Disabled",
+    "clang-format.style": "file",
+    "clang-format.executable": "${workspaceRoot}/.vscode/bin/clang-format",
+    "[cpp]": {
+        "editor.defaultFormatter": "xaver.clang-format",
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": false,
+        "editor.tabSize": 4,
+        "editor.formatOnSave": true
+    },
+    "[c]": {
+        "editor.defaultFormatter": "xaver.clang-format",
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": false,
+        "editor.tabSize": 4,
+        "editor.formatOnSave": true
+    },
+    "[arduino]": {
+        "editor.defaultFormatter": "xaver.clang-format",
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": false,
+        "editor.tabSize": 4,
+        "editor.formatOnSave": true
+    }
+}

.vscode/tasks.json

@@ -0,0 +1,12 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Format Firmware Sources",
+            "type": "shell",
+            "command": "bash ${workspaceFolder}/scripts/format_cpp.sh",
+            "group": "build",
+            "problemMatcher": []
+        }
+    ]
+}

README.md

@@ -377,6 +377,13 @@ struct StreamResult {
 
 ---
 
+## Formatting Baseline
+
+This repository follows the firmware formatting baseline from `esptoolkit-template`:
+- `.clang-format` is the source of truth for C/C++/INO layout.
+- `.editorconfig` enforces tabs (`tab_width = 4`), LF endings, and final newline.
+- Format all tracked firmware sources with `bash scripts/format_cpp.sh`.
+
 ## License
 
 MIT — see [LICENSE.md](LICENSE.md)

examples/basic_fetch/basic_fetch.ino

@@ -8,65 +8,88 @@ const char *POST_URL = "https://httpbin.org/post";
 const char *GET_URL = "https://httpbin.org/get";
 
 void setup() {
-    Serial.begin(115200);
-    delay(200);
+	Serial.begin(115200);
+	delay(200);
 
-    FetchConfig cfg;
-    cfg.maxConcurrentRequests = 2;
-    cfg.stackSize = 6144;
-    cfg.priority = 4;
-    cfg.defaultTimeoutMs = 12000;
-    fetch.init(cfg);
+	FetchConfig cfg;
+	cfg.maxConcurrentRequests = 2;
+	cfg.stackSize = 6144;
+	cfg.priority = 4;
+	cfg.defaultTimeoutMs = 12000;
+	fetch.init(cfg);
 
-    JsonDocument payload;
-    payload["hello"] = "world";
+	JsonDocument payload;
+	payload["hello"] = "world";
 
-    bool posting = fetch.post(POST_URL, payload, [](JsonDocument result) {
-        if (!result["error"].isNull()) {
-            ESP_LOGE("FETCH_DEMO", "async post failed: %s", result["error"]["message"].as<const char *>());
-            return;
-        }
-        ESP_LOGI("FETCH_DEMO", "async post status %d body len %u",
-                 result["status"].as<int>(),
-                 result["body"].as<String>().length());
-    });
-    if (!posting) {
-        ESP_LOGE("FETCH_DEMO", "Failed to start http post");
-    }
+	bool posting = fetch.post(POST_URL, payload, [](JsonDocument result) {
+		if (!result["error"].isNull()) {
+			ESP_LOGE(
+			    "FETCH_DEMO",
+			    "async post failed: %s",
+			    result["error"]["message"].as<const char *>()
+			);
+			return;
+		}
+		ESP_LOGI(
+		    "FETCH_DEMO",
+		    "async post status %d body len %u",
+		    result["status"].as<int>(),
+		    result["body"].as<String>().length()
+		);
+	});
+	if (!posting) {
+		ESP_LOGE("FETCH_DEMO", "Failed to start http post");
+	}
 
-    FetchRequestOptions opts;
-    opts.headers.push_back({"Accept", "application/json"});
-    bool getting = fetch.get(GET_URL, [](JsonDocument result) {
-        if (!result["error"].isNull()) {
-            ESP_LOGE("FETCH_DEMO", "async get failed: %s", result["error"]["message"].as<const char *>());
-            return;
-        }
-        Serial.printf("Server: %s\n", result["headers"]["server"].as<const char *>());
-    }, opts);
-    if (!getting) {
-        ESP_LOGE("FETCH_DEMO", "Failed to start http get");
-    }
+	FetchRequestOptions opts;
+	opts.headers.push_back({"Accept", "application/json"});
+	bool getting = fetch.get(
+	    GET_URL,
+	    [](JsonDocument result) {
+		    if (!result["error"].isNull()) {
+			    ESP_LOGE(
+			        "FETCH_DEMO",
+			        "async get failed: %s",
+			        result["error"]["message"].as<const char *>()
+			    );
+			    return;
+		    }
+		    Serial.printf("Server: %s\n", result["headers"]["server"].as<const char *>());
+	    },
+	    opts
+	);
+	if (!getting) {
+		ESP_LOGE("FETCH_DEMO", "Failed to start http get");
+	}
 
-    JsonDocument postResult = fetch.post(POST_URL, payload, portMAX_DELAY);
-    if (!postResult["error"].isNull()) {
-        ESP_LOGW("FETCH_DEMO", "sync post failed: %s", postResult["error"]["message"].as<const char *>());
-    } else {
-        Serial.printf("Sync POST status %d\n", postResult["status"].as<int>());
-    }
+	JsonDocument postResult = fetch.post(POST_URL, payload, portMAX_DELAY);
+	if (!postResult["error"].isNull()) {
+		ESP_LOGW(
+		    "FETCH_DEMO",
+		    "sync post failed: %s",
+		    postResult["error"]["message"].as<const char *>()
+		);
+	} else {
+		Serial.printf("Sync POST status %d\n", postResult["status"].as<int>());
+	}
 
-    JsonDocument getResult = fetch.get(GET_URL, portMAX_DELAY);
-    if (!getResult["error"].isNull()) {
-        ESP_LOGW("FETCH_DEMO", "sync get failed: %s", getResult["error"]["message"].as<const char *>());
-    } else {
-        Serial.printf("Your IP: %s\n", getResult["body"].as<const char *>());
-    }
+	JsonDocument getResult = fetch.get(GET_URL, portMAX_DELAY);
+	if (!getResult["error"].isNull()) {
+		ESP_LOGW(
+		    "FETCH_DEMO",
+		    "sync get failed: %s",
+		    getResult["error"]["message"].as<const char *>()
+		);
+	} else {
+		Serial.printf("Your IP: %s\n", getResult["body"].as<const char *>());
+	}
 }
 
 void loop() {
-    if (!deinitialized && fetch.isInitialized() && millis() > 15000UL) {
-        fetch.deinit();
-        deinitialized = true;
-        ESP_LOGI("FETCH_DEMO", "ESPFetch deinitialized");
-    }
-    vTaskDelay(pdMS_TO_TICKS(1000));
+	if (!deinitialized && fetch.isInitialized() && millis() > 15000UL) {
+		fetch.deinit();
+		deinitialized = true;
+		ESP_LOGI("FETCH_DEMO", "ESPFetch deinitialized");
+	}
+	vTaskDelay(pdMS_TO_TICKS(1000));
 }

scripts/format_cpp.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+_repo_root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+_clang_format="${_repo_root}/.vscode/bin/clang-format"
+
+if [ ! -x "${_clang_format}" ]; then
+    echo "clang-format wrapper not found: ${_clang_format}" >&2
+    exit 1
+fi
+
+mapfile -d '' _format_files < <(
+    git -C "${_repo_root}" ls-files -z -- '*.c' '*.cc' '*.cpp' '*.h' '*.hpp' '*.ino'
+)
+
+if [ "${#_format_files[@]}" -eq 0 ]; then
+    echo "No tracked C/C++/INO files found to format."
+    exit 0
+fi
+
+"${_clang_format}" -i --style=file "${_format_files[@]}"
+
+echo "Formatted ${#_format_files[@]} files."