[PATCH] Initial commit

fbshipit-source-id: c43e00617f593e6501e41abc0cc6b09b3cc3b372

.clang-format

@@ -0,0 +1,171 @@
+# Based on configuration from clang-format 12.0
+# https://releases.llvm.org/12.0.0/tools/clang/docs/ClangFormatStyleOptions.html
+---
+Language:        Cpp
+BasedOnStyle: Microsoft
+AccessModifierOffset: 0
+AlignAfterOpenBracket: DontAlign
+AlignConsecutiveMacros: None
+AlignConsecutiveAssignments: None
+AlignConsecutiveBitFields: None
+AlignConsecutiveDeclarations: None
+AlignEscapedNewlines: Left
+AlignOperands:   DontAlign
+AlignTrailingComments: false
+AllowAllArgumentsOnNextLine: true
+AllowAllConstructorInitializersOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortEnumsOnASingleLine: true
+AllowShortBlocksOnASingleLine: Never
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortLambdasOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: Yes
+AttributeMacros:
+  - __capability
+BinPackArguments: true
+BinPackParameters: true
+BraceWrapping:
+  AfterCaseLabel:  true
+  AfterClass:      true
+  AfterControlStatement: Always
+  AfterEnum:       true
+  AfterFunction:   true
+  AfterNamespace:  true
+  AfterObjCDeclaration: false
+  AfterStruct:     true
+  AfterUnion:      true
+  AfterExternBlock: true
+  BeforeCatch:     true
+  BeforeElse:      true
+  BeforeLambdaBody: true
+  BeforeWhile:     true
+  IndentBraces:    false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: None
+BreakBeforeConceptDeclarations: true
+BreakBeforeBraces: Custom
+BreakBeforeInheritanceComma: true
+BreakInheritanceList: AfterColon
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: true
+BreakConstructorInitializers: AfterColon
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: false
+ColumnLimit:     0
+CommentPragmas:  '^ IWYU pragma:'
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DeriveLineEnding: false
+DerivePointerAlignment: false
+DisableFormat:   false
+EmptyLineBeforeAccessModifier: Always
+ExperimentalAutoDetectBinPacking: false
+FixNamespaceComments: true
+ForEachMacros:
+  - FOR_EACH
+  - FOR_EACH_R
+  - FOR_EACH_RANGE
+StatementAttributeLikeMacros:
+  - Q_EMIT
+IncludeBlocks: Preserve
+IncludeCategories:
+  - Regex:           '^".*\.h(pp)?"'
+    Priority:        1
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '^<.*\.h(pp)?>'
+    Priority:        2
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '^<.*'
+    Priority:        3
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '.*'
+    Priority:        4
+    SortPriority:    0
+    CaseSensitive:   false
+IncludeIsMainRegex: '(Test)?$'
+IncludeIsMainSourceRegex: ''
+IndentCaseLabels: true
+IndentCaseBlocks: true
+IndentGotoLabels: true
+IndentPPDirectives: BeforeHash
+IndentExternBlock: NoIndent
+IndentRequires:  true
+IndentWidth:     4
+IndentWrappedFunctionNames: false
+InsertTrailingCommas: None
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: true
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 2
+NamespaceIndentation: None
+ObjCBinPackProtocolList: Auto
+ObjCBlockIndentWidth: 4
+ObjCBreakBeforeNestedBlockParam: true
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: false
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 1
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 200
+PenaltyIndentedWhitespace: 0
+PointerAlignment: Left
+ReflowComments:  true
+SortIncludes:    true
+SortJavaStaticImport: Before
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatementsExceptForEachMacros
+SpaceAroundPointerQualifiers: Before
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  false
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: false
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceBeforeSquareBrackets: false
+BitFieldColonSpacing: Both
+Standard:        c++17
+StatementMacros:
+  - Q_UNUSED
+  - QT_REQUIRE_VERSION
+TabWidth:        4
+UseCRLF:         false
+UseTab:          Always
+WhitespaceSensitiveMacros:
+  - OCEAN_ALIGN_DATA
+  - STRINGIZE
+  - PP_STRINGIZE
+  - BOOST_PP_STRINGIZE
+  - CF_SWIFT_NAME
+...

.github/ISSUE_TEMPLATE/Bugs.md

@@ -0,0 +1,32 @@
+---
+name: "\U0001F41B Bugs"
+about: ' Report bugs in Ocean'
+title: ''
+labels: bug
+assignees: ''
+---
+
+## Instructions to reproduce the problem:
+
+1. The code or full code changes that exhibit the problem:
+
+```
+If you made changes to the Ocean code base itself, please use the output of the following command:
+git rev-parse HEAD; git diff
+
+<put code or diff here>
+```
+
+2. Command or list of commands needed to trigger the problem:
+3. **Full logs** or other relevant observations:
+
+```
+<put logs here>
+```
+
+4. If possible, please keep the repro step simple. In particular, please make it so that they do not require
+   additional resources, for example any private data.
+
+## Expected behavior:
+
+If there are no obvious errors, please tell us the expected behavior.

.github/ISSUE_TEMPLATE/Feature-request.md

@@ -0,0 +1,20 @@
+---
+name: "\U0001F680Feature Request"
+about: Suggest an improvement or new feature
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+## 🚀 Feature
+
+A clear and concise description of the feature proposal.
+
+## Motivation & Examples
+
+Tell us why the feature is useful.
+
+Describe what the feature would look like, if it is implemented. Best
+demonstrated using **code examples** in addition to words.
+
+Would you be able/willing to contribute to this work?

.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,7 @@
+---
+name: Documentation
+about: Report a documentation issue
+title: ''
+labels: documentation
+assignees: ''
+---

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,42 @@
+**Pull Request Template**
+
+**Summary**
+
+* Briefly describe the changes made in this pull request:
+  + [Insert summary of changes]
+
+**Changes**
+
+* Describe the changes made in this pull request:
+  + [Insert detailed description of changes]
+  + Include relevant information about:
+    - New features added
+    - Bugs fixed
+    - Performance improvements
+    - Code refactoring
+
+**Motivation**
+
+* Explain the motivation behind making these changes:
+  + [Insert motivation behind changes]
+
+**Testing**
+
+* Describe the testing performed to verify the changes:
+  + [Insert testing details]
+  + Include information about:
+    - Test cases added or modified
+    - Results of testing
+
+**Checklist**
+
+* Confirm that the following have been completed:
+  + [ ] Code compiles and runs successfully on all supported platforms
+  + [ ] All tests pass
+  + [ ] Documentation is updated (if applicable)
+  + [ ] Changes follow the project's coding standards
+
+**Additional Comments**
+
+* Any additional comments or information that may be helpful:
+  + [Insert additional comments]

.github/actions/ctest/action.yml

@@ -0,0 +1,66 @@
+name: 'Ocean CTest'
+description: 'Downloads ocean build output and runs ctest in given subdirectory'
+
+inputs:
+  build-archive:
+    description: 'The name of the build archive'
+    required: true
+    default: 'ocean-build-Release'
+  build-path:
+    description: 'The build path used during the build step'
+    required: true
+  install-path:
+    description: 'The install path used during the build step'
+    required: true
+  test-directory:
+    description: 'The subdirectory within build path to be tested'
+    required: true
+    default: ''
+  ctest-args:
+    description: 'Any arguments to be passed to ctest'
+    required: false
+    default: ''
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get upgrade -y
+        sudo apt-get install -y -o Acquire::Retries=5 \
+          git ninja-build zip libx11-dev libgtk-3-dev \
+          liblzma-dev libgl1-mesa-dev libxcb-glx0-dev \
+          libdeflate-dev libudev-dev zlib1g-dev
+      shell: bash
+
+    - name: Install a newer CMake
+      run: |
+        sudo apt purge --auto-remove cmake
+        wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /etc/apt/trusted.gpg.d/kitware.gpg >/dev/null
+        sudo apt-add-repository -y 'deb https://apt.kitware.com/ubuntu/ jammy main'
+        sudo apt update
+        sudo apt install -y cmake
+      shell: bash
+
+    - name: Download build artifacts
+      id: download-build-artifacts
+      uses: actions/download-artifact@v3
+      with:
+        name: ${{ inputs.build-archive }}
+
+    - name: Unzip build artifacts
+      run: |
+        tar -xvzf ${{ inputs.build-archive }}.tar.gz -C /
+      shell: bash
+
+    - name: Run tests
+      run: |
+        mkdir -p $INSTALL_PATH/bin
+        cd $TEST_PATH
+        ctest $CTEST_ARGS
+      env:
+        INSTALL_PATH: ${{ inputs.install-path }}
+        TEST_PATH: ${{ inputs.build-path }}/${{ inputs.test-directory }}
+        CTEST_ARGS: ${{ inputs.ctest-args }}
+      shell: bash