Merge latest changes from main into feature branch

.gitignore

@@ -306,6 +306,9 @@ paket-files/
 __pycache__/
 *.pyc
 
+# Python Virtual environments
+*__venv/ 
+
 # Cake - Uncomment if you are using it
 # tools/**
 # !tools/packages.config
@@ -365,6 +368,8 @@ src/ProjectTemplates/Quantum.Test1/.template.config/template.json
 src/QsCompiler/QirGeneration/QirGeneration.nuspec
 /examples/QIR/Development/qir/*
 /examples/QIR/Development/build
+src/Telemetry/Tests/coverage.json
+src/Telemetry/.vscode/settings.json
 
 # MSBuild logs
 MSBuild_Logs/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "src/Passes/vendors/googletest"]
+	path = src/Passes/vendors/googletest
+	url = https://github.com/google/googletest.git
+	shallow = true

build/build.ps1

@@ -142,6 +142,7 @@ $all_ok = $True
 Build-One '../QsCompiler.sln'
 Build-One '../examples/QIR/QIR.sln'
 Build-One '../src/QuantumSdk/Tools/Tools.sln'
+Build-One '../src/Telemetry/Telemetry.sln'
 Build-One '../QsFmt.sln'
 
 if ($Env:ENABLE_VSIX -ne "false") {

build/ci.yml

@@ -26,15 +26,27 @@ schedules:
     - main
   always: true
 
-pool:
-  vmImage: windows-latest
 
 jobs:
 - job: Build
   steps:
   - template: init.yml
   - template: steps.yml
   - template: wrap-up.yml
+  pool:
+    vmImage: windows-latest
+
+- job: LinuxBuild
+  steps:
+  - template: passes-linux.yml
+  pool:
+    vmImage: ubuntu-20.04
+
+- job: MacOSBuild
+  steps:
+  - template: passes-mac.yml
+  pool:
+    vmImage: macOS-latest
 
 - job: Style
   steps:
@@ -43,3 +55,5 @@ jobs:
 
   - script: dotnet tool run fantomas -- --check --recurse .
     displayName: Fantomas
+  pool:
+    vmImage: windows-latest

build/init.yml

@@ -31,3 +31,4 @@ steps:
   inputs:
     command: 'custom'
     customCommand: 'install -g npm@latest'
+

build/passes-linux.yml

@@ -0,0 +1,24 @@
+
+steps:
+- script: |
+      export DEBIAN_FRONTEND=noninteractive
+      sudo apt-get update -y
+      sudo apt-get install -y 
+      sudo apt-get remove -y llvm-12
+      sudo apt-get install -y curl pkg-config findutils  wget
+      sudo apt install -y clang-11 cmake clang-format-11 clang-tidy-11 
+      sudo apt-get install -y llvm-11 lldb-11 llvm-11-dev libllvm11 llvm-11-runtime
+      sudo apt install -y python3 python3-pip 
+      sudo apt-get remove -y llvm-10
+      sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 0
+      git submodule update --init --recursive
+      cd src/Passes/
+      pip install -r requirements.txt  
+      chmod +x manage
+      export PYTHONUNBUFFERED=1
+      export PYTHON_BIN_PATH=/usr/bin/python3
+      export CC=clang-11
+      export CXX=clang++-11
+      ./manage runci
+
+  displayName: Linux build and CI for passes      

build/passes-mac.yml

@@ -0,0 +1,22 @@
+
+steps:
+- script: |
+      rm '/usr/local/bin/2to3'
+      brew install llvm@11
+      brew install cmake
+      brew install [email protected]
+      brew unlink [email protected]
+      brew link [email protected]
+
+      # Updating paths
+      export PATH="/usr/local/opt/python/libexec/bin:$PATH"
+      export PATH="/usr/local/opt/llvm@11/bin:$PATH"
+      export LDFLAGS="${LDFLAGS} -L/usr/local/opt/llvm@11/lib"
+      export CPPFLAGS="${CPPFLAGS} -I/usr/local/opt/llvm@11/include"
+
+      git submodule update --init --recursive
+      cd src/Passes/
+      pip3 install --user -r requirements.txt      
+      chmod +x manage
+      ./manage --loglevel info runci
+

build/set-env.ps1

@@ -5,6 +5,11 @@ $ErrorActionPreference = 'Stop'
 
 Write-Host "Setting up build environment variables"
 
+# Enable the QDK Telemetry Library to throw exceptions
+# This is useful to capture unexpected unhandled exceptions as we
+# test telemetry-related code
+$env:ENABLE_QDK_TELEMETRY_EXCEPTIONS = "1"
+
 If ($Env:BUILD_CONFIGURATION -eq $null) { $Env:BUILD_CONFIGURATION ="Debug" }
 If ($Env:BUILD_VERBOSITY -eq $null) { $Env:BUILD_VERBOSITY ="m" }
 If ($Env:ASSEMBLY_VERSION -eq $null) { $Env:ASSEMBLY_VERSION ="0.0.1.0" }

build/steps.yml

@@ -1,4 +1,5 @@
 steps:
+
 - pwsh: ./build.ps1
   displayName: "Build all"
   workingDirectory: $(System.DefaultWorkingDirectory)/build

build/test.ps1

@@ -38,7 +38,9 @@ function Test-One {
     }
 }
 
+
 Test-One '../QsCompiler.sln'
+Test-One '../src/Telemetry/Telemetry.sln'
 Test-One '../QsFmt.sln'
 
 if (-not $all_ok) {

examples/QIR/Development/Development.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.Quantum.Sdk/0.18.2107151063-beta">
+<Project Sdk="Microsoft.Quantum.Sdk/0.20.2110171573">
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
@@ -20,8 +20,8 @@
     <PackageReference Condition="$([MSBuild]::IsOsPlatform('Linux')) And '$(UbuntuVersion)' != '18.04'"
                       Include="libLLVM.runtime.ubuntu.20.04-x64" Version="11.0.0"
                       PrivateAssets="All" GeneratePathProperty="true" />
-    <PackageReference Include="Microsoft.Quantum.Qir.Runtime" Version="0.18.2107151063-alpha" GeneratePathProperty="true" />
-    <PackageReference Include="Microsoft.Quantum.Simulators" Version="0.18.2107151063-beta" GeneratePathProperty="true" />
+    <PackageReference Include="Microsoft.Quantum.Qir.Runtime" Version="0.20.2110171573-alpha" GeneratePathProperty="true" />
+    <PackageReference Include="Microsoft.Quantum.Simulators" Version="0.20.2110171573" GeneratePathProperty="true" />
   </ItemGroup>
 
   <PropertyGroup>
@@ -136,6 +136,7 @@
     <ItemGroup>
       <_QirRuntimeLibFiles Include="$(QirRuntimeLibs)/**/*.*" Exclude="$(QirRuntimeLibs)/**/*.exe" />
       <_QirRuntimeHeaderFiles Include="$(QirRuntimeHeaders)/**/*.hpp" />
+      <_QirRuntimeHeaderFiles Include="$(QirRuntimeHeaders)/**/*.h" />
     </ItemGroup>
     <Copy SourceFiles="$(SimulatorRuntime)" DestinationFolder="$(BuildOutputPath)" SkipUnchangedFiles="true" />
     <Copy SourceFiles="@(_QirRuntimeLibFiles)" DestinationFolder="$(BuildOutputPath)\%(RecursiveDir)" SkipUnchangedFiles="true" />

examples/QIR/Emission/Emission.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.Quantum.Sdk/0.18.2107151063-beta">
+<Project Sdk="Microsoft.Quantum.Sdk/0.20.2110171573">
 
   <PropertyGroup>
     <QscVerbosity>Detailed</QscVerbosity>

src/Passes/.clang-format

@@ -0,0 +1,69 @@
+# https://clang.llvm.org/docs/ClangFormatStyleOptions.html
+
+---
+Language: Cpp
+BasedOnStyle: Microsoft
+
+# page width
+ColumnLimit: 120
+ReflowComments: true
+
+# tabs and indents
+UseTab: Never
+IndentWidth: 4
+TabWidth: 4
+AccessModifierOffset: -2
+NamespaceIndentation: Inner
+
+# line and statements layout
+BreakBeforeBraces: Allman
+BinPackParameters: false
+AlignAfterOpenBracket: AlwaysBreak
+AllowShortIfStatementsOnASingleLine: WithoutElse
+AllowShortFunctionsOnASingleLine: Empty
+AllowAllConstructorInitializersOnNextLine: false
+AllowAllArgumentsOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: false
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializers: BeforeComma
+
+# misc
+Cpp11BracedListStyle: true
+FixNamespaceComments: true
+IncludeBlocks: Preserve
+SpaceBeforeInheritanceColon : true
+SpaceBeforeParens: ControlStatements
+DerivePointerAlignment: false
+PointerAlignment: Left
+
+# Suggestions
+Standard: Cpp11
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: true
+AlignTrailingComments: true
+
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ConstructorInitializerIndentWidth: 2
+
+IndentCaseLabels: false
+# NamespaceIndentation: None
+
+# Ensures include compleness
+IncludeBlocks: Regroup
+IncludeCategories: 
+  - Regex: '.*\.\..*'
+    Priority: 1
+  - Regex: '^<.*\.h.*>$'
+    Priority: 5
+  - Regex: '^<.*>$'
+    Priority: 6
+  - Regex: '^"(llvm)/.*"$'
+    Priority: 4
+  - Regex: '.*/.*'
+    Priority: 3
+  - Regex: '.*'
+    Priority: 2
+IncludeIsMainRegex: ''
+SortIncludes: true
+SortUsingDeclarations: true
+SpaceInEmptyParentheses: false

src/Passes/.clang-tidy

@@ -0,0 +1,105 @@
+Checks: "-*,bugprone-*,\
+-readability-*,\
+readability-identifier-*,\
+readability-redundant-member-init,\
+readability-braces-around-statements,\
+cert-dcl*,\
+cert-env*,\
+cert-err52-cpp,\
+cert-err60-cpp,\
+cert-flp30-c,\
+clang-analyzer-*,\
+clang-analyzer-security.FloatLoopCounter,\
+google-build-explicit-make-pair,\
+google-build-namespaces,\
+google-explicit-constructor,\
+google-readability-*,\
+google-runtime-operator,\
+hicpp-exception-baseclass,\
+hicpp-explicit-conversions,\
+hicpp-use-*,\
+modernize-avoid-bind,\
+modernize-loop-convert,\
+modernize-make-shared,\
+modernize-make-unique,\
+modernize-redundant-void-arg,\
+modernize-replace-random-shuffle,\
+modernize-shrink-to-fit,\
+modernize-use-bool-literals,\
+modernize-use-default-member-init,\
+modernize-use-emplace,\
+modernize-use-equals-default,\
+modernize-use-equals-delete,\
+modernize-use-noexcept,\
+modernize-use-nullptr,\
+modernize-use-override,\
+modernize-use-transparent-functors,\
+misc-*,\
+-misc-misplaced-widening-cast,\
+-misc-no-recursion,\
+performance-*"
+
+WarningsAsErrors: '*'
+HeaderFilterRegex: '.*'
+
+CheckOptions:
+  # Configuration documentation: https://clang.llvm.org/extra/clang-tidy/checks/readability-identifier-naming.html
+  # Namespaces
+  - key:    readability-identifier-naming.NamespaceCase
+    value:  'lower_case'
+
+  # Classes and structs
+  - key:    readability-identifier-naming.AbstractClassPrefix
+    value:  'I'
+  - key:    readability-identifier-naming.ClassCase
+    value:  'CamelCase'
+  - key:    readability-identifier-naming.StructCase
+    value:  'CamelCase'
+  - key:    readability-identifier-naming.UnionCase
+    value:  'CamelCase'
+
+  # Class members
+  - key:    readability-identifier-naming.PrivateMemberCase
+    value:  'lower_case'
+  - key:    readability-identifier-naming.PrivateMemberSuffix
+    value:  '_'    
+  - key:    readability-identifier-naming.ProtectedMemberCase
+    value:  'lower_case'
+  - key:    readability-identifier-naming.ProtectedMemberSuffix
+    value:  '_'        
+
+  # Type Alias and Enum Types / constants
+  - key:    readability-identifier-naming.TypeAliasCase
+    value:  'CamelCase'
+  - key:    readability-identifier-naming.TypedefCase
+    value:  'CamelCase'
+  - key:    readability-identifier-naming.EnumCase
+    value:  'CamelCase'
+  - key:    readability-identifier-naming.EnumConstantCase
+    value:  'CamelCase'
+
+  # Globals, consts and enums
+  - key:    readability-identifier-naming.GlobalConstantCase
+    value:  'UPPER_CASE'
+  - key:    readability-identifier-naming.GlobalConstantPrefix
+    value:  'G_'
+  - key:    readability-identifier-naming.ConstantCase
+    value: 'UPPER_CASE'
+
+  # Functions
+  - key:    readability-identifier-naming.FunctionCase
+    value:  'camelBack'
+  - key: readability-identifier-naming.IgnoreMainLikeFunctions
+    value: true
+
+  # Variables and parameters
+  - key:    readability-identifier-naming.VariableCase
+    value:  'lower_case'
+  - key:    readability-identifier-naming.LocalVariableCase
+    value:  'lower_case'
+  - key:    readability-identifier-naming.ParameterCase
+    value:  'lower_case'
+
+  # Macros
+  - key:    readability-identifier-naming.MacroDefinitionCase
+    value:  'UPPER_CASE'

src/Passes/.dockerignore

@@ -0,0 +1,2 @@
+Debug/
+**_env/