Support for aliasting nostd namespace to Standard Library

.github/.codecov.yaml

@@ -6,6 +6,8 @@ coverage:
   precision: 2
   round: down
   range: "80...100"
+  status:
+    patch: off
 
 parsers:
   gcov:

.github/workflows/ci.yml

@@ -12,6 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
     - name: setup
       run: |
         sudo ./ci/setup_cmake.sh
@@ -21,23 +23,107 @@ jobs:
     - name: run prometheus exporter tests
       run: ./ci/do_ci.sh cmake.exporter.prometheus.test
 
+  cmake_gcc_48_test:
+    name: CMake gcc 4.8
+    runs-on: ubuntu-18.04
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
+    - name: setup
+      run: |
+        sudo ./ci/setup_ci_environment.sh
+        sudo ./ci/install_gcc48.sh
+    - name: setup cmake
+      run: |
+        sudo CC=/usr/bin/gcc-4.8 CXX=/usr/bin/g++-4.8 ./ci/setup_cmake.sh
+    - name: run tests
+      run: ./ci/do_ci.sh cmake.legacy.test
+      env:
+        CC: /usr/bin/gcc-4.8
+        CXX: /usr/bin/g++-4.8
+
   cmake_test_cxx20:
     name: CMake C++20 test
     runs-on: ubuntu-20.04
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
     - name: setup
       run: |
         sudo ./ci/setup_ci_environment.sh
         sudo ./ci/setup_cmake.sh
     - name: run tests
       run: ./ci/do_ci.sh cmake.c++20.test
 
+  cmake_posix:
+    name: Build on ${{ matrix.os }} ${{ matrix.config }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        config: [release]
+        os: [ubuntu-18.04, ubuntu-20.04, macos-latest]
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
+    - name: build
+      run: tools/build.sh ${{ matrix.config }}
+
+  # TODO #1: add vs2015
+  # TODO #2: consolidate cmake_[vs2015|vs2017|vs2019] into one matrix build
+  cmake_windows_vs2017:
+    name: Build on Windows ${{ matrix.arch }}-${{ matrix.config }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        arch: [x64]
+        config: [release]
+        os: [windows-2016]
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+      with:
+        submodules: 'true'
+    - name: Setup build tools
+      run: |
+        cd "$Env:GITHUB_WORKSPACE"
+        .\tools\setup-buildtools.cmd
+    - name: Build
+      run: |
+        cd "$Env:GITHUB_WORKSPACE"
+        .\tools\build-vs2017.cmd ${{ matrix.config }}
+
+  cmake_windows_vs2019:
+    name: Build on Windows ${{ matrix.arch }}-${{ matrix.config }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        arch: [x64]
+        config: [release]
+        os: [windows-2019]
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+      with:
+        submodules: 'true'
+    - name: Setup build tools
+      run: |
+        cd "$Env:GITHUB_WORKSPACE"
+        .\tools\setup-buildtools.cmd
+    - name: Build
+      run: |
+        cd "$Env:GITHUB_WORKSPACE"
+        .\tools\build-vs2017.cmd ${{ matrix.config }}
+
   plugin_test:
     name: Plugin -> CMake
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
     - name: setup
       run: |
         sudo ./ci/setup_cmake.sh
@@ -125,11 +211,21 @@ jobs:
     - name: run tests
       run: ./ci/do_ci.sh bazel.tsan
 
+  bazel_osx:
+    name: Bazel on MacOS
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: run tests
+      run: ./ci/do_ci.sh bazel.test
+
   benchmark:
     name: Benchmark
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
     - name: setup
       run: |
         sudo ./ci/setup_cmake.sh
@@ -155,19 +251,13 @@ jobs:
     - name: run tests
       run: ./ci/do_ci.sh format
 
-  osx_test:
-    name: Bazel on MacOS
-    runs-on: macos-latest
-    steps:
-    - uses: actions/checkout@v2
-    - name: run tests
-      run: ./ci/do_ci.sh bazel.test
-
   windows:
     name: CMake -> exporter proto
     runs-on: windows-2019
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
     - name: setup
       run: |
         ./ci/setup_windows_cmake.ps1
@@ -193,6 +283,8 @@ jobs:
     runs-on: windows-2019
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: 'true'
     - name: setup
       run: |
         ./ci/setup_windows_cmake.ps1
@@ -215,3 +307,14 @@ jobs:
       uses: codecov/codecov-action@v1
       with:
         file: /home/runner/build/coverage.info
+
+  docfx_check:
+    name: DocFX check
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: install docfx
+      run: choco install docfx -y
+    - name: run ./ci/docfx.cmd
+      shell: cmd
+      run: ./ci/docfx.cmd

.gitignore

@@ -34,3 +34,11 @@
 
 # Bazel files
 /bazel-*
+
+# Output directories
+/out
+/out.*
+# Indicator that the tools were deployed
+.buildtools
+# Tools module
+/tools/vcpkg

.gitmodules

@@ -1,3 +1,22 @@
 [submodule "third_party/prometheus-cpp"]
 	path = third_party/prometheus-cpp
 	url = https://github.com/jupp0r/prometheus-cpp.git
+
+[submodule "tools/vcpkg"]
+	path = tools/vcpkg
+	url = https://github.com/Microsoft/vcpkg
+	branch = master
+
+[submodule "third_party/ms-gsl"]
+	path = "third_party/ms-gsl"
+	url = https://github.com/microsoft/GSL
+	branch = master
+
+[submodule "third_party/googletest"]
+	path = third_party/googletest
+	url = https://github.com/google/googletest
+        branch = master
+
+[submodule "third_party/benchmark"]
+	path = third_party/benchmark
+	url = https://github.com/google/benchmark

CMakeLists.txt

@@ -10,18 +10,62 @@ if(NOT DEFINED CMAKE_CXX_STANDARD)
   set(CMAKE_CXX_STANDARD 11)
 endif()
 
+option(WITH_STL "Whether to use Standard Library for C++latest features" OFF)
+
+option(WITH_ABSEIL "Whether to use Abseil for C++latest features" OFF)
+
+if(WITH_ABSEIL)
+  add_definitions(-DHAVE_ABSEIL)
+  find_package(absl CONFIG REQUIRED)
+
+  # Abseil headers-only lib is needed for absl::variant to work vs2015.
+  # `nostd::mpark::variant` is not compiling in vs2015.
+  set(CORE_RUNTIME_LIBS absl::any absl::base absl::bits absl::city)
+
+  # target_link_libraries(main PRIVATE absl::any absl::base absl::bits
+  # absl::city)
+endif()
+
+if(WITH_STL)
+
+  # Require at least C++17. C++20 is needed to avoid gsl::span
+  add_definitions(-DHAVE_CPP_STDLIB -DHAVE_GSL)
+
+  # Ask for 20, but may get C++17
+  set(CMAKE_CXX_STANDARD 20)
+
+  # Guidelines Support Library path. Used if we are not on not get C++20.
+  # 
+  # TODO: respect WITH_ABSEIL as alternate implementation of std::span
+  set(GSL_DIR third_party/ms-gsl)
+  include_directories(${GSL_DIR}/include)
+
+  # Optimize for speed to reduce the hops
+  if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
+    set(CMAKE_CXX_FLAGS_SPEED "/O2")
+    set(CMAKE_CXX_FLAGS
+        "${CMAKE_CXX_FLAGS} /Zc:__cplusplus ${CMAKE_CXX_FLAGS_SPEED}")
+  endif()
+
+endif()
+
 option(WITH_OTPROTOCOL
        "Whether to include the OpenTelemetry Protocol in the SDK" OFF)
 
 option(WITH_PROMETHEUS "Whether to include the Prometheus Client in the SDK"
        OFF)
 
+option(WITH_TESTS "Whether to enable tests" ON)
+option(WITH_EXAMPLES "Whether to build examples" ON)
+
 set(WITH_PROTOBUF OFF)
 if(WITH_OTPROTOCOL)
   set(WITH_PROTOBUF ON)
 endif()
 
-include(CTest)
+if(WITH_TESTS)
+  include(CTest)
+endif()
 
 find_package(Threads)
 
@@ -58,5 +102,7 @@ include_directories(sdk)
 add_subdirectory(sdk)
 include_directories(.)
 add_subdirectory(exporters)
-add_subdirectory(examples)
+if(WITH_EXAMPLES)
+  add_subdirectory(examples)
+endif()
 add_subdirectory(ext)

README.md

@@ -7,6 +7,17 @@
 
 The C++ [OpenTelemetry](https://opentelemetry.io/) client.
 
+## Supported C++ Versions
+
+Code shipped from this repository generally supports the following versions of
+C++ standards:
+
+* ISO/IEC 14882:2011 (C++11, C++0x)
+* ISO/IEC 14882:2014 (C++14, C++1y)
+* ISO/IEC 14882:2017 (C++17, C++1z)
+
+Any exceptions to this are noted in the individual `README.md` files.
+
 ## Installation
 
 TBD
@@ -19,17 +30,23 @@ TBD
 
 See [CONTRIBUTING.md](CONTRIBUTING.md)
 
-We meet weekly on Mondays at 3:00PM PT. Check the [OpenTelemetry community calendar](https://calendar.google.com/calendar/embed?src=google.com_b79e3e90j7bbsa2n2p5an5lf60%40group.calendar.google.com) for specific dates.
+We meet weekly, and the time of the meeting alternates between Monday at 15:00
+PT and Wednesday at 10:00 PT. The meeting is subject to change depending on
+contributors' availability. Check the [OpenTelemetry community
+calendar](https://calendar.google.com/calendar/embed?src=google.com_b79e3e90j7bbsa2n2p5an5lf60%40group.calendar.google.com)
+for specific dates.
 
 Meetings take place via [Zoom video conference](https://zoom.us/j/8203130519).
 
 Meeting notes are available as a public [Google doc](https://docs.google.com/document/d/1i1E4-_y4uJ083lCutKGDhkpi3n4_e774SBLi9hPLocw/edit?usp=sharing). For edit access, get in touch on [Gitter](https://gitter.im/open-telemetry/opentelemetry-cpp).
 
 Approvers ([@open-telemetry/cpp-approvers](https://github.com/orgs/open-telemetry/teams/cpp-approvers)):
 
-- [Max Golovanov](https://github.com/maxgolov), Microsoft
+- [Lalit Kumar Bhasin](https://github.com/lalitb), Microsoft
 - [Johannes Tax](https://github.com/pyohannes), New Relic
+- [Max Golovanov](https://github.com/maxgolov), Microsoft
 - [Ryan Burn](https://github.com/rnburn), Lightstep
+- [Tom Tan](https://github.com/ThomsonTan), Microsoft
 
 *Find more about the approver role in [community repository](https://github.com/open-telemetry/community/blob/master/community-membership.md#approver).*
 
@@ -38,6 +55,10 @@ Maintainers ([@open-telemetry/cpp-maintainers](https://github.com/orgs/open-tele
 - [Emil Mikulic](https://github.com/g-easy), Google
 - [Reiley Yang](https://github.com/reyang), Microsoft
 
+Triagers ([@open-telemetry/cpp-triagers](https://github.com/orgs/open-telemetry/teams/cpp-triagers)):
+
+- [Jodee Varney](https://github.com/jodeev), New Relic
+
 *Find more about the maintainer role in [community repository](https://github.com/open-telemetry/community/blob/master/community-membership.md#maintainer).*
 
 ## Release Schedule

api/CMakeLists.txt

@@ -12,3 +12,9 @@ install(
 if(BUILD_TESTING)
   add_subdirectory(test)
 endif()
+
+if(WITH_STL)
+  message("Building with standard library types...")
+else()
+  message("Building with nostd types...")
+endif()