/// <summary> /// Creates a random <see langword="int"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="int"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static int AnyInt32(this IAnonymousData anon, int minimum, int maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, int.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((int)anon.AnyInt64(minimum, maximum, distribution)); }
/// <summary> /// Creates a random <see langword="IEnumerable{T}"/> sequence of objects of the specified type. /// </summary> /// <typeparam name="T">The type of objects to create.</typeparam> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimumLength">The minimum length of the sequence.</param> /// <param name="maximumLength">The maximum length of the sequence.</param> /// <returns>A random <see langword="IEnumerable{T}"/> sequence of the specified type of objects.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximumLength"/> is less than <paramref name="minimumLength"/>.</exception> public static IEnumerable <T> AnyEnumerable <T>(this IAnonymousData anon, int minimumLength, int maximumLength) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximumLength, minimumLength, int.MaxValue, nameof(maximumLength), "The maximum length must be greater than the minimum length."); return(anon.AnyEnumerable(typeof(T), minimumLength, maximumLength).Cast <T>()); }
/////// <summary> /////// Returns a random item from the specified <see cref="Array"/>. /////// </summary> /////// <param name="anon">The anonymous data provider to use.</param> /////// <param name="array">The <see cref="Array"/>.</param> /////// <returns>A random item from the collection.</returns> ////public static object AnyItem(this IAnonymousData anon, Array array) ////{ //// var index = anon.AnyInt32(0, array.Length); //// return array.GetValue(index); ////} private static IEnumerable AnyEnumerable(IAnonymousData anon, Type type, int length) { for (int i = 0; i < length; ++i) { yield return(anon.Any(type)); } }
/// <summary> /// Creates a random <see langword="IEnumerable"/> sequence of 0 to 20 objects of the specified type. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="type">The type of objects to create.</param> /// <returns>A random <see langword="IEnumerable"/> sequence of the specified type of objects.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> or <paramref name="type"/> is <c>null</c>.</exception> public static IEnumerable AnyEnumerable(this IAnonymousData anon, Type type) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(type, nameof(type)); return(anon.AnyEnumerable(type, 0, 20)); }
/// <summary> /// Creates an anonymous <see langword="byte"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="byte"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static byte AnyByte(this IAnonymousData anon, byte minimum, byte maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, double.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((byte)anon.AnyInt64(minimum, maximum, distribution)); }
/// <summary> /// Creates a random <see langword="float"/> value within the specified range using a uniform /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <returns>A random <see langword="float"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static float AnySingle(this IAnonymousData anon, float minimum, float maximum) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, float.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return(anon.AnySingle(minimum, maximum, Distribution.Uniform)); }
/// <summary> /// Creates a random <see langword="long"/> value within the specified range using a uniform /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <returns>A random <see langword="long"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static long AnyInt64(this IAnonymousData anon, long minimum, long maximum) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, long.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return(anon.AnyInt64(minimum, maximum, Distribution.Uniform)); }
/// <summary> /// Creates a <see langword="long"/> value within the specified ranges using the specified factory /// and distribution algorithm. /// </summary> /// <param name="factory">The factory used to create the <see langword="long"/> value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <param name="ranges">The ranges the value must be within.</param> /// <returns>A random <see langword="long"/> value that falls within the specified ranges.</returns> public static long CreateLongFromRanges(IAnonymousData factory, Distribution distribution, params Range[] ranges) { Argument.NotNull(factory, nameof(factory)); Argument.NotNull(ranges, nameof(ranges)); if (ranges.Length == 0) { throw new ArgumentException("The ranges must not be empty.", nameof(ranges)); } VerifyRanges(ranges); var length = ranges.Sum(r => r.Length); var index = factory.AnyInt64(0, length - 1, distribution); for (var i = 0; i < ranges.Length; ++i) { if (index < ranges[i].Length) { var result = ranges[i].Minimum + index; Debug.Assert(result >= ranges[i].Minimum && result <= ranges[i].Maximum, "Invalid range value."); return(result); } index -= ranges[i].Length; } throw new InvalidOperationException(); }
/// <summary> /// Creates an anonymous <see langword="char"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="char"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static char AnyChar(this IAnonymousData anon, char minimum, char maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, char.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((char)anon.AnyInt64(minimum, maximum, distribution)); }
/// <summary> /// Creates a random <see langword="IEnumerable"/> sequence of 0 to 20 objects of the specified type. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="type">The type of objects to create.</param> /// <returns>A random <see langword="IEnumerable"/> sequence of the specified type of objects.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> or <paramref name="type"/> is <c>null</c>.</exception> public static IEnumerable AnyEnumerable(this IAnonymousData anon, Type type) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(type, nameof(type)); return(anon.AnyEnumerable(type, anon.GetMinimumItemCount(), anon.GetMaximumItemCount())); }
/// <summary> /// Creates a random <see langword="decimal"/> value using a uniform distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="decimal"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static decimal AnyDecimal(this IAnonymousData anon, decimal minimum, decimal maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, decimal.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((decimal)anon.AnyDouble((double)minimum, (double)maximum, distribution)); }
/// <summary> /// Creates a random <see langword="TimeSpan"/> value within the specified range using a uniform /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <returns>A random <see langword="TimeSpan"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static TimeSpan AnyTimeSpan(this IAnonymousData anon, TimeSpan minimum, TimeSpan maximum) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, TimeSpan.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return(anon.AnyTimeSpan(minimum, maximum, Distribution.Uniform)); }
/// <summary> /// Creates a random <see langword="string"/> value with a length within the specified range using /// a uniform distribution algorithm for generating alpha characters. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimumLength">The minimum length.</param> /// <param name="maximumLength">The maximum length.</param> /// <returns>A random <see langword="string"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximumLength"/> is less than <paramref name="minimumLength"/>.</exception> public static string AnyString(this IAnonymousData anon, int minimumLength, int maximumLength) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximumLength, minimumLength, int.MaxValue, nameof(maximumLength), "The maximum length must be greater than the minimum length."); return(anon.AnyString(minimumLength, maximumLength, Distribution.Uniform)); }
/// <summary> /// Returns a random item from the specified collection. /// </summary> /// <typeparam name="T">The item type.</typeparam> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="collection">The collection.</param> /// <returns>A random item from the collection.</returns> public static T AnyItem <T>(this IAnonymousData anon, IEnumerable <T> collection) { var items = collection as IList <T> ?? collection.ToList(); var index = anon.AnyInt32(0, items.Count); return(items[index]); }
private static int GetMinimumItemCount(this IAnonymousData anon) { Argument.NotNull(anon, nameof(anon)); var value = anon.GetValue(MinItemCountKey); return(value == null ? 1 : (int)value); }
/// <summary> /// Creates a random <see langword="string"/> value representing a first name. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="male">If set to <c>true</c> a male first name is created; otherwise, a female /// first name is created.</param> /// <returns>A random first name.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static string AnyFirstName(this IAnonymousData anon, bool male) { Argument.NotNull(anon, nameof(anon)); var names = male ? MaleFirstNames : FemaleFirstNames; return(anon.AnyItem(names)); }
/// <summary> /// Creates a random value of the specified <see cref="Enum"/> type using a uniform distribution /// algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="enumType">The <see cref="Enum"/> type.</param> /// <returns>A random value of the specified <see cref="Enum"/> type.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> or <paramref name="enumType"/> is <c>null</c>.</exception> public static object AnyEnumValue(this IAnonymousData anon, Type enumType) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(enumType, nameof(enumType)); Argument.IsEnumType(enumType, nameof(enumType)); return(anon.AnyEnumValue(enumType, Distribution.Uniform)); }
/// <summary> /// Creates a random <see langword="TimeSpan"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="TimeSpan"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static TimeSpan AnyTimeSpan(this IAnonymousData anon, TimeSpan minimum, TimeSpan maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, TimeSpan.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); long ticks = anon.AnyInt64(minimum.Ticks, maximum.Ticks, distribution); return(new TimeSpan(ticks)); }
/// <summary> /// Creates a random <see langword="long"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="long"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static long AnyInt64(this IAnonymousData anon, long minimum, long maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, long.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); var min = Math.Max(minimum, long.MinValue + 1); return(min + (long)(anon.AnyDouble(0, 1, distribution) * ((double)maximum - (double)min))); }
/// <summary> /// Anies the specified predicate. /// </summary> /// <typeparam name="T">The type to create.</typeparam> /// <param name="anon">The anon.</param> /// <param name="predicate">The predicate.</param> /// <returns>An instance of the specified type.</returns> public static T Any <T>( this IAnonymousData anon, Predicate <T> predicate) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(predicate, nameof(predicate)); return(anon.Any <T>(PopulateOption.None, 20, predicate)); }
/// <summary> /// Creates a random <see langword="DateTime"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="DateTime"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is null.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static DateTime AnyDateTime(this IAnonymousData anon, DateTime minimum, DateTime maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, DateTime.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); var ticks = anon.AnyInt64(minimum.Ticks, maximum.Ticks, distribution); return(new DateTime(ticks)); }
/// <summary> /// Creates a random <see langword="IEnumerable"/> sequence of objects of the specified type. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="type">The type of objects to create.</param> /// <param name="minimumLength">The minimum length of the sequence.</param> /// <param name="maximumLength">The maximum length of the sequence.</param> /// <returns>A random <see langword="IEnumerable"/> sequence of the specified type of objects.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> or <paramref name="type"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximumLength"/> is less than <paramref name="minimumLength"/>.</exception> public static IEnumerable AnyEnumerable(this IAnonymousData anon, Type type, int minimumLength, int maximumLength) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(type, nameof(type)); Argument.InRange(maximumLength, minimumLength, int.MaxValue, nameof(maximumLength), "The maximum length must be greater than the minimum length."); int length = anon.AnyInt32(minimumLength, maximumLength); return(AnyEnumerable(anon, type, length)); }
/// <summary> /// Creates a random <see langword="DateTimeOffset"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="DateTimeOffset"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static DateTimeOffset AnyDateTimeOffset(this IAnonymousData anon, DateTimeOffset minimum, DateTimeOffset maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, DateTimeOffset.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); var ticks = anon.AnyInt64(minimum.Ticks, maximum.Ticks, distribution); var offset = Offsets[anon.AnyInt32(0, Offsets.Length)]; return(new DateTimeOffset(ticks, offset)); }
private static string AnySimpleFullName(this IAnonymousData anon, bool male) { switch (anon.AnyInt32(0, 5)) { case 0: return($"{anon.AnyFirstName(male)} {anon.AnyFirstName(male).Substring(0, 1)}. {anon.AnySurname()}"); default: return($"{anon.AnyFirstName(male)} {anon.AnySurname()}"); } }
/// <summary> /// Anies the specified retry attempts. /// </summary> /// <typeparam name="T">The type to create.</typeparam> /// <param name="anon">The anon.</param> /// <param name="retryAttempts">The retry attempts.</param> /// <param name="predicate">The predicate.</param> /// <returns>An instance of the specified type.</returns> public static T Any <T>( this IAnonymousData anon, int retryAttempts, Predicate <T> predicate) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(predicate, nameof(predicate)); Argument.InRange(retryAttempts, 0, int.MaxValue, nameof(retryAttempts)); return(anon.Any <T>(PopulateOption.None, retryAttempts, predicate)); }
/// <summary> /// Creates a random value of the specified <see cref="Enum"/> type using the specified distribution /// algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="enumType">The <see cref="Enum"/> type.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random value of the specified <see cref="Enum"/> type.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/>, <paramref name="enumType"/> is <c>null</c>.</exception> /// <exception cref="ArgumentException"><paramref name="enumType"/> is not an enum type.</exception> public static object AnyEnumValue(this IAnonymousData anon, Type enumType, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(enumType, nameof(enumType)); Argument.IsEnumType(enumType, nameof(enumType)); var values = Enum.GetValues(enumType); var index = anon.AnyInt32(0, values.Length, distribution); return(values.GetValue(index)); }
/// <summary> /// Anies the specified type. /// </summary> /// <param name="anon">The anon.</param> /// <param name="type">The type.</param> /// <param name="predicate">The predicate.</param> /// <returns>An instance of the specified type.</returns> public static object Any( this IAnonymousData anon, Type type, Predicate <object> predicate) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(type, nameof(type)); Argument.NotNull(predicate, nameof(predicate)); return(anon.Any(type, PopulateOption.None, 20, predicate)); }
/// <summary> /// Creates a random value of the specified <see cref="Enum"/> type using the specified distribution /// algorithm. /// </summary> /// <typeparam name="T">The <see cref="Enum"/> type</typeparam> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random value of the specified <see cref="Enum"/> type.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static T AnyEnumValue <T>(this IAnonymousData anon, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); var type = typeof(T); if (!type.IsEnum()) { throw new InvalidOperationException("Generic parameter T must be an Enum type."); } return((T)anon.AnyEnumValue(type, distribution)); }
/// <summary> /// Anies the specified type. /// </summary> /// <param name="anon">The anon.</param> /// <param name="type">The type.</param> /// <param name="retryAttempts">The retry attempts.</param> /// <param name="predicate">The predicate.</param> /// <returns>An instance of the specified type.</returns> public static object Any( this IAnonymousData anon, Type type, int retryAttempts, Predicate <object> predicate) { Argument.NotNull(anon, nameof(anon)); Argument.NotNull(type, nameof(type)); Argument.NotNull(predicate, nameof(predicate)); Argument.InRange(retryAttempts, 0, int.MaxValue, nameof(retryAttempts)); return(anon.Any(type, PopulateOption.None, retryAttempts, predicate)); }
/// <summary> /// Creates a random <see langword="string"/> value with a length within the specified range using /// the specified distribution algorithm for generating alpha characters. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimumLength">The minimum length.</param> /// <param name="maximumLength">The maximum length.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="string"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximumLength"/> is less than <paramref name="minimumLength"/>.</exception> public static string AnyString(this IAnonymousData anon, int minimumLength, int maximumLength, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximumLength, minimumLength, int.MaxValue, nameof(maximumLength), "The maximum length must be greater than the minimum length."); var length = anon.AnyInt32(minimumLength, maximumLength); var builder = new StringBuilder(length); while (builder.Length < length) { builder.Append(anon.AnyAlphaChar(distribution)); } return(builder.ToString()); }