thequux/Stationeers-RemoteControl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Got at least one data fetching method working; turns out, we can't use a patched LogicStack to get the data

Browse Source
This commit is contained in:
TQ Hirsch
2026-01-14 22:11:11 +01:00
parent 40a8431464
commit 3f7122d30a
350 changed files with 41444 additions and 119 deletions
Download Patch File Download Diff File Expand all files Collapse all files

125
Vendor/EmbedIO-3.5.2/Utilities/Validate.cs vendored Normal file
View File

@@ -0,0 +1,125 @@
using System;
namespace EmbedIO.Utilities
{
/// <summary>
/// Provides validation methods for method arguments.
/// </summary>
public static partial class Validate
{
/// <summary>
/// Ensures that an argument is not <see langword="null"/>.
/// </summary>
/// <typeparam name="T">The type of the argument to validate.</typeparam>
/// <param name="argumentName">The name of the argument to validate.</param>
/// <param name="value">The value to validate.</param>
/// <returns><paramref name="value"/> if not <see langword="null"/>.</returns>
/// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/>.</exception>
public static T NotNull<T>(string argumentName, T? value)
where T : class
=> value ?? throw new ArgumentNullException(argumentName);
/// <summary>
/// Ensures that a <see langword="string"/> argument is neither <see langword="null"/> nor the empty string.
/// </summary>
/// <param name="argumentName">The name of the argument to validate.</param>
/// <param name="value">The value to validate.</param>
/// <returns><paramref name="value"/> if neither <see langword="null"/> nor the empty string.</returns>
/// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/>.</exception>
/// <exception cref="ArgumentException"><paramref name="value"/> is the empty string.</exception>
public static string NotNullOrEmpty(string argumentName, string? value)
{
if (value == null)
throw new ArgumentNullException(argumentName);
if (value.Length == 0)
throw new ArgumentException("String is empty.", argumentName);
return value;
}
/// <summary>
/// Ensures that a valid URL can be constructed from a <see langword="string"/> argument.
/// </summary>
/// <param name="argumentName">Name of the argument.</param>
/// <param name="value">The value.</param>
/// <param name="uriKind">Specifies whether <paramref name="value"/> is a relative URL, absolute URL, or is indeterminate.</param>
/// <param name="enforceHttp">Ensure that, if <paramref name="value"/> is an absolute URL, its scheme is either <c>http</c> or <c>https</c>.</param>
/// <returns>The string representation of the constructed URL.</returns>
/// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/>.</exception>
/// <exception cref="ArgumentException">
/// <para><paramref name="value"/> is not a valid URL.</para>
/// <para>- or -</para>
/// <para><paramref name="enforceHttp"/> is <see langword="true"/>, <paramref name="value"/> is an absolute URL,
/// and <paramref name="value"/>'s scheme is neither <c>http</c> nor <c>https</c>.</para>
/// </exception>
/// <seealso cref="Url(string,string,Uri,bool)"/>
public static string Url(
string argumentName,
string value,
UriKind uriKind = UriKind.RelativeOrAbsolute,
bool enforceHttp = false)
{
Uri uri;
try
{
uri = new Uri(NotNull(argumentName, value), uriKind);
}
catch (UriFormatException e)
{
throw new ArgumentException("URL is not valid.", argumentName, e);
}
if (enforceHttp && uri.IsAbsoluteUri && uri.Scheme != Uri.UriSchemeHttp && uri.Scheme != Uri.UriSchemeHttps)
throw new ArgumentException("URL scheme is neither HTTP nor HTTPS.", argumentName);
return uri.ToString();
}
/// <summary>
/// Ensures that a valid URL, either absolute or relative to the given <paramref name="baseUri"/>,
/// can be constructed from a <see langword="string"/> argument and returns the absolute URL
/// obtained by combining <paramref name="baseUri"/> and <paramref name="value"/>.
/// </summary>
/// <param name="argumentName">Name of the argument.</param>
/// <param name="value">The value.</param>
/// <param name="baseUri">The base URI for relative URLs.</param>
/// <param name="enforceHttp">Ensure that the resulting URL's scheme is either <c>http</c> or <c>https</c>.</param>
/// <returns>The string representation of the constructed URL.</returns>
/// <exception cref="ArgumentNullException">
/// <para><paramref name="baseUri"/> is <see langword="null"/>.</para>
/// <para>- or -</para>
/// <para><paramref name="value"/> is <see langword="null"/>.</para>
/// </exception>
/// <exception cref="ArgumentException">
/// <para><paramref name="baseUri"/> is not an absolute URI.</para>
/// <para>- or -</para>
/// <para><paramref name="value"/> is not a valid URL.</para>
/// <para>- or -</para>
/// <para><paramref name="enforceHttp"/> is <see langword="true"/>,
/// and the combination of <paramref name="baseUri"/> and <paramref name="value"/> has a scheme
/// that is neither <c>http</c> nor <c>https</c>.</para>
/// </exception>
/// <seealso cref="Url(string,string,UriKind,bool)"/>
public static string Url(string argumentName, string value, Uri baseUri, bool enforceHttp = false)
{
if (!NotNull(nameof(baseUri), baseUri).IsAbsoluteUri)
throw new ArgumentException("Base URI is not an absolute URI.", nameof(baseUri));
Uri uri;
try
{
uri = new Uri(baseUri, new Uri(NotNull(argumentName, value), UriKind.RelativeOrAbsolute));
}
catch (UriFormatException e)
{
throw new ArgumentException("URL is not valid.", argumentName, e);
}
if (enforceHttp && uri.IsAbsoluteUri && uri.Scheme != Uri.UriSchemeHttp && uri.Scheme != Uri.UriSchemeHttps)
throw new ArgumentException("URL scheme is neither HTTP nor HTTPS.", argumentName);
return uri.ToString();
}
}
}