[FFmpeg-devel] [PATCH] [RFC] global/clang-format: Add .clang-format configuration for consistent formatting

[softworkz]

From: softworkz <softworkz at hotmail.com>

This is an attempt to create and establish a common definition for
code formatting. Besides .clang-format, there don't seem to be many
good candidates for C when looking for non-proprietary open-source
solutions, so there's wasn't really much choice.

I have tried to configure everything according to the current
guidelines, to which it should come pretty close. There are a few
things for which I couldn't find any FFmpeg rules, or where it wasn't
clear and I made choices that seemed reasonable.

This is in no way intended to prescribe any formatting detail rules,
it's rather meant as an invitation to collaborate on this and ideally
end up with something "official" that allows to check and fix
formatting in CI flows or Patchwork and locally for everybody using
editors with clang-format support or using clang-format from the
command line.

Signed-off-by: softworkz <softworkz at hotmail.com>
---
    [RFC] global/clang-format: Add .clang-format configuration for
    consistent formatting
    
    This is an attempt to create and establish a common definition for code
    formatting. Besides .clang-format, there don't seem to be many good
    candidates for C when looking for non-proprietary open-source solutions,
    so there's wasn't really much choice.
    
    I have tried to configure everything according to the current
    guidelines, to which it should come pretty close. There are a few things
    for which I couldn't find any FFmpeg rules, or where it wasn't clear and
    I made choices that seemed reasonable.
    
    This is in no way intended to prescribe any formatting detail rules,
    it's rather meant as an invitation to collaborate on this and ideally
    end up with something "official" that allows to check and fix formatting
    in CI flows or Patchwork and locally for everybody using editors with
    clang-format support or using clang-format from the command line.
    
    Signed-off-by: softworkz softworkz at hotmail.com

Published-As: https://github.com/ffstaging/FFmpeg/releases/tag/pr-ffstaging-74%2Fsoftworkz%2Fsubmit_clang_format-v1
Fetch-It-Via: git fetch https://github.com/ffstaging/FFmpeg pr-ffstaging-74/softworkz/submit_clang_format-v1
Pull-Request: https://github.com/ffstaging/FFmpeg/pull/74

 .clang-format | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 .clang-format

diff --git a/.clang-format b/.clang-format
new file mode 100644
index 0000000000..e49e571d48
--- /dev/null
+++ b/.clang-format
@@ -0,0 +1,81 @@
+---
+BasedOnStyle:    GNU
+
+# Alignment & indentation rules
+AlignAfterOpenBracket:               Align
+AlignConsecutiveAssignments:         Consecutive
+AlignConsecutiveDeclarations:        AcrossEmptyLinesAndComments
+AlignArrayOfStructures:              Left
+AlignOperands:                       false
+AlignTrailingComments:               Always
+AlignEscapedNewlines:                LeftWithLastLine
+IndentWidth:                         4
+ContinuationIndentWidth:             4
+UseTab:                              Never
+TabWidth:                            4
+IndentPPDirectives:                  None
+IndentCaseBlocks:                    true
+IndentCaseLabels:                    false
+IndentGotoLabels:                    true
+PointerAlignment:                    Right
+
+AlignConsecutiveShortCaseStatements:
+  Enabled: true
+  AcrossEmptyLines: true
+  AcrossComments: true
+  AlignCaseColons: false
+  
+# Bracing style                      
+BreakBeforeBraces:                   Custom
+BraceWrapping:                       
+  AfterCaseLabel:                    true
+  AfterControlStatement:             Never
+  AfterEnum:                         true
+  AfterFunction:                     true
+  AfterClass:                        false
+  AfterStruct:                       false
+  AfterUnion:                        false
+  AfterExternBlock:                  false
+  BeforeElse:                        false
+  SplitEmptyFunction:                true
+  SplitEmptyRecord:                  true
+BreakAfterReturnType:                None
+
+# Keep lines from becoming too long (adjust to your preference)
+ColumnLimit:                      0
+
+# Misc formatting
+AlwaysBreakAfterReturnType:       None
+BinPackArguments:                 false
+BinPackParameters:                false
+# BinPackLongBracedList:            false
+BreakBeforeTernaryOperators:      true
+InsertNewlineAtEOF:               true
+MaxEmptyLinesToKeep:              2
+AlwaysBreakAfterDefinitionReturnType: None
+
+# Include style
+SortIncludes:                     Never
+IncludeBlocks:                    Preserve
+IncludeCategories:
+  - Regex: '^<.*'
+    Priority: 1
+  - Regex: '^".*'
+    Priority: 2
+  - Regex: '.*'
+    Priority: 3
+
+# Spacing
+SpaceAfterCStyleCast:            false
+SpaceAfterLogicalNot:            false
+SpaceBeforeAssignmentOperators:  true
+SpaceBeforeParens:               ControlStatements
+SpaceBeforeSquareBrackets:       false
+SpaceInEmptyParentheses:         false
+SpacesBeforeTrailingComments:    1
+SpacesInAngles:                  false
+SpacesInConditionalStatement:    false
+SpacesInCStyleCastParentheses:   false
+SpacesInParentheses:             false
+SpacesInSquareBrackets:          false
+...

base-commit: b6c2498a5902766f924cc8728ac65d4fbfd95238
-- 
ffmpeg-codebot