Apply clang-format

.clang-format

@@ -0,0 +1,31 @@
+---
+# this file work is a derivative of .clang-format which follows
+# https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md
+#
+Language:        Cpp
+BasedOnStyle:  Microsoft
+AccessModifierOffset: -4
+AlignAfterOpenBracket: AlwaysBreak
+AlignEscapedNewlines: DontAlign
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterCaseLabel: true
+  AfterUnion: true
+  AfterExternBlock: false
+BreakConstructorInitializers: AfterColon
+CompactNamespaces: true
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+IncludeBlocks: Regroup
+IncludeCategories:
+  - Regex: '^"(stdafx.h|pch.h|precomp.h)"$'
+    Priority: -1
+NamespaceIndentation: Inner
+PenaltyExcessCharacter: 1
+PointerAlignment: Left
+SortIncludes: false
+Standard: Cpp11
+UseTab:          Never
+...

.gitignore

@@ -2,6 +2,8 @@
 ## files generated by popular Visual Studio add-ons.
 .gitconfig
 
+scripts/hooks/pre-commit
+
 # User-specific files
 *.suo
 *.user

.pipelines/clang-format-ci.yml

@@ -0,0 +1,56 @@
+name: $(Year:yy).$(Month).$(DayOfMonth).$(rev:r)
+
+pr:
+  branches:
+    include:
+    - main
+
+pool:
+  vmImage: ubuntu-latest
+
+steps:
+- task: NodeTool@0
+  inputs:
+    versionSpec: '14.x'
+  displayName: 'Install Node.js'
+
+- script: |
+    npm install
+  displayName: 'npm install'
+  workingDirectory: source/nodejs
+
+- script: |
+    npm run verify --verbose
+  displayName: 'npm run verify --verbose'
+  workingDirectory: source/nodejs
+
+- bash: |
+    echo "##[command]Three ways to fix the format problem"
+    echo '##[command]1. powershell -ExecutionPolicy Bypass scripts\FormatSource.ps1 -ModifiedOnly $False'
+    echo "##[command]2. or cd source\nodejs, then npm run format --verbse"
+    echo "##[command]3. or download format.patch from pippeline, then git apply format.patch"
+  displayName: 'How to fix the format problem'
+  condition: failed()
+
+- script: |
+    npm run format --verbose
+  displayName: 'npm run format --verbose'
+  workingDirectory: source/nodejs
+  condition: failed()
+
+- script: |
+    git diff > format.patch
+  displayName: 'create format.patch'
+  condition: failed()
+
+- task: CopyFiles@2
+  inputs:
+    contents: 'format.patch'
+    targetFolder: $(Build.ArtifactStagingDirectory)
+  condition: failed()
+
+- task: PublishBuildArtifacts@1
+  inputs:
+    pathToPublish: $(Build.ArtifactStagingDirectory)
+    artifactName: drop
+  condition: failed()

README.md

@@ -29,7 +29,55 @@ PS: Latest Build Status is against `main` branch.
 | iOS | [![CocoaPods](https://img.shields.io/cocoapods/v/AdaptiveCards.svg)](https://cocoapods.org/pods/AdaptiveCards) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/ios) | [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/ios) |  ![Build status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/37917/main.svg) |
 | Card Designer | [![npm install](https://img.shields.io/npm/v/adaptivecards-designer.svg)](https://www.npmjs.com/package/adaptivecards-designer) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/nodejs/adaptivecards-designer)| [Docs](https://www.npmjs.com/package/adaptivecards-designer) | ![Build Status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20564/main.svg) |
 
-#### End User License Agreement for our binary packages
+## Code format
+
+We require the C++ code inside this project to follow the clang-format. If you change them, please make sure your changed files are formatted correctly.
+
+Make sure clang-format version 12.0.0 and above version is used.
+
+### IDE integration
+ClangFormat describes a set of tools that are built on top of LibFormat. It can support your workflow in a variety of ways including a standalone tool and editor integrations. For details, refer to https://clang.llvm.org/docs/ClangFormat.html
+
+### Format with script
+Two scripts are provided to help you format files.
+- Windows user only: use FormatSource.ps1. This script use clang-format.exe which is built into Visual Studio by default.
+
+	Execute below command in the root folder of the project
+
+	```
+	PowerShell.exe -ExecutionPolicy Bypass scripts\FormatSource.ps1 -ModifiedOnly $False
+	```
+
+If it's the first time to run the script, make sure clang-format version 12.0.0 or above in the output. Otherwise you may need to upgrade Visual Studio or use your own clang-format binaries.
+```
+[clang-format] Version is:
+clang-format version 12.0.0
+```
+
+- Both Windows and MAC users: Use clang-format npmjs package
+
+	Execute below command in source/nodejs
+
+	```
+	npm run format
+	``` 
+
+Make sure `npm install` is run before.
+
+### Use Git pre-commit hook
+`git pre-commit hook` is an optional process. When you run `git commit`, it will automatically do the format check and auto fix the format if error detected.
+
+First make sure clang-format binary is installed in your dev enviroment.
+Then modify scripts/hooks/pre-commit to make sure clangFormat is point to the correct path.
+And finally setup the git hook.
+
+Two ways to setup the hook:
+1. Copy `scripts/hooks/pre-commit` to `.git/hooks`
+2. `git config --local core.hooksPath scripts/hooks`
+
+then choose `scripts/hooks/pre-commit.txt` or `scripts/hooks/pre-commit.txt` and remove the `.txt` to enable that hook.
+
+## End User License Agreement for our binary packages
 Consumption of the AdaptiveCards binary packages are subject to the Microsoft EULA (End User License Agreement). Please see the relevant terms as listed below:
 - [UWP/.NET](https://github.com/microsoft/AdaptiveCards/blob/main/source/EULA-Windows.txt)
 - [Android/iOS](https://github.com/microsoft/AdaptiveCards/blob/main/source/EULA-Non-Windows.txt)