/// <summary>
/// Get full url to download ngrok on this platform
/// </summary>
/// <exception cref="NgrokUnsupportedException">Throws if platform not supported by ngrok</exception>
/// <returns></returns>
public string GetDownloadPath()
{
var architecture = RuntimeInformation.ProcessArchitecture;
const string cdn = "https://bin.equinox.io";
const string cdnPath = "c/4VmDzA7iaHb/ngrok-stable";
return($"{cdn}/{cdnPath}-{RuntimeExtensions.GetOSArchitectureString()}.zip");
}
/// <summary>
/// Download ngrok from equinox.io CDN
/// </summary>
/// <exception cref="NgrokUnsupportedException">Throws if platform not supported by ngrok</exception>
/// <exception cref="HttpRequestException">Throws if failed to download from CDN</exception>
/// <returns></returns>
public async Task DownloadNgrokAsync()
{
var downloadUrl = GetDownloadPath();
var fileName = $"{RuntimeExtensions.GetOSArchitectureString()}.zip";
var filePath = $"{Path.Combine(Directory.GetCurrentDirectory(), fileName)}";
var downloadResponse = await _httpClient.GetAsync(downloadUrl);
downloadResponse.EnsureSuccessStatusCode();
// Download Zip
var downloadStream = await downloadResponse.Content.ReadAsStreamAsync();
using (var writer = File.Create(filePath))
{
await downloadStream.CopyToAsync(writer);
}
// Extract zip
ZipFile.ExtractToDirectory(filePath, Directory.GetCurrentDirectory());
}
/// <summary>
/// Check if ngrok present in current directory or Windows PATH variable. If not, download from CDN, and throw exception if download fails
/// </summary>
/// <exception cref="NgrokUnsupportedException">Throws if platform not supported by ngrok</exception>
/// <exception cref="NgrokNotFoundException">Throws if ngrok not found and failed to download from CDN</exception>
/// <returns></returns>
public async Task <string> EnsureNgrokInstalled(NgrokOptions options)
{
// Search options
bool fileInOptions = !string.IsNullOrWhiteSpace(options.NgrokPath) && File.Exists(options.NgrokPath);
if (fileInOptions)
{
return(options.NgrokPath);
}
// Search execution directory
bool fileExists = File.Exists(Path.Combine(Directory.GetCurrentDirectory(), RuntimeExtensions.GetNgrokExecutableString()));
if (fileExists)
{
return(Path.Combine(Directory.GetCurrentDirectory(), RuntimeExtensions.GetNgrokExecutableString()));
}
// Search Windows PATH
var envFullPath = PathExtensions.GetFullPathFromEnvPath("ngrok.exe");
if (!string.IsNullOrWhiteSpace(envFullPath) && File.Exists(envFullPath))
{
return(envFullPath);
}
// Throw exception if not found yet and downloading is disabled
if (!options.DownloadNgrok)
{
throw new NgrokNotFoundException();
}
await DownloadNgrokAsync();
return(RuntimeExtensions.GetNgrokExecutableString());
}
