C++ Faker

C++ Faker is a modern C++20 open-source library for generating fake data for testing and development.

The library is heavily inspired by Faker.js.

Dependencies:

GTest: building tests (BUILD_FAKER_TESTS=OFF CMake flag to disable)
fmt

🎯 Goal

My goal is to provide a library like Faker.js for C++ developers.

Example

Lets see some simple example of generating fake data

#include <format>
#include <iostream>

#include "faker-cxx/Datatype.h"
#include "faker-cxx/Date.h"
#include "faker-cxx/Internet.h"
#include "faker-cxx/String.h"

int main()
{
    const auto id = faker::String::uuid();                   // 6fdb588e-0be9-480e-9eeb-8ff11b8afc00
    const auto email = faker::Internet::email();             // Sergio_Greenfelder@hotmail.com
    const auto password = faker::Internet::password();       // 91gZxLB*TfhAA!G
    const auto nickname = faker::Internet::username();       // Stuart_Boyle
    const auto active = faker::Datatype::boolean();          // true
    const auto emailVerified = faker::Datatype::boolean();   // false
    const auto verificationCode = faker::String::numeric(8); // 56910620
    const auto createdAt = faker::Date::pastDate();          // 2023-03-11T08:33:34Z
    const auto updatedAt = faker::Date::recentDate();        // 2023-07-19T22:59:19Z

    std::cout << std::format("id: {}, email: {}, password: {}, nickname: {}, active: {}, emailVerified: {}. "
                             "verificationCode: {}, createdAt: {}, updatedAt: {}",
                             id, email, password, nickname, active, emailVerified, verificationCode, createdAt,
                             updatedAt);

    return 0;
}

Compiler support

MSVC➚ version 143 or newer.
GCC➚ version 13 or newer.
Clang➚ version 16 or newer.
Apple Clang➚ version 16 or newer.

Consuming library with CMake (CMake version 3.22 or newer)

Add faker to git submodules (execute in project root):

mkdir externals
cd externals
git submodule add https://github.com/cieslarmichal/faker-cxx.git

Link with library:

set(BUILD_FAKER_TESTS OFF)

add_subdirectory(externals/faker-cxx)

add_executable(main Main.cpp)

target_link_libraries(main faker-cxx)

💎 Modules

🛩 Airline - aircraft types, airlines, airports, flight numbers
🐼 Animal - animal types and species
📖 Book - book title, genre, author, publisher, ISBN
🎨 Color - color names, rgb, hex, hcl
🛒 Commerce - commerce department, product name, sku, price
🏢 Company - company name, type, industry, catch phrase, buzz phrase
💾 Database - column names, column types, database engines
ℹ️ Datatype - booleans
📅 Date - past, future dates
🏦 Finance - currency, IBAN, BIC, account name, account number, pin, credit card numbers
📁 Git - branch names, commit messages, commit hash
👨‍💻 Hacker - hacker words
✋ Helper - random element from container
🌐 Internet - emails, usernames, passwords, IP, HTTP
🖼️ Image - images urls, github avatar urls, image dimensions
🌍 Location - countries, cities, zip codes, street addresses
📚 Lorem - lorem words, sentences, paragraphs
🏥 Medicine - conditions, medical tests, specialties
🎥 Movie - actors, actresses, genres, movie titles
🎶 Music - artists, song names, genres
🔢 Number - random integers, floating point numbers
🧑 Person - first, last names, job titles, hobby, genders, sex, nationalitiy, language
📞 Phone - phone number, IMEI
⚽ Sport - sport names, athletes, events
🔢 String - uuids, alphanumeric, numeric, hexadecimal
💻 System - file paths, file extensions, file names, directories, semantic version
🎮 Video game - title, genre, platform, studio
🌤️ Weather - temperature, pressure, humidity, weather description
💬 Word - sample words, nouns, verbs

📖 Documentation

https://cieslarmichal.github.io/faker-cxx/

✨ Contributing

Feel free to join Faker C++ development! 🚀

Please check CONTRIBUTING guide.

Discord Channel for contributors.

🔨 Building from sources with Clang 16

1. Install Clang 16

sudo add-apt-repository ppa:trebelnik-stefina/launchpad-getkeys \
&& sudo apt-get update \
&& sudo apt-get install launchpad-getkeys \
&& sudo add-apt-repository 'deb http://apt.llvm.org/jammy/ llvm-toolchain-jammy-16 main' \
&& sudo launchpad-getkeys \
&& sudo apt-get update -y \
&& sudo apt-get install -y lld-16 ninja-build  build-essential libstdc++-13-dev \
 clang-16 clang-tools-16 llvm-16 lcov

2. Prepare build directory

git clone https://github.com/cieslarmichal/faker-cxx.git
cd faker-cxx
git submodule update --init --recursive
mkdir build
cd build

3. CMake setup with Clang 16

cmake .. -DCMAKE_CXX_COMPILER=/usr/bin/clang++-16

4. Build

make

Goutham-AR/faker-cxx