Development/0.1-0

.clang-format

@@ -0,0 +1,88 @@
+# ESP32/Arduino C++ Code Formatting Configuration
+# Based on Google style with embedded-specific modifications
+
+BasedOnStyle: Google
+
+# Indentation
+IndentWidth: 2
+TabWidth: 2
+UseTab: Never
+ContinuationIndentWidth: 4
+
+# Braces
+BreakBeforeBraces: Attach
+Cpp11BracedListStyle: true
+
+# Line length - shorter for embedded readability
+ColumnLimit: 100
+
+# Spacing
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 2
+SpacesInAngles: false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+
+# Alignment
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlines: Left
+AlignOperands: true
+AlignTrailingComments: true
+
+# Breaking
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: true
+AllowShortLoopsOnASingleLine: true
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: true
+BinPackArguments: true
+BinPackParameters: true
+BreakBeforeBinaryOperators: None
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+
+# Includes
+IncludeBlocks: Preserve
+SortIncludes: true
+
+# Pointers and references
+DerivePointerAlignment: false
+PointerAlignment: Left
+
+# Comments
+ReflowComments: true
+
+# Preprocessor
+IndentPPDirectives: None
+
+# Penalties for breaking (lower = more likely to break)
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 1
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 200
+
+# Language specific
+Standard: Cpp11

.editorconfig

@@ -0,0 +1,36 @@
+# EditorConfig helps maintain consistent coding styles
+# https://editorconfig.org/
+
+root = true
+
+# All files
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# C/C++ source files
+[*.{c,cpp,cc,cxx,h,hpp,hxx,ino}]
+indent_style = space
+indent_size = 2
+max_line_length = 100
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# Makefiles
+[{Makefile,*.mk}]
+indent_style = tab

.github/workflows/code-quality.yml

@@ -0,0 +1,92 @@
+name: Code Quality
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  format-check:
+    runs-on: ubuntu-latest
+    name: Check Code Formatting
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install clang-format
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y clang-format
+
+    - name: Check formatting
+      run: |
+        find src/ -name "*.cpp" -o -name "*.h" -o -name "*.ino" | \
+        xargs clang-format --dry-run --Werror --style=file
+
+  format-fix:
+    runs-on: ubuntu-latest
+    name: Auto-fix Formatting
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Install clang-format
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y clang-format
+
+    - name: Format code
+      run: |
+        find src/ -name "*.cpp" -o -name "*.h" -o -name "*.ino" | \
+        xargs clang-format -i --style=file
+
+    - name: Check for changes
+      id: verify-changed-files
+      run: |
+        if [ -n "$(git status --porcelain)" ]; then
+          echo "changed=true" >> $GITHUB_OUTPUT
+        else
+          echo "changed=false" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Commit formatted code
+      if: steps.verify-changed-files.outputs.changed == 'true'
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git add .
+        git commit -m "Auto-format code with clang-format [skip ci]"
+        git push
+
+  lint:
+    runs-on: ubuntu-latest
+    name: Static Analysis
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install cppcheck
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y cppcheck
+
+    - name: Run cppcheck
+      run: |
+        cppcheck --enable=all --inconclusive --xml --xml-version=2 \
+        --suppress=missingIncludeSystem \
+        --suppress=unusedFunction \
+        --suppress=unmatchedSuppression \
+        src/ 2> cppcheck-report.xml || true
+
+    - name: Upload cppcheck results
+      uses: actions/upload-artifact@v3
+      with:
+        name: cppcheck-report
+        path: cppcheck-report.xml

.vscode/settings.json

@@ -0,0 +1,62 @@
+{
+  // C/C++ formatting settings
+  "C_Cpp.clang_format_style": "file",
+  "C_Cpp.clang_format_fallbackStyle": "Google",
+
+  // Editor settings
+  "editor.formatOnSave": true,
+  "editor.formatOnPaste": true,
+  "editor.formatOnType": false,
+  "editor.insertSpaces": true,
+  "editor.tabSize": 2,
+  "editor.detectIndentation": false,
+  "editor.trimAutoWhitespace": true,
+  "editor.rulers": [100],
+
+  // File associations
+  "files.associations": {
+    "*.ino": "cpp",
+    "*.h": "cpp",
+    "*.cpp": "cpp"
+  },
+
+  // Auto-save
+  "files.autoSave": "onFocusChange",
+
+  // Line endings
+  "files.eol": "\n",
+
+  // Trailing whitespace
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+
+  // Language-specific settings
+  "[cpp]": {
+    "editor.defaultFormatter": "ms-vscode.cpptools",
+    "editor.formatOnSave": true
+  },
+  "[c]": {
+    "editor.defaultFormatter": "ms-vscode.cpptools",
+    "editor.formatOnSave": true
+  },
+
+  // Extensions recommendations
+  "extensions.recommendations": [
+    "ms-vscode.cpptools",
+    "ms-vscode.cpptools-extension-pack",
+    "platformio.platformio-ide"
+  ],
+
+  // Git settings
+  "git.autofetch": true,
+  "git.enableSmartCommit": true,
+
+  // Search exclusions
+  "search.exclude": {
+    "**/node_modules": true,
+    "**/.git": true,
+    "**/.DS_Store": true,
+    "**/build": true,
+    "**/.pio": true
+  }
+}

scripts/format-code.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+
+# ESP-APPs Code Formatting Script
+# Formats all C/C++ source files using clang-format
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check if clang-format is installed
+if ! command -v clang-format &> /dev/null; then
+    echo -e "${RED}Error: clang-format is not installed${NC}"
+    echo "Install it with:"
+    echo "  Ubuntu/Debian: sudo apt-get install clang-format"
+    echo "  macOS: brew install clang-format"
+    echo "  Windows: Download from LLVM releases"
+    exit 1
+fi
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+echo -e "${YELLOW}ESP-APPs Code Formatter${NC}"
+echo "Project root: $PROJECT_ROOT"
+
+# Check if .clang-format exists
+if [ ! -f "$PROJECT_ROOT/.clang-format" ]; then
+    echo -e "${RED}Error: .clang-format file not found in project root${NC}"
+    exit 1
+fi
+
+# Find all C/C++ files
+FILES=$(find "$PROJECT_ROOT/src" -name "*.cpp" -o -name "*.h" -o -name "*.ino" 2>/dev/null)
+
+if [ -z "$FILES" ]; then
+    echo -e "${YELLOW}No C/C++ files found to format${NC}"
+    exit 0
+fi
+
+echo "Found files to format:"
+echo "$FILES" | sed 's/^/  /'
+
+# Check mode vs format mode
+if [ "$1" = "--check" ]; then
+    echo -e "\n${YELLOW}Checking formatting...${NC}"
+
+    ISSUES=0
+    for file in $FILES; do
+        if ! clang-format --dry-run --Werror --style=file "$file" >/dev/null 2>&1; then
+            echo -e "${RED}✗${NC} $file"
+            ISSUES=$((ISSUES + 1))
+        else
+            echo -e "${GREEN}✓${NC} $file"
+        fi
+    done
+
+    if [ $ISSUES -gt 0 ]; then
+        echo -e "\n${RED}Found $ISSUES formatting issues${NC}"
+        echo "Run './scripts/format-code.sh' to fix them"
+        exit 1
+    else
+        echo -e "\n${GREEN}All files are properly formatted${NC}"
+    fi
+else
+    echo -e "\n${YELLOW}Formatting files...${NC}"
+
+    for file in $FILES; do
+        echo "Formatting: $file"
+        clang-format -i --style=file "$file"
+    done
+
+    echo -e "\n${GREEN}Formatting complete!${NC}"
+
+    # Check if there are any changes
+    if command -v git &> /dev/null && git rev-parse --git-dir > /dev/null 2>&1; then
+        if [ -n "$(git status --porcelain)" ]; then
+            echo -e "${YELLOW}Files were modified. Review changes with 'git diff'${NC}"
+        else
+            echo -e "${GREEN}No changes needed - code was already formatted${NC}"
+        fi
+    fi
+fi