Skip to content

A .NET library for all things random! Updated to support dotnet Core projects.

License

Notifications You must be signed in to change notification settings

trichards57/Lorem.Universal.NET

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lorem.NET for netstandard

A .NET library for all things random! Updated to use a netstandard library (to give as wide support as possible).

Build status Documentation Status NuGet

Usage

Text Helpers

// this will generate a string with three words:
string words = LoremNET.Lorem.Words(3);

// this will generate a string with two to five words:
string words = LoremNET.Lorem.Words(2, 5);

// this will generate a string with five to ten words with "uppercaseFirstLetter" set to "false" and "includePunctuation" set to "true":
string words = LoremNET.Lorem.Words(5, 10, false, true);

// a sentence is the same as "Words" except that it will include punctuation by default and will include a "." at the end of a string:
string sentence = LoremNET.Lorem.Sentence(5, 10);

// a paragraph is a string composed of multiple sentences; this paragraph will have five to six words per sentence, and four to ten sentences:
string paragraph = LoremNET.Lorem.Paragraph(5, 6, 4, 10);

// paragraphs is an array of paragraphs; this method will have eight to nine words per sentence, four to five sentences per paragraph, and one to three paragraphs:
IEnumerable<string> paragraphs = LoremNET.Lorem.Paragraphs(8, 9, 4, 5, 1, 3);

Breaking Change : As of v4.0, anything returning an IEnumerable can no-longer be relied on to return a stable result over multiple iterations. Technically IEnumerable doesn't promise this anyway, but previous version's implementation did produce a repeatable result.

Thanks to BaileyMillerSSI for pointing out the problem with the previous implementation and large results.

Extras

// this will generate a random valid email address:
string email = LoremNET.Lorem.Email();

// this will generate a random hex number (i.e. a color)
string hex = LoremNET.Lorem.HexNumber();

// this will generate a random DateTime object between 1/1/1950 and the current DateTime:
DateTime dateTime = LoremNET.Lorem.DateTime();

// this will generate a random DateTime object between 1/1/1995 and 12/31/2020:
DateTime dateTime = LoremNET.Lorem.DateTime(new DateTime(1995, 1, 1), new DateTime(2020, 12, 31))

// this will return "true" 55% of the time:
bool isTruth = LoremNET.Lorem.Chance(55, 100);

// this will randomly select an item from the group:
string[] numbers = GetNumbers();
string number = LoremNET.Lorem.Random(numbers);

// this will randomly select a value from the enum:
MyEnum value = LoremNET.Lorem.Enum<MyEnum>(); 

RandomHelper

Lorem.NET includes a thread-safe System.Random instance.

int i = LoremNET.RandomHelper.Instance.Next(1, 2);

About

A .NET library for all things random! Updated to support dotnet Core projects.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%