TerribleDev/UriBuilder.Fluent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add docs issue #4

Browse Source
This commit is contained in:
Tommy Parnell
2016-11-12 14:17:46 -05:00
parent c66614c2fe
commit 6e3e23061a
1 changed files with 49 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
src/UriBuilder.Fluent/TerribleDevUriExtensions.cs
View File

@@ -8,8 +8,22 @@ namespace System
{
public static class TerribleDevUriExtensions
{
/// <summary>
/// Appends a query string parameter with a key, and many values. Multiple values will be comma seperated. If only 1 value is passed and its null or value, the key will be added to the QS.
/// </summary>
/// <param name="bld"></param>
/// <param name="key"></param>
/// <param name="values"></param>
/// <returns></returns>
public static UriBuilder WithParameter(this UriBuilder bld, string key, params string[] values) => bld.WithParameter(key, valuesEnum: values);
/// <summary>
/// Appends a query string parameter with a key, and many values. Multiple values will be comma seperated. If only 1 value is passed and its null or value, the key will be added to the QS.
/// </summary>
/// <param name="bld"></param>
/// <param name="key"></param>
/// <param name="valuesEnum"></param>
/// <returns></returns>
public static UriBuilder WithParameter(this UriBuilder bld, string key, IEnumerable<object> valuesEnum)
{
if(string.IsNullOrWhiteSpace(key))
@@ -20,8 +34,7 @@ namespace System
{
valuesEnum = new string[0];
}
var isfirst = string.IsNullOrWhiteSpace(bld.Query);
var intitialValue = isfirst ? "" : $"{bld.Query.TrimStart('?')}&";
var intitialValue = string.IsNullOrWhiteSpace(bld.Query) ? "" : $"{bld.Query.TrimStart('?')}&";
var sb = new StringBuilder($"{intitialValue}{key}");
var validValueHit = false;
foreach(var value in valuesEnum)
@@ -37,6 +50,13 @@ namespace System
return bld;
}
/// <summary>
/// Sets the port to be the port number
/// </summary>
/// <param name="bld"></param>
/// <param name="port"></param>
/// <exception cref="ArgumentOutOfRangeException">Throws if port is less than one</exception>
/// <returns></returns>
public static UriBuilder WithPort(this UriBuilder bld, int port)
{
if(port < 1) throw new ArgumentOutOfRangeException(nameof(port));
@@ -44,6 +64,13 @@ namespace System
return bld;
}
/// <summary>
/// appends a path segment to the path. Can be called multiple times to append multiple segments
/// </summary>
/// <param name="bld"></param>
/// <param name="pathSegment"></param>
/// <exception cref="ArgumentNullException">You pass a string as a path segment</exception>
/// <returns></returns>
public static UriBuilder WithPathSegment(this UriBuilder bld, string pathSegment)
{
if(string.IsNullOrWhiteSpace(pathSegment))
@@ -55,6 +82,13 @@ namespace System
return bld;
}
/// <summary>
/// Sets your Uri Scheme
/// </summary>
/// <param name="bld"></param>
/// <param name="scheme"></param>
/// <exception cref="ArgumentNullException">You must pass a scheme</exception>
/// <returns></returns>
public static UriBuilder WithScheme(this UriBuilder bld, string scheme)
{
if(string.IsNullOrWhiteSpace(scheme)) throw new ArgumentNullException(nameof(scheme));
@@ -62,6 +96,13 @@ namespace System
return bld;
}
/// <summary>
///
/// </summary>
/// <param name="bld"></param>
/// <param name="host"></param>
/// <exception cref="ArgumentNullException">You must pass a ho0st</exception>
/// <returns></returns>
public static UriBuilder WithHost(this UriBuilder bld, string host)
{
if(string.IsNullOrWhiteSpace(host)) throw new ArgumentNullException(nameof(host));
@@ -69,6 +110,12 @@ namespace System
return bld;
}
/// <summary>
/// Use Https?
/// </summary>
/// <param name="bld"></param>
/// <param name="predicate">default true, if false sets scheme to http</param>
/// <returns></returns>
public static UriBuilder UseHttps(this UriBuilder bld, bool predicate = true)
{
bld.Scheme = predicate ? "https" : "http";