Crate random_data

random-data

A Rust library for generating realistic random data of any kind.

Looking for a CLI?

Checkout the random-json crate to use this data as a CLI. It let’s you choose the data you want with a dropdown dialogue in the terminal, or lets you generate big amounts of data in one go from a JSON schema!

Installation

cargo add random-data

Usage

use random_data::{DataType, DataGenerator};

fn main() {
    let mut generator = DataGenerator::new();

    // Generate a random address
    let address = DataType::Address.random(&mut generator);
    println!("Address: {address}");

    // Generate a random name
    let name = DataType::FirstName.random(&mut generator);
    println!("Name: {name}");

    // Generate a random email
    let email = DataType::Email.random(&mut generator);
    println!("Email: {email}");

    // Generate location data
    let country = DataType::Country.random(&mut generator);
    let coordinates = DataType::LatitudeLongitude.random(&mut generator);
    println!("Location: {country} at {coordinates}");

    // Generate technical data
    let ip = DataType::Ipv4.random(&mut generator);
    let mac = DataType::MacAddress.random(&mut generator);
    println!("Network: IP {ip} MAC {mac}");

    // List all the possible data types
    let list = DataType::list_str();
    println!("Possible data types: {list:?}");
}

Checking Available Values

Some data types have predefined lists of values. You can access these lists:

use random_data::{DataGenerator, DataType};

let mut generator = DataGenerator::new();

// Check if a data type has a predefined list
if let Some(values) = DataType::Month.values() {
    println!("Available months: {:?}", values);
}

// Formula-based types return None
assert!(DataType::Address.values().is_none());

// Generate and verify
let month = DataType::Month.random(&mut generator);
let all_months = DataType::Month.values().unwrap();
assert!(all_months.contains(&month.as_ref()));

Regional Data

The library includes region-specific generators:

use random_data::{DataGenerator, DataType};

let mut generator = DataGenerator::new();

// UK-specific data
let uk_address = DataType::UkAddress.random(&mut generator);
let uk_postcode = DataType::UkPostCode.random(&mut generator);
let uk_phone = DataType::UkPhoneNumber.random(&mut generator);

// French-specific data
let french_address = DataType::FrenchAddress.random(&mut generator);
let french_postcode = DataType::FrenchPostCode.random(&mut generator);
let french_phone = DataType::FrenchPhoneNumber.random(&mut generator);

Available Data Types

• Internet: EmailDomain, HttpStatusCode, MimeType, OpenSourceApp, TopLevelDomain, UserAgent, Ipv4, Ipv6, MacAddress
• Companies: CarBrand, CompanyName, Job
• Computer science: FileExtension, ProgrammingLanguage, ProgrammingParadigm, EditorColourTheme, ItDomain, DirPath, FileName, FilePath, Semver, SemverStable, SemverUnstable
• Famous people: Painter, Writer, Composer, Mathematician, Physician, Biologist, ComputerScientist, Philosopher
• Colours: HexColour, HslaColour, HslColour, RgbaColour, RgbColour, ColourName
• Geography: Latitude, LatitudeLongitude, Longitude, FrenchRiver, Country, City, Continent, CountryCode, Street, River, UkRiver
• Addresses: Address, FrenchAddress, FrenchPostCode, UkAddress, UkPostCode, FrenchStreet, FrenchRoadType, FrenchCounty, UsStateAbbr, UsState, UsRoads, UsRoadTypes, UkCountyCode, UkPostcodeArea, UkCounty, UkCity, UkRoadType, UkStreet, StreetNumber
• Science: ChemicalElement, MathematicalFunction
• Names: FirstName, FrenchFirstName, FrenchLastName, LastName, NameTitle
• Arts: LiteraryGenre, ArchitecturalStyle, MusicalGenre, MusicalInstrument
• Time: DaysOfWeek, Month, DaysOfWeekAbbr, MonthsAbbr, TimeZone, TimeUnit, AmPm
• Animals: Animal, Mammal, Bird, Insect, MythologicalCreature, Fish, Amphibian, Reptile, Mollusc, AnimalType
• Education: SchoolSubject, AcademicDiscipline, DegreesTitle, University, HistoricalBattle, Sport
• Primitives: AlphanumericCapitalChar, AlphanumericChar, Boolean, CapitalChar, Digit, LowerChar
• Personal data: CreditCard, Email, FrenchEmail, FrenchLicencePlate, FrenchPhoneNumber, NhsNumber, Password, PhoneNumber, SecuriteSociale, UkLicencePlate, UkPhoneNumber
• ISBNs: RandomIsbn10, RandomIsbn13
• Banks & finance: Bic, Iban, Isin, CurrencyName, CurrencySymbol, CurrencyCode
• Text: Word, Sentence, Paragraph
• Sky & space: Constellation, Planet, Star, Galaxy, CloudType

If you don’t want all the data to be loaded in your binary, you can use the feature flags to disable those you don’t want.

Structs

DataGenerator

Generator provded to the data types. Refer to DataType for usage information.

Enums

DataType

Representation of type that can be generated randomly.