.clang-format

# .clang-format
BasedOnStyle: Google  # Use Google C++ style guide as the base
IndentWidth: 4  # Set the number of spaces per indentation level
TabWidth: 4  # Define tab width
UseTab: Never  # Always use spaces instead of tabs
ColumnLimit: 100  # Maximum characters per line
AllowShortIfStatementsOnASingleLine: false  # Always put 'if' statements on separate lines
AllowShortFunctionsOnASingleLine: InlineOnly  # Only inline short functions on a single line
BreakBeforeBraces: Allman  # Use Allman style for braces (open braces on a new line)
SpaceBeforeParens: ControlStatements  # Add space before parentheses in control statements
AlignConsecutiveAssignments: true  # Align variable assignments for readability
AlignConsecutiveDeclarations: true  # Align declarations for consistency
SortIncludes: true  # Sort `#include` statements
PointerAlignment: Left  # Place the '*' next to the type (e.g., `int* ptr` instead of `int *ptr`)
Standard: Cpp11  # Use C++11 as the standard

# Customize comments styling
CommentPragmas: '^ IWYU pragma:'  # Ignore 'Include What You Use' pragmas

# Customize brace wrapping
BraceWrapping:
  AfterClass: true
  AfterControlStatement: true
  AfterEnum: true
  AfterFunction: true
  AfterNamespace: true
  AfterStruct: true
  SplitEmptyFunction: true
  SplitEmptyRecord: true
  SplitEmptyNamespace: true

# Make constructor initializer lists more readable
ConstructorInitializerIndentWidth: 4
ConstructorInitializerAllOnOneLineOrOnePerLine: true

# Format macros correctly
AlwaysBreakBeforeMultilineStrings: true
AllowAllArgumentsOnNextLine: true

# Enable include sorting with quotation marks before angle brackets
IncludeBlocks: Regroup
IncludeIsMainRegex: '(Test)?$'
IncludeCategories:
  - Regex: '^<.*\.h>'
    Priority: 1
  - Regex: '^".*\.h"'
    Priority: 2
  - Regex: '^<.*>'
    Priority: 3
  - Regex: '^".*"'
    Priority: 4