Merge feature/azure-quantum-simulator to main

.gitignore

@@ -336,10 +336,16 @@ ASALocalRun/
 
 # MFractors (Xamarin productivity tool) working folder 
 .mfractor/
+
 /src/Simulation/Simulators.Tests/TestProjects/QSharpExe/built
+/src/Simulation/Simulators.Tests/TestProjects/QirExe/qir
 /src/Simulation/Simulators.Tests/TestProjects/TargetedExe/built
+
 dbw_test
 
+# out folders
+out/
+
 # Jupyter caches
 .ipynb_checkpoints
 

Simulation.sln

@@ -103,11 +103,21 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "StandaloneInputReference",
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "qir-standalone-input-reference", "src\Qir\Samples\StandaloneInputReference\qsharp\qir-standalone-input-reference.csproj", "{D7D34736-A719-4B45-A33F-2723F59EC29D}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Microsoft.Quantum.AutoSubstitution", "src\Simulation\AutoSubstitution\Microsoft.Quantum.AutoSubstitution.csproj", "{33D66E90-049F-4A0B-A2B1-79E7E7E0ED0F}"
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Execution", "Execution", "{442E66C8-F69F-44E9-9CD9-1F52C37EA41B}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Quantum.Qir.Tools", "src\Qir\Execution\Tools\Microsoft.Quantum.Qir.Tools.csproj", "{C60226E3-98DE-4E92-AED4-B4A93D4CA063}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Tests.Microsoft.Quantum.Qir.Tools", "src\Qir\Execution\Tools.Tests\Tests.Microsoft.Quantum.Qir.Tools.csproj", "{4794FC80-4594-403F-AFEC-4889EFE87EA0}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "QirExe", "src\Simulation\Simulators.Tests\TestProjects\QirExe\QirExe.csproj", "{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Quantum.Qir.CommandLineTool", "src\Qir\Execution\CommandLineTool\Microsoft.Quantum.Qir.CommandLineTool.csproj", "{EAABB911-02EE-4A05-B566-0084013FC5CD}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Quantum.AutoSubstitution", "src\Simulation\AutoSubstitution\Microsoft.Quantum.AutoSubstitution.csproj", "{33D66E90-049F-4A0B-A2B1-79E7E7E0ED0F}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Tests.Microsoft.Quantum.AutoSubstitution", "src\Simulation\AutoSubstitution.Tests\Tests.Microsoft.Quantum.AutoSubstitution.csproj", "{4EBC65DF-3B5E-419B-8E26-3EEF0B5CD300}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Tests.Microsoft.Quantum.AutoSubstitution.Integration", "src\Simulation\AutoSubstitution.Integration.Tests\Tests.Microsoft.Quantum.AutoSubstitution.Integration.csproj", "{D23480EE-88FC-4DF2-86BD-1C5BDD6CD98C}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Tests.Microsoft.Quantum.AutoSubstitution.Integration", "src\Simulation\AutoSubstitution.Integration.Tests\Tests.Microsoft.Quantum.AutoSubstitution.Integration.csproj", "{D23480EE-88FC-4DF2-86BD-1C5BDD6CD98C}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -681,6 +691,70 @@ Global
 		{D7D34736-A719-4B45-A33F-2723F59EC29D}.RelWithDebInfo|Any CPU.Build.0 = Debug|Any CPU
 		{D7D34736-A719-4B45-A33F-2723F59EC29D}.RelWithDebInfo|x64.ActiveCfg = Debug|Any CPU
 		{D7D34736-A719-4B45-A33F-2723F59EC29D}.RelWithDebInfo|x64.Build.0 = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Debug|x64.Build.0 = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Release|x64.ActiveCfg = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.Release|x64.Build.0 = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Debug|x64.Build.0 = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Release|x64.ActiveCfg = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.Release|x64.Build.0 = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Debug|x64.Build.0 = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Release|x64.ActiveCfg = Release|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.Release|x64.Build.0 = Release|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.RelWithDebInfo|Any CPU.ActiveCfg = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.RelWithDebInfo|Any CPU.Build.0 = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.RelWithDebInfo|x64.ActiveCfg = Debug|Any CPU
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D}.RelWithDebInfo|x64.Build.0 = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Debug|x64.Build.0 = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Release|x64.ActiveCfg = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.Release|x64.Build.0 = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{EAABB911-02EE-4A05-B566-0084013FC5CD}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
 		{33D66E90-049F-4A0B-A2B1-79E7E7E0ED0F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{33D66E90-049F-4A0B-A2B1-79E7E7E0ED0F}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{33D66E90-049F-4A0B-A2B1-79E7E7E0ED0F}.Debug|x64.ActiveCfg = Debug|Any CPU
@@ -777,6 +851,11 @@ Global
 		{AAFB81D3-BC87-404D-BA64-AF40B2D2E45A} = {F6C2D4C0-12DC-40E3-9C86-FA5308D9B567}
 		{A7DB7367-9FD6-4164-8263-A05077BE54AB} = {AAFB81D3-BC87-404D-BA64-AF40B2D2E45A}
 		{D7D34736-A719-4B45-A33F-2723F59EC29D} = {A7DB7367-9FD6-4164-8263-A05077BE54AB}
+		{442E66C8-F69F-44E9-9CD9-1F52C37EA41B} = {F6C2D4C0-12DC-40E3-9C86-FA5308D9B567}
+		{C60226E3-98DE-4E92-AED4-B4A93D4CA063} = {442E66C8-F69F-44E9-9CD9-1F52C37EA41B}
+		{4794FC80-4594-403F-AFEC-4889EFE87EA0} = {442E66C8-F69F-44E9-9CD9-1F52C37EA41B}
+		{A0B98D0E-FC28-4FD8-8806-4825B9F5489D} = {09C842CB-930C-4C7D-AD5F-E30DE4A55820}
+		{EAABB911-02EE-4A05-B566-0084013FC5CD} = {442E66C8-F69F-44E9-9CD9-1F52C37EA41B}
 		{33D66E90-049F-4A0B-A2B1-79E7E7E0ED0F} = {34D419E9-CCF1-4E48-9FA4-3AD4B86BEEB4}
 		{4EBC65DF-3B5E-419B-8E26-3EEF0B5CD300} = {34D419E9-CCF1-4E48-9FA4-3AD4B86BEEB4}
 		{D23480EE-88FC-4DF2-86BD-1C5BDD6CD98C} = {34D419E9-CCF1-4E48-9FA4-3AD4B86BEEB4}

build/manifest.ps1

@@ -26,6 +26,7 @@ $artifacts = @{
         "Microsoft.Quantum.Type1.Core",
         "Microsoft.Quantum.Type2.Core",
         "Microsoft.Quantum.Type3.Core",
+        "Microsoft.Quantum.Qir.Tools",
         "Microsoft.Quantum.QSharp.Foundation"
         "Microsoft.Quantum.Runtime.Core",
         "Microsoft.Quantum.Simulators",
@@ -35,6 +36,7 @@ $artifacts = @{
     Assemblies = @(
         ".\src\Azure\Azure.Quantum.Client\bin\$Env:BUILD_CONFIGURATION\netstandard2.1\Microsoft.Azure.Quantum.Client.dll",
         ".\src\Simulation\AutoSubstitution\bin\$Env:BUILD_CONFIGURATION\netstandard2.1\Microsoft.Quantum.AutoSubstitution.dll",
+        ".\src\Qir\Execution\Tools\bin\$Env:BUILD_CONFIGURATION\netstandard2.1\Microsoft.Quantum.Qir.Tools.dll",
         ".\src\Simulation\Core\bin\$Env:BUILD_CONFIGURATION\netstandard2.1\Microsoft.Quantum.Runtime.Core.dll",
         ".\src\Simulation\EntryPointDriver\bin\$Env:BUILD_CONFIGURATION\netstandard2.1\Microsoft.Quantum.EntryPointDriver.dll",
         ".\src\Simulation\QSharpCore\bin\$Env:BUILD_CONFIGURATION\netstandard2.1\Microsoft.Quantum.QSharp.Core.dll",

build/pack.ps1

@@ -163,12 +163,16 @@ Pack-Dotnet '../src/Simulation/QSharpCore/Microsoft.Quantum.QSharp.Core.csproj'
 Pack-Dotnet '../src/Simulation/Type1Core/Microsoft.Quantum.Type1.Core.csproj'
 Pack-Dotnet '../src/Simulation/Type2Core/Microsoft.Quantum.Type2.Core.csproj'
 Pack-Dotnet '../src/Simulation/Type3Core/Microsoft.Quantum.Type3.Core.csproj'
+Pack-Dotnet '../src/Qir/Execution/Tools/Microsoft.Quantum.Qir.Tools.csproj' -ForcePrerelease
+Pack-Dotnet '../src/Qir/Execution/CommandLineTool/Microsoft.Quantum.Qir.CommandLineTool.csproj' -ForcePrerelease
 Pack-One '../src/Simulation/Simulators/Microsoft.Quantum.Simulators.nuspec'
 Pack-One '../src/Xunit/Microsoft.Quantum.Xunit.csproj'
 Pack-Crate -PackageDirectory "../src/Simulation/qdk_sim_rs" -OutPath $Env:CRATE_OUTDIR;
 Pack-Wheel -PackageDirectory "../src/Simulation/qdk_sim_rs" -OutPath $Env:WHEEL_OUTDIR;
 Pack-One '../src/Qir/Runtime/Microsoft.Quantum.Qir.Runtime.nuspec' -ForcePrerelease
 
+Move-Item -Path (Join-Path $Env:NUGET_OUTDIR Microsoft.Quantum.Qir.CommandLineTool.*) -Destination $Env:INTERNAL_TOOLS_OUTDIR
+
 if (-not $all_ok) {
     throw "At least one project failed to pack. Check the logs."
 }

build/set-env.ps1

@@ -25,6 +25,8 @@ if ($Env:DROP_NATIVE -eq $null) {
     $Env:DROP_NATIVE = (Join-Path $PSScriptRoot "..")
 }
 
+If ($Env:INTERNAL_TOOLS_OUTDIR -eq $null) { $Env:INTERNAL_TOOLS_OUTDIR =  (Join-Path $Env:DROPS_DIR "internal_tools") }
+If (-not (Test-Path -Path $Env:INTERNAL_TOOLS_OUTDIR)) { [IO.Directory]::CreateDirectory($Env:INTERNAL_TOOLS_OUTDIR) }
 If ($Env:NUGET_OUTDIR -eq $null) { $Env:NUGET_OUTDIR =  (Join-Path $Env:DROPS_DIR "nugets") }
 If (-not (Test-Path -Path $Env:NUGET_OUTDIR)) { [IO.Directory]::CreateDirectory($Env:NUGET_OUTDIR) }
 

build/test.ps1

@@ -43,11 +43,13 @@ if ($Env:ENABLE_QIRRUNTIME -ne "false") {
     if ($LastExitCode -ne 0) {
         $script:all_ok = $False
     }
+
     $qirTests = (Join-Path $PSScriptRoot "../src/Qir/Tests")
     & "$qirTests/test-qir-tests.ps1"
     if ($LastExitCode -ne 0) {
         $script:all_ok = $False
     }
+
     $qirSamples = (Join-Path $PSScriptRoot "../src/Qir/Samples")
     & "$qirSamples/test-qir-samples.ps1"
     if ($LastExitCode -ne 0) {

global.json

@@ -1,5 +1,5 @@
 {
     "msbuild-sdks": {
-        "Microsoft.Quantum.Sdk": "0.18.2106149090-alpha"
+        "Microsoft.Quantum.Sdk": "0.18.2107150698-alpha"
     }
 }

src/Azure/Azure.Quantum.Client/Machine/QuantumMachineFactory.cs

@@ -17,6 +17,7 @@ public static class QuantumMachineFactory
         /// <param name="targetName">The execution target for job submission.</param>
         /// <param name="storageConnectionString">The connection string for the Azure storage account.</param>
         /// <returns>A quantum machine for job submission targeting <c>targetName</c>.</returns>
+        [Obsolete("Use SubmitterFactory.QSharpSubmitter.")]
         public static IQuantumMachine? CreateMachine(
             IWorkspace workspace, string targetName, string? storageConnectionString = null)
         {

src/Azure/Azure.Quantum.Client/Microsoft.Azure.Quantum.Client.csproj

@@ -6,6 +6,7 @@
     <TargetFramework>netstandard2.1</TargetFramework>
     <PlatformTarget>x64</PlatformTarget>
     <Description>Client library for Azure Quantum.</Description>
+    <RootNamespace>Microsoft.Azure.Quantum</RootNamespace>
   </PropertyGroup>
 
   <PropertyGroup>

src/Azure/Azure.Quantum.Client/SubmitterFactory.cs

@@ -0,0 +1,123 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+#nullable enable
+
+namespace Microsoft.Azure.Quantum
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Collections.Immutable;
+    using System.Linq;
+    using System.Reflection;
+    using System.Text.RegularExpressions;
+    using Microsoft.Quantum.Runtime.Submitters;
+
+    /// <summary>
+    /// Creates Azure Quantum submitters for specific targets.
+    /// </summary>
+    public static class SubmitterFactory
+    {
+        /// <summary>
+        /// Information about each supported QIR submitter.
+        /// </summary>
+        private static readonly ImmutableList<SubmitterInfo> QirSubmitters = ImmutableList.Create(
+            new SubmitterInfo(
+                new Regex(@"\Amicrosoft\.simulator\.([\w]+\.)*[\w]+\z"),
+                "Microsoft.Quantum.Providers.Targets.MicrosoftSimulatorSubmitter, Microsoft.Quantum.Providers.Core",
+                "QirSubmitter"));
+
+        /// <summary>
+        /// Information about each supported Q# submitter.
+        /// </summary>
+        private static readonly ImmutableList<SubmitterInfo> QSharpSubmitters = ImmutableList<SubmitterInfo>.Empty;
+
+        /// <summary>
+        /// Returns a QIR submitter.
+        /// </summary>
+        /// <param name="target">The name of the execution target.</param>
+        /// <param name="workspace">The workspace used to manage jobs.</param>
+        /// <param name="storageConnection">The connection string for the storage account.</param>
+        /// <returns>A QIR submitter.</returns>
+        public static IQirSubmitter? QirSubmitter(string target, IWorkspace workspace, string? storageConnection) =>
+            Submitter<IQirSubmitter>(QirSubmitters, target, workspace, storageConnection);
+
+        /// <summary>
+        /// Returns a Q# submitter.
+        /// </summary>
+        /// <param name="target">The name of the execution target.</param>
+        /// <param name="workspace">The workspace used to manage jobs.</param>
+        /// <param name="storageConnection">The connection string for the storage account.</param>
+        /// <returns>A Q# submitter.</returns>
+        public static IQSharpSubmitter? QSharpSubmitter(
+            string target, IWorkspace workspace, string? storageConnection) =>
+            Submitter<IQSharpSubmitter>(QSharpSubmitters, target, workspace, storageConnection);
+
+        /// <summary>
+        /// Returns an instance of a submitter from the given list that matches the target.
+        /// </summary>
+        /// <param name="submitters">Information about each submitter.</param>
+        /// <param name="target">The name of the execution target.</param>
+        /// <param name="workspace">The workspace used to manage jobs.</param>
+        /// <param name="storageConnection">The connection string for the storage account.</param>
+        /// <typeparam name="T">The type of the submitter interface.</typeparam>
+        /// <returns>The submitter instance.</returns>
+        private static T? Submitter<T>(
+            IEnumerable<SubmitterInfo> submitters, string target, IWorkspace workspace, string? storageConnection)
+            where T : class
+        {
+            var submitter = submitters.FirstOrDefault(s => s.TargetPattern.IsMatch(target));
+            if (submitter is null)
+            {
+                return null;
+            }
+
+            var type = QdkType(submitter.TypeName);
+            var args = new object?[] { target, workspace, storageConnection };
+            return (T)type.InvokeMember(
+                submitter.MethodName, BindingFlags.InvokeMethod, Type.DefaultBinder, null, args);
+        }
+
+        /// <summary>
+        /// Returns a type from a QDK assembly given its type name.
+        /// </summary>
+        /// <param name="name">The fully-qualified or assembly-qualified type name.</param>
+        /// <returns>The type.</returns>
+        private static Type QdkType(string name)
+        {
+            var version = Assembly.GetExecutingAssembly().GetName().Version;
+            var strongName = $"{name}, Version={version}, Culture=neutral, PublicKeyToken=40866b40fd95c7f5";
+            return Type.GetType(strongName, true);
+        }
+
+        /// <summary>
+        /// Information about a submitter.
+        /// </summary>
+        private class SubmitterInfo
+        {
+            /// <summary>
+            /// Initializes a new instance of the <see cref="SubmitterInfo"/> class.
+            /// </summary>
+            /// <param name="targetPattern">The pattern for targets supported by the submitter.</param>
+            /// <param name="typeName">The fully-qualified or assembly-qualified name of the submitter type.</param>
+            /// <param name="methodName">The name of the static factory method.</param>
+            public SubmitterInfo(Regex targetPattern, string typeName, string methodName) =>
+                (TargetPattern, TypeName, MethodName) = (targetPattern, typeName, methodName);
+
+            /// <summary>
+            /// The pattern for targets supported by the submitter.
+            /// </summary>
+            public Regex TargetPattern { get; }
+
+            /// <summary>
+            /// The fully-qualified or assembly-qualified name of the submitter type.
+            /// </summary>
+            public string TypeName { get; }
+
+            /// <summary>
+            /// The name of the static factory method.
+            /// </summary>
+            public string MethodName { get; }
+        }
+    }
+}

src/Qir/Execution/CommandLineTool/Microsoft.Quantum.Qir.CommandLineTool.csproj

@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <PackAsTool>true</PackAsTool>
+    <ToolCommandName>qir-cli</ToolCommandName>
+    <Description>Command-line tool for interacting with QIR.</Description>
+    <PackageTags>Quantum QIR</PackageTags>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="System.CommandLine" Version="2.0.0-beta1.20213.1"/>
+    <ProjectReference Include="..\Tools\Microsoft.Quantum.Qir.Tools.csproj"/>
+  </ItemGroup>
+
+</Project>