Merge branch 'Topic/1335-dotnet5Apis' into 'Product/1287-dotnet5Sharepoint'

Topic/1335 dotnet5 apis

See merge request !17

.gitlab-ci.yml

+include:
+  - project: coscine/tools/gitlab-ci-templates
+    file: 
+      - /dotnet.yml
+
 stages:
+  - build
   - test
-  - release
-  - releasetrigger
+  - publish
+
+variables:
+  DOTNET_MAIN_PROJECT_FOLDER: Blob
+
+build-branch:
+  extends: .build-branch
 
-cake:Test:
-  stage: test
-  script:
-    - PowerShell .\build.ps1 -Target Test -Configuration Debug
-  variables:
-    GIT_STRATEGY: clone
-  artifacts:
-    reports:
-      junit: "./Artifacts/TestResults.xml"
-    paths:
-      - "./Artifacts/*"
-  except:
-    - master
-    - tags
+test:
+  extends: .test
 
-cake:Release:
-  stage: release
-  script:
-    - PowerShell .\build.ps1 -Target Release -Configuration Release --nugetApiKey="${NUGET_API_KEY}"
-  variables:
-    GIT_STRATEGY: clone
-  dependencies:
-    - cake:Test
-  artifacts:
-    paths:
-      - "./Artifacts/*"
-  only:
-    - tags
+publish-gitlab-release:
+  extends: .publish-gitlab-release
 
-cake:Prerelease:
-  stage: release
-  script:
-    - PowerShell .\build.ps1 -Target Prerelease -Configuration Release
-  variables:
-    GIT_STRATEGY: clone
-  dependencies:
-    - cake:Test
-  artifacts:
-    paths:
-      - "./Artifacts/*"
-  except:
-    - tags
-    - master
+publish-master-release:
+  extends: .publish-master-release
 
-cake:GitlabRelease:
-    stage: releasetrigger
-    script:
-      - PowerShell .\build.ps1 -Target GitlabRelease --GitlabProjectPath="${CI_PROJECT_PATH}" --gitlabProjectId="${CI_PROJECT_ID}" --gitlabToken="${GITLAB_TOKEN}"
-    only:
-      - master
\ No newline at end of file

LICENSE

 MIT License
 
-Copyright (c) 2019 RWTH Aachen University
+Copyright (c) 2021 RWTH Aachen University
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

build.cake

-#tool nuget:?package=NUnit.ConsoleRunner&version=3.10.0
-#tool nuget:?package=vswhere&version=2.8.4
-#tool nuget:?package=GitVersion.CommandLine&version=5.1.3
-
-#addin nuget:https://api.nuget.org/v3/index.json?package=Cake.Json&version=4.0.0
-#addin nuget:https://api.nuget.org/v3/index.json?package=Newtonsoft.Json&version=11.0.2
-#addin nuget:https://api.nuget.org/v3/index.json?package=Cake.FileHelpers&version=3.2.1
-
-using System.Net;
-using System.Net.Http;
-
-// Commandline arguments
-var target = Argument("target", "Default");
-var configuration = Argument("configuration", "Release");
-var nugetApiKey = Argument<string>("nugetApiKey", null);
-var version = Argument("nugetVersion", "");
-var gitlabProjectPath = Argument("gitlabProjectPath", "");
-var gitlabProjectId = Argument("gitlabProjectId", "");
-var gitlabToken = Argument("gitlabToken", "");
-
-// Define directories
-var projects = GetFiles("./**/*.csproj");
-var artifactsDir = Directory("./Artifacts");
-string nupkgDir;
-var solutionFile = GetFiles("./**/*.sln").First();
-var projectName = solutionFile.GetFilenameWithoutExtension().ToString();
-var nugetSource = "https://api.nuget.org/v3/index.json";
-var assemblyInfoSubPath = "Properties/AssemblyInfo.cs";
-var semanticVersion = "";
-string localNugetFeed;
-
-// get latest MSBuild version
-var vsLatest  = VSWhereLatest();	
-var msBuildPathX64 = (vsLatest == null) ? null : vsLatest.CombineWithFilePath("./MSBuild/Current/Bin/MSBuild.exe");
-
-Setup(context =>{
-	nupkgDir = $"{artifactsDir.ToString()}/nupkg";
-	var branch = GitVersion(new GitVersionSettings {
-			UpdateAssemblyInfo = false
-		}).BranchName.Replace("/", "-");
-
-	localNugetFeed = $"C:\\coscine\\LocalNugetFeeds\\{branch}";
-	Information("{0}", branch);
-	Information("Started at {0}", DateTime.Now);
-});
-
-Teardown(context =>{
-	Information("Finished at {0}", DateTime.Now);
-});
-
-Task("Clean")
-.Description("Cleans all build and artifacts directories")
-.Does(() =>{
-	var settings = new DeleteDirectorySettings {
-		Recursive = true,
-		Force = true
-	};
-	
-	var directoriesToClean = new List<DirectoryPath>();
-	
-	foreach(var project in projects) {
-		directoriesToClean.Add(Directory($"{project.GetDirectory()}/obj"));
-		directoriesToClean.Add(Directory($"{project.GetDirectory()}/bin"));
-	}
-	
-	directoriesToClean.Add(artifactsDir);
-
-	foreach(var dir in directoriesToClean) {
-		Information("Cleaning {0}", dir.ToString());
-		if (DirectoryExists(dir)) {
-			DeleteDirectory(dir, settings);
-			CreateDirectory(dir);
-		} else {
-			CreateDirectory(dir);
-		}
-	}
-});
-
-Task("Restore")
-.Does(() =>{
-	NuGetRestore(solutionFile, new NuGetRestoreSettings {
-		NoCache = true,
-		FallbackSource = new List<string>{ localNugetFeed },
-	});
-});
-
-Task("Test")
-.IsDependentOn("Build")
-.Does(() =>{
-	NUnit3($"./src/**/bin/{configuration}/*.Tests.dll", new NUnit3Settings {
-		// generate the xml file
-		NoResults = false,
-		Results = new NUnit3Result[] {
-			new NUnit3Result() {
-				FileName = $"{artifactsDir}/TestResults.xml",
-				Transform = $"{Context.Environment.WorkingDirectory}/nunit3-junit.xslt"
-			}
-		}
-	});
-});
-
-Task("GitVersion")
-.Does(() => {
-	if(string.IsNullOrWhiteSpace(version)) {
-		version = GitVersion(new GitVersionSettings {
-			UpdateAssemblyInfo = false
-		}).NuGetVersionV2;
-	}
-	var index = version.IndexOf("-");
-	semanticVersion = index > 0 ? version.Substring(0, index) : version;
-	Information("Version: {0}, SemanticVersion: {1}", version, semanticVersion);
-});
-
-Task("UpdateAssemblyInfo")
-.Does(() =>{
-	var index = version.IndexOf("-");
-	var semanticVersion = index > 0 ? version.Substring(0, index) : version;
-
-	foreach(var project in projects) {
-		CreateAssemblyInfo($"{project.GetDirectory()}/{assemblyInfoSubPath}", new AssemblyInfoSettings {
-			Product = project.GetFilenameWithoutExtension().ToString(),
-			Title = project.GetFilenameWithoutExtension().ToString(),
-			Company = "IT Center, RWTH Aachen University",
-			Version = semanticVersion,
-			FileVersion = semanticVersion,
-			InformationalVersion = version,
-			Copyright = $"{DateTime.Now.Year} IT Center, RWTH Aachen University",
-			Description = $"{project.GetFilenameWithoutExtension().ToString()} is a part of the CoScInE group."
-		});
-	}
-});
-
-Task("GitlabRelease")
-.IsDependentOn("GitVersion")
-.Does(() => {
-	var client = new HttpClient();
-	client.DefaultRequestHeaders.Add("PRIVATE-TOKEN", gitlabToken);
-	
-	// get the latest tag
-	var result = client.GetAsync($"https://git.rwth-aachen.de/api/v4/projects/{gitlabProjectId}/repository/tags").Result;
-	if(!result.IsSuccessStatusCode) {
-		throw new Exception("Tag query failed.");
-	}
-
-	var tagList = result.Content.ReadAsStringAsync().Result;
-	var jArray = JArray.Parse(tagList);
-	// null if not tags exists yet
-	var lastTag = jArray.Select(x => x["name"]).FirstOrDefault();
-
-	var url = $"https://git.rwth-aachen.de/{gitlabProjectPath}";
-	
-	if(url.EndsWith(".git")) {
-		url = url.Substring(0, url.Length - ".git".Length);
-	}
-
-	if(url.EndsWith("/")) {
-		url = url.Substring(0, url.Length - 1);
-	}
-
-	var description = "";
-	// First line of description
-	// Gitlab compare url, if something can be compared
-	if(lastTag == null) {
-		description = $"# {semanticVersion} ({DateTime.Now.Year}-{DateTime.Now.Month}-{DateTime.Now.Day})\n\n\n";
-	} else {
-		description = $"# [{semanticVersion}]({url}/compare/{lastTag}...v{semanticVersion}) ({DateTime.Now.Year}-{DateTime.Now.Month}-{DateTime.Now.Day})\n\n\n";
-	}
-
-	// From when will messages be parsed, null results in all messages
-	var logParam = "";
-	if(lastTag != null) {
-		logParam = $"{lastTag}..Head";
-	}
-
-	Information(lastTag);
-
-	IEnumerable<string> redirectedStandardOutput;
-	var exitCodeWithArgument =
-		StartProcess(
-			"git",
-			new ProcessSettings {
-				Arguments = $"log {logParam} --pretty=format:HASH%h:%B",
-				RedirectStandardOutput = true
-			},
-			out redirectedStandardOutput
-		);
-
-	var prefixList = new Dictionary<string, List<string>>{
-		{"Fix", new List<string>()},
-		{"Update", new List<string>()},
-		{"New", new List<string>()},
-		{"Breaking", new List<string>()},
-		{"Docs", new List<string>()},
-		{"Build", new List<string>()},
-		{"Upgrade", new List<string>()},
-		{"Chore", new List<string>()},
-	};
-
-	var currentHash = "";
-	// Output last line of process output.
-	foreach(var line in redirectedStandardOutput) {
-		var commitMessage = "";
-		if(line.StartsWith("HASH")) {
-			currentHash = line.Substring("HASH".Length);
-			currentHash = currentHash.Substring(0, currentHash.IndexOf(":"));
-			commitMessage = line.Substring(currentHash.Length + line.IndexOf(currentHash) + 1);
-		} else {
-			commitMessage = line;
-		}
-
-		foreach(var kv in prefixList) {
-			if(commitMessage.StartsWith($"{kv.Key}:")) {
-				kv.Value.Add($"* {commitMessage.Substring(kv.Key.Length + 1).Trim()} {currentHash}");
-				break;
-			}
-		};
-	}
-	
-	foreach(var kv in prefixList) {
-		if(kv.Value.Any()) {
-			description += $" ### {kv.Key}\n\n";
-			foreach(var line in kv.Value) {
-				description += $"{line}\n";
-			}
-			description += "\n";
-		}
-	}
-	// correctly escape the json newlines
-	description = description.Replace("\n", "\\n");
-	Information("Description: {0}", description);
-
-	// create tag
-	result = client.PostAsync($"https://git.rwth-aachen.de/api/v4/projects/{gitlabProjectId}/repository/tags?tag_name=v{semanticVersion}&ref=master", null).Result;
-	Information("Create tag: {0}", result.Content.ReadAsStringAsync().Result);
-	if(!result.IsSuccessStatusCode) {
-		throw new Exception("Tag creation failed.");
-	}
-
-	// create release
-	var json = $"{{\"name\": \"v{semanticVersion}\", \"tag_name\": \"v{semanticVersion}\", \"description\": \"{description}\"}}";
-	var content = new StringContent(json, Encoding.UTF8, "application/json");
-	result = client.PostAsync($"https://git.rwth-aachen.de/api/v4/projects/{gitlabProjectId}/releases", content).Result;
-	Information("Create release: {0}", result.Content.ReadAsStringAsync().Result);
-	if(!result.IsSuccessStatusCode) {
-		throw new Exception("Release creation failed.");
-	}
-});
-
-Task("Build")
-.IsDependentOn("Clean")
-.IsDependentOn("GitVersion")
-.IsDependentOn("UpdateAssemblyInfo")
-.IsDependentOn("Restore")
-.Does(() =>{
-		var frameworkSettingsWindows = new MSBuildSettings {
-			Configuration = configuration
-		};
-		
-		frameworkSettingsWindows.ToolPath = msBuildPathX64;
-		frameworkSettingsWindows.WorkingDirectory = Context.Environment.WorkingDirectory;
-
-		if (configuration.Equals("Release")) {
-			frameworkSettingsWindows.WithProperty("DebugSymbols", "false");
-			frameworkSettingsWindows.WithProperty("DebugType", "None");
-		}
-
-		// Use MSBuild
-		Information("Building {0}", solutionFile);
-		MSBuild(solutionFile, frameworkSettingsWindows);
-});
-
-Task("NugetPack")
-.IsDependentOn("Build")
-.Does(() =>{
-	foreach(var project in projects) {
-			var nuspec = $"{project.GetDirectory()}/{project.GetFilenameWithoutExtension()}.nuspec";
-			if(!project.ToString().EndsWith(".Tests") && FileExists(nuspec))
-			{
-				var settings = new NuGetPackSettings 
-				{
-					OutputDirectory = nupkgDir,
-					Version = version,
-					Properties = new Dictionary<string, string>
-					{
-						{ "Configuration", configuration}
-					}
-				};				
-				NuGetPack(project.ToString(), settings);
-			}
-		}
-});
-
-Task("NugetPush")
-.IsDependentOn("NugetPack")
-.Does(() =>{
-	var nupkgs = GetFiles($"{nupkgDir}/*.nupkg");
-	Information("Need to push {0} packages", nupkgs.Count);
-	if(!String.IsNullOrWhiteSpace(nugetApiKey)) {
-		foreach(var nupkg in nupkgs) {
-			Information("Pushing {0}", nupkg);
-			NuGetPush(nupkg, new NuGetPushSettings {
-				Source = nugetSource,
-				ApiKey = nugetApiKey
-			});
-		}
-	} else {
-		Information("NugetApiKey is not set. Can't push.");
-		throw new Exception("NugetApiKey is not set. Can't push.");
-	}
-});
-
-Task("CopyToArtifacts")
-.Does(() =>{
-	foreach(var project in projects) {
-		if(!project.GetDirectory().ToString().EndsWith(".Tests")
-		&& !FileExists($"{project.GetDirectory()}/{project.GetFilenameWithoutExtension()}.nuspec")
-		&& DirectoryExists(project.GetDirectory()))
-		{
-			Information("Copying {0}/* to {1}", $"{project.GetDirectory()}/bin/{configuration}", artifactsDir);
-			CopyDirectory($"{project.GetDirectory()}/bin/{configuration}/", artifactsDir);
-		}
-	}
-});
-
-Task("NugetPushLocal")
-.IsDependentOn("NugetPack")
-.Does(() =>{	
-	var nupkgs = GetFiles($"{nupkgDir}/*.nupkg");
-	foreach(var nupkg in nupkgs) {
-		if(!DirectoryExists(localNugetFeed)) {
-			CreateDirectory(localNugetFeed);
-		}
-		CopyFile(nupkg.ToString(), $"{localNugetFeed}\\{nupkg.GetFilename()}");
-	}
-});
-
-Task("Prerelease")
-.IsDependentOn("Build")
-.IsDependentOn("CopyToArtifacts")
-.IsDependentOn("NugetPushLocal");
-
-Task("Release")
-.IsDependentOn("NugetPack")
-.IsDependentOn("CopyToArtifacts")
-.IsDependentOn("NugetPushLocal")
-.IsDependentOn("NugetPush");
-
-Task("Default")
-.IsDependentOn("Test");
-
-RunTarget(target);

build.ps1

-##########################################################################
-# This is the Cake bootstrapper script for PowerShell.
-# This file was downloaded from https://github.com/cake-build/resources
-# Feel free to change this file to fit your needs.
-##########################################################################
-
-<#
-
-.SYNOPSIS
-This is a Powershell script to bootstrap a Cake build.
-
-.DESCRIPTION
-This Powershell script will download NuGet if missing, restore NuGet tools (including Cake)
-and execute your Cake build script with the parameters you provide.
-
-.PARAMETER Script
-The build script to execute.
-.PARAMETER Target
-The build script target to run.
-.PARAMETER Configuration
-The build configuration to use.
-.PARAMETER Verbosity
-Specifies the amount of information to be displayed.
-.PARAMETER ShowDescription
-Shows description about tasks.
-.PARAMETER DryRun
-Performs a dry run.
-.PARAMETER SkipToolPackageRestore
-Skips restoring of packages.
-.PARAMETER ScriptArgs
-Remaining arguments are added here.
-
-.LINK
-https://cakebuild.net
-
-#>
-
-[CmdletBinding()]
-Param(
-    [string]$Script = "build.cake",
-    [string]$Target,
-    [string]$Configuration,
-    [ValidateSet("Quiet", "Minimal", "Normal", "Verbose", "Diagnostic")]
-    [string]$Verbosity,
-    [switch]$ShowDescription,
-    [Alias("WhatIf", "Noop")]
-    [switch]$DryRun,
-    [switch]$SkipToolPackageRestore,
-    [Parameter(Position=0,Mandatory=$false,ValueFromRemainingArguments=$true)]
-    [string[]]$ScriptArgs
-)
-
-# Attempt to set highest encryption available for SecurityProtocol.
-# PowerShell will not set this by default (until maybe .NET 4.6.x). This
-# will typically produce a message for PowerShell v2 (just an info
-# message though)
-try {
-    # Set TLS 1.2 (3072), then TLS 1.1 (768), then TLS 1.0 (192), finally SSL 3.0 (48)
-    # Use integers because the enumeration values for TLS 1.2 and TLS 1.1 won't
-    # exist in .NET 4.0, even though they are addressable if .NET 4.5+ is
-    # installed (.NET 4.5 is an in-place upgrade).
-    # PowerShell Core already has support for TLS 1.2 so we can skip this if running in that.
-    if (-not $IsCoreCLR) {
-        [System.Net.ServicePointManager]::SecurityProtocol = 3072 -bor 768 -bor 192 -bor 48
-    }
-  } catch {
-    Write-Output 'Unable to set PowerShell to use TLS 1.2 and TLS 1.1 due to old .NET Framework installed. If you see underlying connection closed or trust errors, you may need to upgrade to .NET Framework 4.5+ and PowerShell v3'
-  }
-
-[Reflection.Assembly]::LoadWithPartialName("System.Security") | Out-Null
-function MD5HashFile([string] $filePath)
-{
-    if ([string]::IsNullOrEmpty($filePath) -or !(Test-Path $filePath -PathType Leaf))
-    {
-        return $null
-    }
-
-    [System.IO.Stream] $file = $null;
-    [System.Security.Cryptography.MD5] $md5 = $null;
-    try
-    {
-        $md5 = [System.Security.Cryptography.MD5]::Create()
-        $file = [System.IO.File]::OpenRead($filePath)
-        return [System.BitConverter]::ToString($md5.ComputeHash($file))
-    }
-    finally
-    {
-        if ($file -ne $null)
-        {
-            $file.Dispose()
-        }
-    }
-}
-
-function GetProxyEnabledWebClient
-{
-    $wc = New-Object System.Net.WebClient
-    $proxy = [System.Net.WebRequest]::GetSystemWebProxy()
-    $proxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
-    $wc.Proxy = $proxy
-    return $wc
-}
-
-Write-Host "Preparing to run build script..."
-
-if(!$PSScriptRoot){
-    $PSScriptRoot = Split-Path $MyInvocation.MyCommand.Path -Parent
-}
-
-$TOOLS_DIR = Join-Path $PSScriptRoot "tools"
-$ADDINS_DIR = Join-Path $TOOLS_DIR "Addins"
-$MODULES_DIR = Join-Path $TOOLS_DIR "Modules"
-$NUGET_EXE = Join-Path $TOOLS_DIR "nuget.exe"
-$CAKE_EXE = Join-Path $TOOLS_DIR "Cake/Cake.exe"
-$NUGET_URL = "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe"
-$PACKAGES_CONFIG = Join-Path $TOOLS_DIR "packages.config"
-$PACKAGES_CONFIG_MD5 = Join-Path $TOOLS_DIR "packages.config.md5sum"
-$ADDINS_PACKAGES_CONFIG = Join-Path $ADDINS_DIR "packages.config"
-$MODULES_PACKAGES_CONFIG = Join-Path $MODULES_DIR "packages.config"
-
-# Make sure tools folder exists
-if ((Test-Path $PSScriptRoot) -and !(Test-Path $TOOLS_DIR)) {
-    Write-Verbose -Message "Creating tools directory..."
-    New-Item -Path $TOOLS_DIR -Type Directory | Out-Null
-}
-
-# Make sure that packages.config exist.
-if (!(Test-Path $PACKAGES_CONFIG)) {
-    Write-Verbose -Message "Downloading packages.config..."
-    try {
-        $wc = GetProxyEnabledWebClient
-        $wc.DownloadFile("https://cakebuild.net/download/bootstrapper/packages", $PACKAGES_CONFIG)
-    } catch {
-        Throw "Could not download packages.config."
-    }
-}
-
-# Try find NuGet.exe in path if not exists
-if (!(Test-Path $NUGET_EXE)) {
-    Write-Verbose -Message "Trying to find nuget.exe in PATH..."
-    $existingPaths = $Env:Path -Split ';' | Where-Object { (![string]::IsNullOrEmpty($_)) -and (Test-Path $_ -PathType Container) }
-    $NUGET_EXE_IN_PATH = Get-ChildItem -Path $existingPaths -Filter "nuget.exe" | Select -First 1
-    if ($NUGET_EXE_IN_PATH -ne $null -and (Test-Path $NUGET_EXE_IN_PATH.FullName)) {
-        Write-Verbose -Message "Found in PATH at $($NUGET_EXE_IN_PATH.FullName)."
-        $NUGET_EXE = $NUGET_EXE_IN_PATH.FullName
-    }
-}
-
-# Try download NuGet.exe if not exists
-if (!(Test-Path $NUGET_EXE)) {
-    Write-Verbose -Message "Downloading NuGet.exe..."
-    try {
-        $wc = GetProxyEnabledWebClient
-        $wc.DownloadFile($NUGET_URL, $NUGET_EXE)
-    } catch {
-        Throw "Could not download NuGet.exe."
-    }
-}
-
-# Save nuget.exe path to environment to be available to child processed
-$env:NUGET_EXE = $NUGET_EXE
-$env:NUGET_EXE_INVOCATION = if ($IsLinux -or $IsMacOS) {
-    "mono `"$NUGET_EXE`""
-} else {
-    "`"$NUGET_EXE`""
-}
-
-# Restore tools from NuGet?
-if(-Not $SkipToolPackageRestore.IsPresent) {
-    Push-Location
-    Set-Location $TOOLS_DIR
-
-    # Check for changes in packages.config and remove installed tools if true.
-    [string] $md5Hash = MD5HashFile $PACKAGES_CONFIG
-    if((!(Test-Path $PACKAGES_CONFIG_MD5)) -Or
-    ($md5Hash -ne (Get-Content $PACKAGES_CONFIG_MD5 ))) {
-        Write-Verbose -Message "Missing or changed package.config hash..."
-        Get-ChildItem -Exclude packages.config,nuget.exe,Cake.Bakery |
-        Remove-Item -Recurse
-    }
-
-    Write-Verbose -Message "Restoring tools from NuGet..."
-    
-    $NuGetOutput = Invoke-Expression "& $env:NUGET_EXE_INVOCATION install -ExcludeVersion -OutputDirectory `"$TOOLS_DIR`""
-
-    if ($LASTEXITCODE -ne 0) {
-        Throw "An error occurred while restoring NuGet tools."
-    }
-    else
-    {
-        $md5Hash | Out-File $PACKAGES_CONFIG_MD5 -Encoding "ASCII"
-    }
-    Write-Verbose -Message ($NuGetOutput | Out-String)
-
-    Pop-Location
-}
-
-# Restore addins from NuGet
-if (Test-Path $ADDINS_PACKAGES_CONFIG) {
-    Push-Location
-    Set-Location $ADDINS_DIR
-
-    Write-Verbose -Message "Restoring addins from NuGet..."
-    $NuGetOutput = Invoke-Expression "& $env:NUGET_EXE_INVOCATION install -ExcludeVersion -OutputDirectory `"$ADDINS_DIR`""
-
-    if ($LASTEXITCODE -ne 0) {
-        Throw "An error occurred while restoring NuGet addins."
-    }
-
-    Write-Verbose -Message ($NuGetOutput | Out-String)
-
-    Pop-Location
-}