.clang-format

# clang-format 18.1.8
# Qt Coding Style: https://wiki.qt.io/Qt_Coding_Style
# Options: https://releases.llvm.org/18.1.8/tools/clang/docs/ClangFormatStyleOptions.html
---
Language: Cpp
Standard: c++20
ColumnLimit: 100

AccessModifierOffset: -4
AlignAfterOpenBracket: DontAlign # for (), <>, []
AlignArrayOfStructures: Left
AlignConsecutiveAssignments: None
AlignConsecutiveBitFields: None
AlignConsecutiveDeclarations: None
AlignConsecutiveMacros: None
AlignEscapedNewlines: Left
# AlignEscapedNewlines: LeftWithLastLine # version >= 19
AlignOperands: DontAlign
AlignTrailingComments:
  Kind: Leave
AllowAllArgumentsOnNextLine: false
AllowAllParametersOfDeclarationOnNextLine: false
AllowBreakBeforeNoexceptSpecifier: OnlyWithParen
AllowShortBlocksOnASingleLine: Empty
AllowShortCaseLabelsOnASingleLine: false
AllowShortCompoundRequirementOnASingleLine: true
AllowShortEnumsOnASingleLine: true
AllowShortFunctionsOnASingleLine: Empty
AllowShortIfStatementsOnASingleLine: Never # always break if
AllowShortLambdasOnASingleLine: Inline
AllowShortLoopsOnASingleLine: false
AlwaysBreakAfterReturnType: None
AlwaysBreakBeforeMultilineStrings: false
AlwaysBreakTemplateDeclarations: Yes
AttributeMacros:
  [
    Q_GRPC_EXPORT,
    Q_GRPCQUICK_EXPORT,
    Q_PROTOBUF_EXPORT,
    Q_PROTOBUFQTCORETYPES_EXPORT,
    Q_PROTOBUFQTGUITYPES_EXPORT,
    Q_IMPLICIT,
    Q_INVOKABLE,
  ]

BinPackArguments: true
BinPackParameters: true
BitFieldColonSpacing: Both
BraceWrapping:
  AfterCaseLabel: false
  AfterClass: true
  AfterControlStatement: Never
  AfterEnum: false
  AfterFunction: true
  AfterNamespace: false
  AfterObjCDeclaration: false
  AfterStruct: true
  AfterUnion: false
  AfterExternBlock: false
  BeforeCatch: false
  BeforeElse: false
  BeforeLambdaBody: false
  BeforeWhile: false
  IndentBraces: false
  SplitEmptyFunction: true
  SplitEmptyRecord: true
  SplitEmptyNamespace: true

BreakAdjacentStringLiterals: true
BreakAfterAttributes: Never
BreakArrays: false
BreakBeforeBinaryOperators: NonAssignment
BreakBeforeBraces: Custom # Using BraceWrapping
BreakBeforeConceptDeclarations: Allowed
# BreakBeforeInlineASMColon:
BreakBeforeTernaryOperators: true
BreakConstructorInitializers: BeforeComma
BreakInheritanceList: BeforeComma
BreakStringLiterals: true

CommentPragmas: "^ SPDX-License-Identifier:|^ Copyright|\\since|\\overload|\\reentrant|\\value|\\li|\\l"
CompactNamespaces: false
# ConstructorInitializerIndentWidth:
ContinuationIndentWidth: 4
Cpp11BracedListStyle: false

DerivePointerAlignment: false

EmptyLineAfterAccessModifier: Never
EmptyLineBeforeAccessModifier: LogicalBlock

FixNamespaceComments: true
ForEachMacros:
  [
    forever,
    foreach,
    Q_FOREACH,
    BOOST_FOREACH,
    Q_FOREVER,
    QBENCHMARK,
    QBENCHMARK_ONCE,
  ]

# IfMacros:
IncludeBlocks: Preserve
IncludeCategories:
  # Headers in "" with extension.
  - Regex: '"([A-Za-z0-9.\/-_])+"'
    Priority: 1
  # Headers in <> starting with Qt
  - Regex: "^<Qt*"
    Priority: 2
  # Headers in <> without extension.
  - Regex: '<([a-z\/-_])+>'
    Priority: 4
  # Headers in <> with extension.
  - Regex: '<([a-z.\/-_])+>'
    Priority: 5
# IncludeCategories:
# IncludeIsMainRegex:
# IncludeIsMainSourceRegex:
IndentAccessModifiers: false
IndentCaseBlocks: false
IndentCaseLabels: false
IndentExternBlock: NoIndent
IndentGotoLabels: false
IndentPPDirectives: AfterHash
IndentRequiresClause: false
IndentWidth: 4
IndentWrappedFunctionNames: true
InsertBraces: false
InsertNewlineAtEOF: false
InsertTrailingCommas: None # Cannot be used with BinPackArguments
IntegerLiteralSeparator:
  Binary: 0
  Decimal: 3
  DecimalMinDigits: 5
  Hex: 2
  HexMinDigits: 6

KeepEmptyLinesAtTheStartOfBlocks: false

LambdaBodyIndentation: Signature
LineEnding: LF

Macros:
  - Q_DISABLE_COPY_MOVE(x)=x;
  - Q_DECLARE_PRIVATE(x)=x;
  - Q_OBJECT=x;
MaxEmptyLinesToKeep: 2

NamespaceIndentation: Inner

PPIndentWidth: 2
PackConstructorInitializers: NextLineOnly
PenaltyBreakAssignment: 1000
PenaltyBreakBeforeFirstCallParameter: 10
PenaltyBreakComment: 10
PenaltyBreakFirstLessLess: 20
PenaltyBreakOpenParenthesis: 25
PenaltyBreakScopeResolution: 1000
PenaltyBreakString: 100
PenaltyBreakTemplateDeclaration: 0
PenaltyExcessCharacter: 1000
PenaltyIndentedWhitespace: 0
PenaltyReturnTypeOnItsOwnLine: 25
PointerAlignment: Right

QualifierAlignment: Left

ReferenceAlignment: Right
ReflowComments: false
RemoveBracesLLVM: true
RemoveParentheses: Leave
RequiresClausePosition: OwnLine
RequiresExpressionIndentation: OuterScope

# SeparateDefnitionBlocks:
ShortNamespaceLines: 4
SkipMacroDefinitionBody: true
SortIncludes: CaseSensitive
SortUsingDeclarations: Lexicographic
SpaceAfterCStyleCast: true
SpaceAfterLogicalNot: false
SpaceAfterTemplateKeyword: true
SpaceAroundPointerQualifiers: Default # use PointerAlignment
SpaceBeforeAssignmentOperators: true
SpaceBeforeCaseColon: false
SpaceBeforeCpp11BracedList: false
SpaceBeforeCtorInitializerColon: true
SpaceBeforeInheritanceColon: true
SpaceBeforeParens: ControlStatements
SpaceBeforeRangeBasedForLoopColon: true
SpaceBeforeSquareBrackets: false
SpaceInEmptyBlock: true
SpacesInAngles: Never
SpacesInContainerLiterals: true
SpacesInParens: Never
SpacesInSquareBrackets: false
StatementAttributeLikeMacros: [emit]
StatementMacros: [Q_UNUSED]

UseTab: Never

WhitespaceSensitiveMacros: [Q_PROPERTY]
---
# Use the Google-based style for .proto files.
Language: Proto
BasedOnStyle: Google
IndentWidth: 4
ColumnLimit: 100