{"id":13533799,"url":"https://github.com/cieslarmichal/faker-cxx","last_synced_at":"2026-02-04T19:02:22.020Z","repository":{"id":178369405,"uuid":"658110641","full_name":"cieslarmichal/faker-cxx","owner":"cieslarmichal","description":"C++ Faker library for generating fake (but realistic) data.","archived":false,"fork":false,"pushed_at":"2026-01-26T19:25:03.000Z","size":25739,"stargazers_count":412,"open_issues_count":24,"forks_count":184,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-01-27T07:07:40.372Z","etag":null,"topics":["cpp","cpp20","data-generation","fake","fake-data","faker"],"latest_commit_sha":null,"homepage":"https://cieslarmichal.github.io/faker-cxx/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cieslarmichal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["cieslarmichal"]}},"created_at":"2023-06-24T19:56:47.000Z","updated_at":"2026-01-26T19:25:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"2db5b8a8-88ff-4e9c-be44-2f53145b7788","html_url":"https://github.com/cieslarmichal/faker-cxx","commit_stats":null,"previous_names":["cieslarmichal/faker-cxx"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/cieslarmichal/faker-cxx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cieslarmichal%2Ffaker-cxx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cieslarmichal%2Ffaker-cxx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cieslarmichal%2Ffaker-cxx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cieslarmichal%2Ffaker-cxx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cieslarmichal","download_url":"https://codeload.github.com/cieslarmichal/faker-cxx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cieslarmichal%2Ffaker-cxx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29092985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","cpp20","data-generation","fake","fake-data","faker"],"created_at":"2024-08-01T07:01:23.223Z","updated_at":"2026-02-04T19:02:22.012Z","avatar_url":"https://github.com/cieslarmichal.png","language":"C++","funding_links":["https://github.com/sponsors/cieslarmichal"],"categories":["Miscellaneous","C++","Languages","Libraries"],"sub_categories":["C++"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/cieslarmichal/faker-cxx/main/docs/public/logo.png\" width=\"250\" alt=\"C++ Faker, a powerful tool for generating realistic and randomized fake data in C++ programming, enhancing data testing and development workflows\"/\u003e\n  \u003ch1\u003eFaker C++\u003c/h1\u003e\n\n[![clang++](https://github.com/cieslarmichal/faker-cxx/actions/workflows/linux-clang-build.yml/badge.svg?branch=main)](https://github.com/cieslarmichal/faker-cxx/actions/workflows/linux-clang-build.yml?query=branch%3Amain)\n[![apple clang++](https://github.com/cieslarmichal/faker-cxx/actions/workflows/macos-clang-build.yml/badge.svg?branch=main)](https://github.com/cieslarmichal/faker-cxx/actions/workflows/macos-clang-build.yml?query=branch%3Amain)\n[![g++](https://github.com/cieslarmichal/faker-cxx/actions/workflows/linux-gxx-build.yml/badge.svg?branch=main)](https://github.com/cieslarmichal/faker-cxx/actions/workflows/linux-gxx-build.yml?query=branch%3Amain)\n[![msvc](https://github.com/cieslarmichal/faker-cxx/actions/workflows/windows-msvc-build.yml/badge.svg?branch=main)](https://github.com/cieslarmichal/faker-cxx/actions/workflows/windows-msvc-build.yml?query=branch%3Amain)\n[![bazel](https://github.com/cieslarmichal/faker-cxx/actions/workflows/linux-bazel-build.yml/badge.svg?branch=main)](https://github.com/cieslarmichal/faker-cxx/actions/workflows/linux-bazel-build.yml?query=branch%3Amain)\n[![codecov](https://codecov.io/github/cieslarmichal/faker-cxx/branch/main/graph/badge.svg?token=0RTV4JFH2U)](https://codecov.io/github/cieslarmichal/faker-cxx)\n[![Conan Center](https://img.shields.io/conan/v/faker-cxx)](https://conan.io/center/recipes/faker-cxx)\n[![vcpkg](https://img.shields.io/vcpkg/v/faker-cxx)](https://vcpkg.link/ports/faker-cxx)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n[![Chat on Discord](https://img.shields.io/badge/chat-discord-blue?style=flat\u0026logo=discord)](https://discord.gg/h2ur8H6mK6)\n\u003c/div\u003e\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [⚡ Quick Start](#-quick-start)\n- [Key Features](#key-features)\n- [📖 Usage and Documentation](#-usage-and-documentation)\n- [🎯 Common Use Cases](#-common-use-cases)\n- [💎 Modules](#-modules)\n- [📚 API Reference](#-api-reference)\n- [🌍 Supported Locales](#-supported-locales)\n- [Consuming the library with CMake](#consuming-the-library-with-cmake)\n- [Installing the library with vcpkg](#installing-the-library-with-vcpkg)\n- [⚒️ Compiler support](#️-compiler-support)\n- [Dependencies](#dependencies)\n- [📦 Building the library with Conan](#-building-the-library-with-conan)\n- [Installing the library with Conan](#installing-the-library-with-conan)\n- [Building the library with Bazel](#building-the-library-with-bazel)\n- [✨ Contributing](#-contributing)\n- [📘 Credits](#-credits)\n- [📝 Changelog](#-changelog)\n- [🔑 License](#-license)\n\n## Introduction\n\nFaker C++ is a C++ library inspired by the popular [Faker.js](https://github.com/faker-js/faker),\naimed at providing developers with a robust tool for generating fake (but realistic) data.\nWhether you're building test suites, populating databases, or creating demos, Faker C++ has got you covered.\n\n## ⚡ Quick Start\n\nWant to get started immediately? Check out our [**Quick Start Guide**](QUICK_START.md) for a 5-minute introduction!\n\n```cpp\n#include \u003ciostream\u003e\n#include \"faker-cxx/faker.h\"\n\nint main() {\n    std::cout \u003c\u003c faker::person::fullName() \u003c\u003c std::endl;      // \"Jennifer Martin\"\n    std::cout \u003c\u003c faker::internet::email() \u003c\u003c std::endl;        // \"martin.jennifer@gmail.com\"\n    std::cout \u003c\u003c faker::location::city() \u003c\u003c std::endl;         // \"Los Angeles\"\n    std::cout \u003c\u003c faker::string::uuidV4() \u003c\u003c std::endl;         // \"8e3a4f21-5c7b-4d9a-8f2e-1b9c7d6a5e3f\"\n    return 0;\n}\n```\n\n**👉 [Read the Quick Start Guide](QUICK_START.md)** for installation and more examples!\n\n## Key Features\n\n📚 Realistic Data Generation: Generate various types of data including names, addresses, emails, dates, and more.\n\n🛠 Modular Design: Choose from a wide range of modules like Internet, Location, String, Date, and more to generate\nspecific types of data.\n\n🚀 Easy Integration: Seamlessly integrate with CMake, and it supports major compilers like MSVC, GCC, Clang, and Apple\nClang.\n\n## 📖 Usage and Documentation\n\nTo properly use Faker C++ you must first consume the Faker library (see Consuming Library with CMake).\nOnce that is done, you need to include the proper [header](https://cieslarmichal.github.io/faker-cxx/files.html) file\ndepending on the module you wish to generate data from or use general include file `faker-cxx/faker.h`.\nAll the documentation can be found at [cieslarmichal.github.io/faker-cxx](https://cieslarmichal.github.io/faker-cxx/).\n\nBelow is an example of how to use Faker C++ in your code.\n\n```cpp\n#include \u003ciostream\u003e\n\n#include \"faker-cxx/faker.h\" // or include specific module\n\nint main()\n{\n    const auto id = faker::string::uuidV4();\n    const auto email = faker::internet::email();\n    const auto password = faker::internet::password();\n    const auto city = faker::location::city();\n    const auto streetAddress = faker::location::streetAddress();\n    const auto bornDate = faker::date::birthdateByYear(1970, 2000);\n\n    std::cout \u003c\u003c id \u003c\u003c std::endl; // 59990db5-3a5f-40bf-8af0-7834c29ee884\n    std::cout \u003c\u003c email \u003c\u003c std::endl; // hills.rita@gmail.com\n    std::cout \u003c\u003c password \u003c\u003c std::endl; // Mf+*[(_'lHfM.$v{\n    std::cout \u003c\u003c city \u003c\u003c std::endl; // Rochester\n    std::cout \u003c\u003c streetAddress \u003c\u003c std::endl; // 643 Ricardo Creek\n    std::cout \u003c\u003c bornDate \u003c\u003c std::endl; // 1973-12-03T11:07:02Z\n\n    return 0;\n}\n```\n\n## 🎯 Common Use Cases\n\n### Generate Test Data for Databases\n\n```cpp\n#include \"faker-cxx/faker.h\"\n\nstruct User {\n    std::string id = faker::string::uuidV4();\n    std::string name = faker::person::fullName();\n    std::string email = faker::internet::email();\n    std::string address = faker::location::streetAddress();\n    std::string city = faker::location::city();\n    std::string zipCode = faker::location::zipCode();\n    std::string phone = faker::phone::number();\n    std::string birthdate = faker::date::birthdateByYear(1970, 2005);\n};\n```\n\n### Mock API Responses\n\n```cpp\nstruct Product {\n    std::string id = faker::string::uuidV4();\n    std::string name = faker::commerce::productFullName();\n    std::string price = faker::finance::amount(10, 1000, faker::Precision::TwoDp, \"$\");\n    std::string sku = faker::commerce::sku();\n    std::string category = faker::commerce::productCategory();\n};\n```\n\n### Generate Lorem Ipsum Content\n\n```cpp\nstd::string blogTitle = faker::lorem::words(5);             // Blog post title\nstd::string author = faker::person::fullName();             // Author name  \nstd::string content = faker::lorem::paragraphs(3);          // Article content\nstd::string summary = faker::lorem::sentence();             // Brief summary\n```\n\n### Create Unique Identifiers\n\n```cpp\nauto uuid = faker::string::uuidV4();          // \"8e3a4f21-5c7b-4d9a-8f2e-1b9c7d6a5e3f\"\nauto ulid = faker::string::ulid();            // \"01ARZ3NDEKTSV4RRFFQ69G5FAV\"\nauto nanoid = faker::string::nanoId();        // \"V1StGXR8_Z5jdHi6B-myT\"\n```\n\n### Generate Financial Data\n\n```cpp\nstd::string iban = faker::finance::iban();                  // \"DE89370400440532013000\"\nstd::string creditCard = faker::finance::creditCardNumber(); // \"4532-1488-0343-6467\"\nstd::string amount = faker::finance::amount(100, 10000, faker::Precision::TwoDp, \"€\");\n```\n\n### Localized Data Generation\n\n```cpp\n// Generate Polish names\nauto plName = faker::person::firstName(faker::Locale::pl_PL);  // \"Krystyna\"\n\n// Generate French addresses\nauto frCity = faker::location::city(faker::Locale::fr_FR);     // \"Lyon\"\n\n// Generate German IBAN\nauto deIban = faker::finance::iban(faker::Locale::de_DE);      // \"DE89370400440532013000\"\n```\n\n## 💎 Modules\n\n- 🛩 Airline - aircraft, airlines, airports, flight numbers\n- 🐼 Animal - species by type (bear, bird, cat, dog, etc.)\n- 📖 Book - title, genre, author, publisher\n- 🎨 Color - name, rgb, hex, hsl, lch, cmyk\n- 🛒 Commerce - products, prices, SKU, EAN, ISBN\n- 🏢 Company - name, type, industry, buzzwords\n- 🖥️ Computer - type, manufacturer, CPU, GPU\n- 🔐 Crypto - SHA, MD5 hashes\n- 💾 Database - column names, types, engines\n- ℹ️ Datatype - booleans\n- 📅 Date - past/future dates, birthdays, weekdays\n- 🕹️ E-sport - players, teams, leagues\n- 🎓 Education - schools, degrees, fields of study\n- 🏦 Finance - currency, IBAN, BIC, credit cards\n- 🍝 Food - dishes, ingredients, beverages\n- 📁 Git - branch, commit, SHA\n- 👨‍💻 Hacker - abbreviations, phrases\n- 🖼️ Image - URLs, dimensions, types\n- 🌐 Internet - email, username, password, IP, URL\n- 🌍 Location - country, city, address, coordinates, MGRS grid\n- 📚 Lorem - words, sentences, paragraphs\n- 🏥 Medicine - conditions, tests, specialties\n- 🎥 Movie - titles, genres, actors, directors\n- 🎶 Music - artists, songs, genres\n- 🔢 Number - integers, decimals, hex, binary\n- 🧑 Person - names, titles, bio, SSN\n- 📞 Phone - numbers, IMEI\n- 🪴 Plant - trees, flowers\n- 🧑‍🔬 Science - chemical elements, units\n- ⚽ Sport - sports, teams, athletes\n- 🔢 String - UUID, ULID, Nano ID, alphanumeric\n- 💻 System - file names, paths, MIME types\n- 🚗 Vehicle - manufacturer, model, VIN\n- 🎞️ Video - formats, codecs, resolutions\n- 🎮 Video game - titles, genres, platforms\n- 🌤️ Weather - descriptions\n- 💬 Word - adjectives, nouns, verbs\n\n## 📚 API Reference\n\nUse **Ctrl+F** (Cmd+F on Mac) to search for specific functions!\n\n\u003e 💡 For detailed docs with parameters and options, see [cieslarmichal.github.io/faker-cxx](https://cieslarmichal.github.io/faker-cxx/)\n\n### 🛩️ Airline Module\n\n```cpp\nfaker::airline::aircraftType()           // \"narrowbody\"\nfaker::airline::airplane()               // {name: \"Boeing 737\", iataTypeCode: \"737\"}\nfaker::airline::airline()                // {name: \"American Airlines\", iataCode: \"AA\"}\nfaker::airline::airport()                // {name: \"Los Angeles International Airport\", iataCode: \"LAX\"}\nfaker::airline::seat(aircraftType)       // \"1A\"\nfaker::airline::recordLocator()          // \"ABCDEF\"\nfaker::airline::recordLocator(true)      // \"ABC123\"\nfaker::airline::flightNumber()           // \"1234\"\nfaker::airline::flightNumber(true)       // \"0123\"\nfaker::airline::flightNumberByRange()    // \"234\"\n```\n\n### 🐼 Animal Module\n\n```cpp\nfaker::animal::bear()                    // \"Grizzly bear\"\nfaker::animal::bird()                    // \"Eagle\"\nfaker::animal::cat()                     // \"Siamese\"\nfaker::animal::cetacean()                // \"Dolphin\"\nfaker::animal::cow()                     // \"Holstein\"\nfaker::animal::crocodile()               // \"Nile crocodile\"\nfaker::animal::dog()                     // \"Golden Retriever\"\nfaker::animal::fish()                    // \"Salmon\"\nfaker::animal::horse()                   // \"Arabian\"\nfaker::animal::insect()                  // \"Butterfly\"\nfaker::animal::lion()                    // \"African Lion\"\nfaker::animal::rabbit()                  // \"Angora\"\nfaker::animal::rodent()                  // \"Hamster\"\nfaker::animal::snake()                   // \"Python\"\nfaker::animal::type()                    // \"mammal\"\n```\n\n### 📖 Book Module\n\n```cpp\nfaker::book::title()                     // \"The Great Gatsby\"\nfaker::book::genre()                     // \"Science Fiction\"\nfaker::book::author()                    // \"George Orwell\"\nfaker::book::publisher()                 // \"Penguin Books\"\nfaker::book::format()                    // \"Hardcover\"\nfaker::book::series()                    // \"Harry Potter\"\n```\n\n### 🎨 Color Module\n\n```cpp\nfaker::color::name()                     // \"Red\"\nfaker::color::rgb()                      // \"rgb(255, 0, 0)\"\nfaker::color::hex()                      // \"#FF0000\"\nfaker::color::hsl()                      // \"hsl(0, 100%, 50%)\"\nfaker::color::lch()                      // \"lch(53.24, 104.55, 40)\"\nfaker::color::cmyk()                     // \"cmyk(0, 100, 100, 0)\"\nfaker::color::lab()                      // \"lab(53.24, 80.09, 67.20)\"\nfaker::color::hsb()                      // \"hsb(0, 100%, 100%)\"\nfaker::color::hsv()                      // \"hsv(0, 100%, 100%)\"\nfaker::color::hwb()                      // \"hwb(0, 0%, 0%)\"\nfaker::color::yuv()                      // \"yuv(127, 0, 0)\"\nfaker::color::space()                    // \"sRGB\"\n```\n\n### 🛒 Commerce Module\n\n```cpp\nfaker::commerce::department()            // \"Electronics\"\nfaker::commerce::sku()                   // \"ABC-12345\"\nfaker::commerce::productAdjective()      // \"Awesome\"\nfaker::commerce::productMaterial()       // \"Cotton\"\nfaker::commerce::productName()           // \"Shirt\"\nfaker::commerce::productFullName()       // \"Awesome Cotton Shirt\"\nfaker::commerce::EAN13()                 // \"1234567890123\"\nfaker::commerce::EAN8()                  // \"12345678\"\nfaker::commerce::ISBN13()                // \"978-1-234-56789-0\"\nfaker::commerce::ISBN10()                // \"1-234-56789-0\"\nfaker::commerce::paymentType()           // \"Credit Card\"\nfaker::commerce::paymentProvider()       // \"Visa\"\nfaker::commerce::productDescription()    // \"Ergonomic and stylish!\"\nfaker::commerce::productCategory()       // \"Clothing\"\nfaker::commerce::productReview()         // \"Great product!\"\nfaker::commerce::discountType()          // \"Percentage\"\nfaker::commerce::orderStatus()           // \"Shipped\"\nfaker::commerce::shippingCarrier()       // \"FedEx\"\n```\n\n### 🏢 Company Module\n\n```cpp\nfaker::company::companyName()            // \"Peterson Inc\"\nfaker::company::type()                   // \"LLC\"\nfaker::company::industry()               // \"Technology\"\nfaker::company::buzzPhrase()             // \"innovate cutting-edge systems\"\nfaker::company::buzzAdjective()          // \"innovative\"\nfaker::company::buzzNoun()               // \"synergy\"\nfaker::company::buzzVerb()               // \"implement\"\nfaker::company::catchPhrase()            // \"Quality-focused scalable initiative\"\nfaker::company::catchPhraseAdjective()   // \"Quality-focused\"\nfaker::company::catchPhraseDescriptor()  // \"scalable\"\nfaker::company::catchPhraseNoun()        // \"initiative\"\n```\n\n### 🖥️ Computer Module\n\n```cpp\nfaker::computer::type()                  // \"laptop\"\nfaker::computer::manufacture()           // \"Dell\"\nfaker::computer::model()                 // \"XPS 15\"\nfaker::computer::cpuManufacture()        // \"Intel\"\nfaker::computer::cpuType()               // \"x64\"\nfaker::computer::cpuModel()              // \"Core i7-9700K\"\nfaker::computer::gpuManufacture()        // \"NVIDIA\"\nfaker::computer::gpuType()               // \"Integrated\"\nfaker::computer::gpuModel()              // \"GeForce GTX 1080\"\n```\n\n### 🔐 Crypto Module\n\n```cpp\nfaker::crypto::sha256()                  // \"a3c4f...(64 chars)\"\nfaker::crypto::sha1()                    // \"4e9d8...(40 chars)\"\nfaker::crypto::md5()                     // \"9b3e4...(32 chars)\"\n```\n\n### 💾 Database Module\n\n```cpp\nfaker::database::columnName()            // \"id\"\nfaker::database::columnType()            // \"INT\"\nfaker::database::collation()             // \"utf8_unicode_ci\"\nfaker::database::engine()                // \"InnoDB\"\nfaker::database::mongoDbObjectId()       // \"507f1f77bcf86cd799439011\"\n```\n\n### ℹ️ Datatype Module\n\n```cpp\nfaker::datatype::boolean()               // true or false\nfaker::datatype::boolean(0.7)            // 70% chance of true\n```\n\n### 📅 Date Module\n\n```cpp\nfaker::date::anytime()                   // \"2023-07-15T14:30:00Z\"\nfaker::date::pastDate()                  // \"2022-03-12T08:15:00Z\"\nfaker::date::futureDate()                // \"2024-11-20T19:45:00Z\"\nfaker::date::recentDate()                // \"2023-07-13T10:20:00Z\"\nfaker::date::soonDate()                  // \"2023-07-17T16:00:00Z\"\nfaker::date::birthdateByAge(18, 65)      // \"1988-05-23T00:00:00Z\"\nfaker::date::birthdateByYear(1990, 2000) // \"1995-08-15T00:00:00Z\"\nfaker::date::weekdayName()               // \"Monday\"\nfaker::date::weekdayAbbreviatedName()    // \"Mon\"\nfaker::date::monthName()                 // \"January\"\nfaker::date::monthAbbreviatedName()      // \"Jan\"\nfaker::date::year()                      // 2000\nfaker::date::month()                     // 9\nfaker::date::hour()                      // 21\nfaker::date::minute()                    // 40\nfaker::date::second()                    // 40\nfaker::date::time()                      // \"21:40\"\nfaker::date::dayOfMonth()                // 15\nfaker::date::dayOfWeek()                 // 5\nfaker::date::timezoneRandom()            // \"America/New_York\"\nfaker::date::between(from, to)           // Random date between two timestamps\n```\n\n### 🎓 Education Module\n\n```cpp\nfaker::education::school()               // \"Harvard University\"\nfaker::education::degree()               // \"Bachelor of Science\"\nfaker::education::field()                // \"Computer Science\"\nfaker::education::term()                 // \"Fall Semester\"\nfaker::education::courses()              // \"Data Structures\"\n```\n\n### 🕹️ Esport Module\n\n```cpp\nfaker::esport::player()                  // \"Ninja\"\nfaker::esport::team()                    // \"Team Liquid\"\nfaker::esport::league()                  // \"League of Legends Championship Series\"\nfaker::esport::event()                   // \"The International\"\nfaker::esport::game()                    // \"Dota 2\"\nfaker::esport::organizer()               // \"ESL\"\n```\n\n### 🏦 Finance Module\n\n```cpp\nfaker::finance::currency()               // {name: \"US Dollar\", code: \"USD\", symbol: \"$\"}\nfaker::finance::currencyName()           // \"US Dollar\"\nfaker::finance::currencyCode()           // \"USD\"\nfaker::finance::currencySymbol()         // \"$\"\nfaker::finance::accountType()            // \"Savings\"\nfaker::finance::amount()                 // \"720.18\"\nfaker::finance::iban()                   // \"DE89370400440532013000\"\nfaker::finance::bic()                    // \"DEUTDEFF\"\nfaker::finance::accountNumber()          // \"12345678\"\nfaker::finance::pin()                    // \"1234\"\nfaker::finance::routingNumber()          // \"123456789\"\nfaker::finance::creditCardNumber()       // \"4532-1488-0343-6467\"\nfaker::finance::creditCardCvv()          // \"123\"\nfaker::finance::bitcoinAddress()         // \"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa\"\nfaker::finance::litecoinAddress()        // \"LU2q3eNKx6rmFGp3uCX8EwvY7qhxBn2pLf\"\nfaker::finance::ethereumAddress()        // \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\"\nfaker::finance::creditCardExpirationDate() // \"03/25\"\nfaker::finance::creditCardType()         // \"Visa\"\n```\n\n### 🍝 Food Module\n\n```cpp\nfaker::food::alcoholicBeverage()         // \"Beer\"\nfaker::food::grain()                     // \"Rice\"\nfaker::food::milkProduct()               // \"Cheese\"\nfaker::food::fruit()                     // \"Apple\"\nfaker::food::meat()                      // \"Chicken\"\nfaker::food::seafood()                   // \"Salmon\"\nfaker::food::vegetable()                 // \"Carrot\"\nfaker::food::oil()                       // \"Olive Oil\"\nfaker::food::nut()                       // \"Almond\"\nfaker::food::seed()                      // \"Sunflower Seed\"\nfaker::food::sugarProduct()              // \"Sugar\"\nfaker::food::nonalcoholicBeverage()      // \"Coffee\"\nfaker::food::dishName()                  // \"Spaghetti Carbonara\"\nfaker::food::foodCategory()              // \"Italian\"\n```\n\n### 📁 Git Module\n\n```cpp\nfaker::git::branch()                     // \"feature/add-login\"\nfaker::git::commitDate()                 // \"Mon Nov 12 14:32:49 2018 -0500\"\nfaker::git::commitEntry()                // \"commit 4e9d8c7... Author: John Doe...\"\nfaker::git::commitMessage()              // \"Fix bug in login form\"\nfaker::git::commitSha()                  // \"4e9d8c7a6f3b2e1d0c9b8a7f6e5d4c3b2a1\"\n```\n\n### 👨‍💻 Hacker Module\n\n```cpp\nfaker::hacker::abbreviation()            // \"HTTP\"\nfaker::hacker::adjective()               // \"cross-platform\"\nfaker::hacker::noun()                    // \"protocol\"\nfaker::hacker::verb()                    // \"parse\"\nfaker::hacker::ingverb()                 // \"parsing\"\nfaker::hacker::phrase()                  // \"Try to parse the HTTP protocol!\"\n```\n\n### 🖼️ Image Module\n\n```cpp\nfaker::image::imageUrl()                 // \"https://loremflickr.com/640/480\"\nfaker::image::urlLoremFlickr()           // \"https://loremflickr.com/640/480\"\nfaker::image::urlPicsumPhotos()          // \"https://picsum.photos/640/480\"\nfaker::image::githubAvatarUrl()          // \"https://avatars.githubusercontent.com/u/9716558\"\nfaker::image::dimensions()               // \"1920x1080\"\nfaker::image::type()                     // \"png\"\nfaker::image::dataUri()                  // \"data:image/svg+xml;charset=UTF-8,...\"\n```\n\n### 🌐 Internet Module\n\n```cpp\nfaker::internet::username()              // \"Richardson.Jeffrey1997\"\nfaker::internet::email()                 // \"Jimenez.Clyde@gmail.com\"\nfaker::internet::exampleEmail()          // \"Jimenez.Clyde@example.com\"\nfaker::internet::password()              // \"gXGpe9pKfFcKy9R\"\nfaker::internet::emoji()                 // \"👑\"\nfaker::internet::checkIfEmojiIsValid(\"👑\") // true\nfaker::internet::protocol()              // \"https\"\nfaker::internet::httpMethod()            // \"POST\"\nfaker::internet::httpStatusCode()        // 200\nfaker::internet::httpRequestHeader()     // \"Content-Type\"\nfaker::internet::httpResponseHeader()    // \"Cache-Control\"\nfaker::internet::httpMediaType()         // \"application/json\"\nfaker::internet::ipv4()                  // \"192.168.1.1\"\nfaker::internet::ipv6()                  // \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"\nfaker::internet::mac()                   // \"00:1B:44:11:3A:B7\"\nfaker::internet::port()                  // 8080\nfaker::internet::url()                   // \"https://example.com\"\nfaker::internet::domainName()            // \"example.com\"\nfaker::internet::domainSuffix()          // \"com\"\nfaker::internet::domainWord()            // \"example\"\nfaker::internet::anonymousUsername(15)   // \"profusebrother\"\nfaker::internet::jwtToken()           // \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\nfaker::internet::jwtAlgorithm()       // \"HS256\"\n```\n\n### 🌍 Location Module\n\n```cpp\nfaker::location::country()               // \"United States\"\nfaker::location::continent()             // \"North America\"\nfaker::location::countryCode()           // \"US\"\nfaker::location::state()                 // \"California\"\nfaker::location::city()                  // \"Los Angeles\"\nfaker::location::zipCode()               // \"90210\"\nfaker::location::streetAddress()         // \"123 Main St\"\nfaker::location::street()                // \"Main St\"\nfaker::location::buildingNumber()        // \"123\"\nfaker::location::secondaryAddress()      // \"Apt. 4\"\nfaker::location::latitude()              // \"34.052235\"\nfaker::location::longitude()             // \"-118.243683\"\nfaker::location::nearbyGPSCoordinate()   // {\"48.8566\", \"2.3522\"}\nfaker::location::direction()             // \"North\"\nfaker::location::ordinalDirection()      // \"Southeast\"\nfaker::location::timeZone()              // \"America/Los_Angeles\"\nfaker::location::mgrs()                  // \"17SMD92712525\"\n```\n\n### 📚 Lorem Module\n\n```cpp\nfaker::lorem::word()                     // \"temporibus\"\nfaker::lorem::words()                    // \"qui praesentium pariatur\"\nfaker::lorem::wordVector(3)              // {\"temporibus\", \"ipsum\", \"alias\"}\nfaker::lorem::sentence()                 // \"Laborum voluptatem officiis est et.\"\nfaker::lorem::sentences()                // \"Two sentences here. And another one.\"\nfaker::lorem::slug()                     // \"hello-world-test\"\nfaker::lorem::paragraph()                // \"Long paragraph with multiple sentences...\"\nfaker::lorem::paragraphs()               // \"Multiple paragraphs...\"\n```\n\n### 🏥 Medicine Module\n\n```cpp\nfaker::medicine::condition()             // \"Diabetes\"\nfaker::medicine::medicalTest()           // \"Blood Test\"\nfaker::medicine::specialty()             // \"Cardiology\"\n```\n\n### 🎥 Movie Module\n\n```cpp\nfaker::movie::genre()                    // \"Action\"\nfaker::movie::movieTitle()               // \"The Matrix\"\nfaker::movie::tvShow()                   // \"Breaking Bad\"\nfaker::movie::director()                 // \"Steven Spielberg\"\nfaker::movie::actor()                    // \"Tom Hanks\"\nfaker::movie::actress()                  // \"Meryl Streep\"\n```\n\n### 🎶 Music Module\n\n```cpp\nfaker::music::artist()                   // \"The Beatles\"\nfaker::music::songName()                 // \"Yesterday\"\nfaker::music::genre()                    // \"Rock\"\n```\n\n### 🔢 Number Module\n\n```cpp\nfaker::number::integer(1, 100)           // 42\nfaker::number::integer(100)              // 57 (0 to max)\nfaker::number::decimal(0.0, 1.0)         // 0.573\nfaker::number::decimal(10.0)             // 5.7 (0 to max)\nfaker::number::normalDistribution(10, 3) // 12.374\nfaker::number::hexadecimal(8)            // \"0xae13d044cb\"\nfaker::number::octal(8)                  // \"0o52561721\"\nfaker::number::binary(8)                 // \"0b01110101\"\nfaker::number::binary(0, 1024)           // \"0b10110\" (range)\nfaker::number::roman(1, 100)             // \"XLII\"\n```\n\n### 🧑 Person Module\n\n```cpp\nfaker::person::firstName()               // \"Michael\"\nfaker::person::lastName()                // \"Smith\"\nfaker::person::fullName()                // \"Michael Smith\"\nfaker::person::prefix()                  // \"Mr.\"\nfaker::person::suffix()                  // \"Jr.\"\nfaker::person::bio()                     // \"Software engineer passionate about...\"\nfaker::person::sex()                     // Sex::Male\nfaker::person::gender()                  // \"Male\"\nfaker::person::jobTitle()                // \"Software Engineer\"\nfaker::person::jobDescriptor()           // \"Senior\"\nfaker::person::jobArea()                 // \"IT\"\nfaker::person::jobType()                 // \"Developer\"\nfaker::person::hobby()                   // \"Reading\"\nfaker::person::language()                // \"English\"\nfaker::person::nationality()             // \"American\"\nfaker::person::ssn()                     // \"123-45-6789\"\nfaker::person::westernZodiac()           // \"Aries\"\nfaker::person::chineseZodiac()           // \"Dragon\"\nfaker::person::passport()                // \"A12345678\"\n```\n\n### 📞 Phone Module\n\n```cpp\nfaker::phone::phoneNumberByFormat()      // \"961-770-7727\"\nfaker::phone::phoneNumberByFormat(\"501-###-###\") // \"501-039-841\"\nfaker::phone::phoneNumberByCountry()     // \"234-532-654\"\nfaker::phone::platform()                 // \"iOS\"\nfaker::phone::modelName()                // \"Samsung Galaxy S22\"\nfaker::phone::manufacturer()             // \"Apple\"\nfaker::phone::imei()                     // \"13-850175-913761-7\"\nfaker::phone::areaCode()                 // \"+1\"\n```\n\n### 🪴 Plant Module\n\n```cpp\nfaker::plant::tree()                     // \"Oak\"\nfaker::plant::flower()                   // \"Rose\"\nfaker::plant::shrub()                    // \"Azalea\"\nfaker::plant::grass()                    // \"Kentucky Bluegrass\"\nfaker::plant::fern()                     // \"Maidenhair\"\nfaker::plant::succulent()                // \"Aloe Vera\"\nfaker::plant::vine()                     // \"Ivy\"\nfaker::plant::plantType()                // \"tree\"\n```\n\n### 🧑‍🔬 Science Module\n\n```cpp\nfaker::science::chemicalElement()        // {name: \"Hydrogen\", symbol: \"H\", atomicNumber: 1}\nfaker::science::unit()                   // {name: \"meter\", symbol: \"m\", usedToMeasure: \"length\"}\nfaker::science::distanceUnit()           // {name: \"meter\", symbol: \"m\", usedToMeasure: \"length\"}\nfaker::science::timeUnit()               // {name: \"second\", symbol: \"s\", usedToMeasure: \"time\"}\nfaker::science::massUnit()               // {name: \"gram\", symbol: \"g\", usedToMeasure: \"mass\"}\nfaker::science::tempUnit()               // {name: \"celsius\", symbol: \"°C\", usedToMeasure: \"temperature\"}\nfaker::science::currentUnit()            // {name: \"ampere\", symbol: \"A\", usedToMeasure: \"current\"}\n```\n\n### ⚽ Sport Module\n\n```cpp\nfaker::sport::sportName()                // \"Football\"\nfaker::sport::soccerTeam()               // \"Manchester United\"\nfaker::sport::maleAthlete()              // \"Cristiano Ronaldo\"\nfaker::sport::femaleAthlete()            // \"Serena Williams\"\nfaker::sport::sportEvent()               // \"Super Bowl\"\n```\n\n### 🔢 String Module\n\n```cpp\nfaker::string::uuidV1()                  // \"29915d84-c5e8-11ef-9cd2-0242ac120002\"\nfaker::string::uuidV3()                  // \"c6437ef1-5b86-3a4e-a071-c2d4ad414e65\"\nfaker::string::uuidV4()                  // \"78754621-9544-4c79-9c1d-76d3ba881f53\"\nfaker::string::uuidV5(\"hello\")           // \"6c7f25c1-1f94-53df-aab6-627ed664b1a7\"\nfaker::string::uuidV6()                  // \"1efc5e90-f32e-6420-bab1-7bdb35fa2abb\"\nfaker::string::uuidV7()                  // \"0194129b-f344-783c-ab87-d1a79bcf9a4e\"\nfaker::string::ulid()                    // \"0001C7STHC0G2081040G208104\"\nfaker::string::sample(10)                // \"Zo!.:*e\u003ewR\"\nfaker::string::symbol(5)                 // \"#$%^\u0026\"\nfaker::string::fromCharacters(\"abc\", 5)  // \"abcab\"\nfaker::string::alpha(10)                 // \"aBcDeFgHiJ\"\nfaker::string::alphanumeric(10)          // \"aB3cD5eF7g\"\nfaker::string::numeric(10)               // \"1234567890\"\nfaker::string::nanoId()                  // \"Hf5lN8L2wQ\"\nfaker::string::nanoId(21)                // \"V2JlO7GZ1kPl9FxErRqzS\"\nfaker::string::isValidGuarantee(...)     // true/false\nfaker::string::generateAtLeastString(...)// \"000aaaaaa\"\n```\n\n### 💻 System Module\n\n```cpp\nfaker::system::fileName()                // \"injustice.mpeg\"\nfaker::system::fileExtension()           // \"pdf\"\nfaker::system::commonFileName()          // \"dollar.jpg\"\nfaker::system::commonFileExtension()     // \"gif\"\nfaker::system::mimeType()                // \"video/vnd.vivo\"\nfaker::system::fileType()                // \"audio\"\nfaker::system::directoryPath()           // \"/etc/mail\"\nfaker::system::filePath()                // \"/usr/local/src/money.dotx\"\nfaker::system::semver()                  // \"1.1.2\"\nfaker::system::networkInterface()        // \"enp2s7f8\"\nfaker::system::cron()                    // \"22 * ? * ?\"\n```\n\n### 🚗 Vehicle Module\n\n```cpp\nfaker::vehicle::bicycle()                // \"Mountain Bike\"\nfaker::vehicle::color()                  // \"Red\"\nfaker::vehicle::fuel()                   // \"Gasoline\"\nfaker::vehicle::manufacturer()           // \"Toyota\"\nfaker::vehicle::model()                  // \"Camry\"\nfaker::vehicle::type()                   // \"Sedan\"\nfaker::vehicle::vehicleName()            // \"Toyota Camry\"\nfaker::vehicle::vin()                    // \"WBADT43452G918366\"\nfaker::vehicle::vrm()                    // \"AB12CDE\"\n```\n\n### 🎞️ Video Module\n\n```cpp\nfaker::video::formatName()               // \"MP4\"\nfaker::video::fileExtension()            // \"mp4\"\nfaker::video::videoCodec()               // \"H.264\"\nfaker::video::audioCodec()               // \"AAC\"\nfaker::video::resolution()               // \"1920x1080\"\nfaker::video::aspectRatio()              // \"16:9\"\nfaker::video::videoUrl()                 // \"https://youtube.com/watch?v=...\"\n```\n\n### 🎮 Video Game Module\n\n```cpp\nfaker::videogame::gameTitle()            // \"Minecraft\"\nfaker::videogame::genre()                // \"Action\"\nfaker::videogame::platform()             // \"PlayStation 5\"\nfaker::videogame::studioName()           // \"Mojang Studios\"\n```\n\n### 🌤️ Weather Module\n\n```cpp\nfaker::weather::weatherDescription()     // \"Partly cloudy\"\n```\n\n### 💬 Word Module\n\n```cpp\nfaker::word::sample()                    // \"protection\"\nfaker::word::sample(5)                   // \"spell\"\nfaker::word::words(3)                    // \"before hourly patiently\"\nfaker::word::adjective()                 // \"complete\"\nfaker::word::adjectiveLocale(5, locale)  // \"brave\" (with locale)\nfaker::word::adverb()                    // \"deliberately\"\nfaker::word::conjunction()               // \"because\"\nfaker::word::interjection()              // \"psst\"\nfaker::word::noun()                      // \"pudding\"\nfaker::word::preposition()               // \"besides\"\nfaker::word::verb()                      // \"override\"\n```\n\n## 🌍 Supported Locales\n\n**40+ locales supported** including:\n\n`en_US` (default), `en_GB`, `pl_PL`, `de_DE`, `de_AT`, `de_CH`, `fr_FR`, `fr_BE`, `fr_CH`, `it_IT`, `es_ES`, `es_MX`, `pt_PT`, `pt_BR`, `ru_RU`, `uk_UA`, `cs_CZ`, `sk_SK`, `sv_SE`, `nb_NO`, `da_DK`, `fi_FI`, `nl_NL`, `nl_BE`, `tr_TR`, `ro_RO`, `hu_HU`, `hr_HR`, `sl_SI`, `sr_RS`, `bg_BG`, `el_GR`, `hi_IN`, `en_IN`, `zh_CN`, `zh_TW`, `ja_JP`, `ko_KR`\n\n**Usage:**\n\n```cpp\nfaker::person::firstName(faker::Locale::pl_PL);  // \"Krystyna\"\nfaker::location::city(faker::Locale::fr_FR);     // \"Lyon\"\n```\n\n## Consuming the library with CMake\n\n### With Git submodules and add_library\n\n1. Add faker to git submodules (execute in project root):\n\n    ```bash\n    mkdir externals \u0026\u0026 cd externals\n    git submodule add https://github.com/cieslarmichal/faker-cxx.git\n    git submodule update --init --recursive\n    ```\n\n2. Link with library:\n\n    ```cmake\n    set(FAKER_BUILD_TESTING OFF)\n\n    add_subdirectory(externals/faker-cxx)\n\n    add_executable(main Main.cpp)\n\n    target_link_libraries(main faker-cxx)\n    ```\n\n### With FetchContent\n\n```cmake\nset(FAKER_BUILD_TESTING OFF)\n\nFetchContent_Declare(faker\n    GIT_REPOSITORY https://github.com/cieslarmichal/faker-cxx.git\n    GIT_TAG main\n)\n\nFetchContent_MakeAvailable(faker)\n\nadd_executable(main Main.cpp)\n\ntarget_link_libraries(main faker-cxx)\n```\n\n## Installing the library with [vcpkg](https://vcpkg.io/)\n\nYou can install faker-cxx using the [vcpkg](https://vcpkg.io/) dependency manager:\n\n```bash\nvcpkg install faker-cxx\n```\n\nThe faker-cxx port in vcpkg is kept up to date by Microsoft team members and community contributors.\nIf the version is out of date, please [create an issue or pull request](https://github.com/microsoft/vcpkg) on the vcpkg repository.\n\nThen in your CMakeLists.txt:\n\n```cmake\nfind_package(faker-cxx CONFIG REQUIRED)\n\nadd_executable(main Main.cpp)\n\ntarget_link_libraries(main PRIVATE faker-cxx::faker-cxx)\n```\n\n## ⚒️ Compiler support\n\n- [MSVC➚](https://en.wikipedia.org/wiki/Microsoft_Visual_Studio) version 143 or newer.\n- [GCC➚](https://gcc.gnu.org/) version 13 or newer.\n- [Clang➚](https://clang.llvm.org/) version 16 or newer.\n- [Apple Clang➚](https://clang.llvm.org/) version 16 or newer.\n\n## Dependencies\n\n- GTest (set `FAKER_BUILD_TESTING=OFF` CMake flag to disable this dependency)\n\nIn order to use external dependencies installed in your system, you can set the `USE_SYSTEM_DEPENDENCIES` CMake flag\nto `ON`.\n\n## 📦 Building the library with [Conan](https://conan.io/)\n\nThe library can be built using Conan package manager to solve external dependencies.\nTo build the library with Conan, follow the steps below:\n\n1. Install required dependencies:\n\n    ```bash\n    conan install conanfile.txt --build=missing\n    ```\n\n2. Build the library:\n\n    ```bash\n    cmake --preset=conan-release -DUSE_SYSTEM_DEPENDENCIES:BOOL=ON\n    cmake --build --preset=conan-release\n    ```\n\n## Installing the library with [Conan](https://conan.io/)\n\nYou can install pre-built binaries for faker-cxx or build it from source using Conan. Use the following command:\n\n```bash\nconan install --requires=\"faker-cxx/[*]\" --build=missing\n```\n\nThe faker-cxx Conan recipe is kept up to date by Conan maintainers and community contributors.\nIf the version is out of date, please [create an issue or pull request](https://github.com/conan-io/conan-center-index)\non the ConanCenterIndex repository.\n\n## Building the library with [Bazel](https://bazel.build/)\n\nAs alternative, this project can be built using [Bazel](https://bazel.build/). The dependencies are managed directly by\nBazel modules, downloading and building all external dependencies. Follow the steps below to build the project:\n\n1. **Navigate to the project directory:**\n\n    ```sh\n    cd /path/to/faker-cxx\n    ```\n\n2. **Build the project:**\n\n    ```sh\n    bazel build //:faker-cxx\n    ```\n\n## ✨ Contributing\n\nWe would love it if you contributed to Faker C++! 🚀\n\nCheck our guides on how to build the project locally:\n\n- **[Complete Building Guide](./docs/guides/BUILDING.md)** - All compilers in one place\n  - [GCC](./docs/guides/BUILDING.md#gcc-linux)\n  - [Clang](./docs/guides/BUILDING.md#clang-linux)\n  - [Apple Clang](./docs/guides/BUILDING.md#apple-clang-macos)\n  - [MSVC](./docs/guides/BUILDING.md#msvc-windows)\n\nPlease make sure to read the [Contributing Guide](https://github.com/cieslarmichal/faker-cxx/blob/main/CONTRIBUTING.md)\nbefore making a pull request.\n\nAdditionally, we encourage you to join our [Discord Channel](https://discord.gg/h2ur8H6mK6) for contributors.\n\n## 📘 Credits\n\nThanks to all the people who already contributed to Faker!\n\n\u003ca href=\"https://github.com/cieslarmichal/faker-cxx/graphs/contributors\"\u003e\u003cimg src=\"https://opencollective.com/faker-cxx/contributors.svg?width=800\" alt=\"Contributors\" /\u003e\u003c/a\u003e\n\n## 📝 Changelog\n\nDetailed changes for each release are documented in the [release notes](CHANGELOG.md).\n\n## 🔑 License\n\nThis project is under [MIT](LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcieslarmichal%2Ffaker-cxx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcieslarmichal%2Ffaker-cxx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcieslarmichal%2Ffaker-cxx/lists"}