.clang-format

# You may refer to the style options from the official site:
# https://clang.llvm.org/docs/ClangFormatStyleOptions.html
---
# The important stuff:
BasedOnStyle: Google
UseTab: Never
IndentWidth: 4
TabWidth: 4
ColumnLimit: 120
BreakBeforeBraces: Linux

# The not-so-important stuff:
AlignConsecutiveAssignments: Consecutive
AlignAfterOpenBracket: Align
AlignConsecutiveMacros: true
AlignEscapedNewlines: Left
AlignOperands: true
AlignTrailingComments: true
BreakBeforeBinaryOperators: NonAssignment

AllowAllArgumentsOnNextLine: true
AllowAllConstructorInitializersOnNextLine: true
AllowAllParametersOfDeclarationOnNextLine: true
AllowShortBlocksOnASingleLine: Empty
AllowShortCaseLabelsOnASingleLine: true
AllowShortFunctionsOnASingleLine: All
AllowShortIfStatementsOnASingleLine: Never
AllowShortLoopsOnASingleLine: false

DerivePointerAlignment: false
PointerAlignment: Left

IndentPPDirectives: None
MaxEmptyLinesToKeep: 2
ReflowComments: true
SpacesBeforeTrailingComments: 1

IncludeCategories:
  # Standard headers.
  - Regex:          '<.+>'
    Priority:       4

  # STM Library headers.
  - Regex:          '^"(stm|system_stm|cmsis|core|mpu|FreeRTOS).*'
    Priority:       3

  # User Library headers.
  - Regex:          '^"(etl/|fmt/|magic_enum).*'
    Priority:       2

  # Other headers.
  - Regex:          '.*'
    Priority:       1

# C++ Specifics:
AccessModifierOffset: -4
AllowShortLambdasOnASingleLine: All
BreakConstructorInitializers: BeforeComma
FixNamespaceComments: true
NamespaceIndentation: All
Standard: c++20

## C++20 (requires ClangFormat v12+):
BreakBeforeConceptDeclarations: true
IndentRequires: true
...