add name internalized formats

include/faker-cxx/Helper.h

@@ -1,6 +1,7 @@
 #pragma once
 
 #include <functional>
+#include <numeric>
 #include <span>
 #include <string>
 
@@ -9,6 +10,7 @@
 
 namespace faker
 {
+// TODO: Add error handling if data empty
 class Helper
 {
 public:
@@ -29,6 +31,11 @@ class Helper
     template <class T>
     static T arrayElement(std::span<const T> data)
     {
+        if (data.empty())
+        {
+            throw std::invalid_argument{"Data is empty."};
+        }
+
         const auto index = Number::integer<size_t>(data.size() - 1);
 
         return data[index];
@@ -37,11 +44,57 @@ class Helper
     template <class T>
     static T arrayElement(const std::vector<T>& data)
     {
+        if (data.empty())
+        {
+            throw std::invalid_argument{"Data is empty."};
+        }
+
         const auto index = Number::integer<size_t>(data.size() - 1);
 
         return data[index];
     }
 
+    template <class T>
+    struct WeightedElement
+    {
+        unsigned weight;
+        T value;
+    };
+
+    template <class T>
+    static T weightedArrayElement(const std::vector<WeightedElement<T>>& data)
+    {
+        if (data.empty())
+        {
+            throw std::invalid_argument{"Data is empty."};
+        }
+
+        const auto sumOfWeights =
+            std::accumulate(data.begin(), data.end(), 0u,
+                            [](size_t sum, const WeightedElement<T>& element) { return sum + element.weight; });
+
+        if (sumOfWeights == 0)
+        {
+            throw std::invalid_argument{"Sum of weights is zero."};
+        }
+
+        const std::integral auto targetWeightValue = Number::integer<unsigned>(sumOfWeights);
+
+        unsigned currentSum = 0;
+
+        for (const auto& element : data)
+        {
+            currentSum += element.weight;
+
+            if (targetWeightValue <= currentSum)
+            {
+                return element.value;
+            }
+        }
+
+        return data.at(data.size() - 1).value;
+    }
+
     /**
      * @brief Returns shuffled STL container.
      *

include/faker-cxx/Person.h

@@ -31,6 +31,7 @@ class Person
      * @brief Returns a random last name.
      *
      * @param language The local name language. Defaults to `Language::English`.
+     * @param sex The optional sex to use.
      *
      * @returns Last name starting with a capital letter.
      *
@@ -40,10 +41,24 @@ class Person
      */
     static std::string lastName(Language language = Language::English, std::optional<Sex> = std::nullopt);
 
+    /**
+     * @brief Returns a random middle name.
+     *
+     * @param sex The optional sex to use.
+     *
+     * @returns Middle name starting with a capital letter.
+     *
+     * @code
+     * Person::middleName() // "Васильевич"
+     * @endcode
+     */
+    static std::string middleName(std::optional<Sex> = std::nullopt);
+
     /**
      * @brief Returns a random full name.
      *
      * @param language The local name language. Defaults to `Language::English`.
+     * @param sex The optional sex to use.
      *
      * @returns Full name starting with first name.
      *
@@ -70,6 +85,17 @@ class Person
      */
     static std::string prefix(std::optional<Sex> = std::nullopt);
 
+    /**
+     * @brief Returns a random name suffix.
+     *
+     * @returns Name suffix.
+     *
+     * @code
+     * Person::suffix() // "Jr."
+     * @endcode
+     */
+    static std::string suffix();
+
     /**
      * @brief Returns a sex.
      *

include/faker-cxx/types/Sex.h

@@ -7,4 +7,16 @@ enum class Sex
     Male,
     Female,
 };
+
+inline std::string toString(Sex sex)
+{
+    std::map<Sex, std::string> sexToStringMapping{{Sex::Male, "Male"}, {Sex::Female, "Female"}};
+
+    return sexToStringMapping.at(sex);
+}
+
+inline std::ostream& operator<<(std::ostream& os, Sex sex)
+{
+    return os << toString(sex);
+}
 }

src/modules/company/Company.cpp

@@ -15,6 +15,8 @@
 
 namespace faker
 {
+// TODO: add internalization
+
 std::string Company::name()
 {
     std::string companyName;

src/modules/company/CompanyTest.cpp

@@ -5,8 +5,7 @@
 #include "gtest/gtest.h"
 
 #include "../../common/StringHelper.h"
-#include "../person/data/english/EnglishFirstNamesFemales.h"
-#include "../person/data/english/EnglishFirstNamesMales.h"
+#include "../person/data/english/EnglishFirstNames.h"
 #include "../person/data/english/EnglishLastNames.h"
 #include "../person/data/JobTitles.h"
 #include "data/BuzzAdjectives.h"
@@ -33,10 +32,10 @@ TEST_F(CompanyTest, shouldGenerateCompanyName)
 
     const auto companyNameElements = StringHelper::split(companyName, " ");
 
-    std::vector<std::string> expectedFirstNames{englishFirstNamesMales};
+    std::vector<std::string> expectedFirstNames{englishMalesFirstNames};
 
-    expectedFirstNames.insert(expectedFirstNames.end(), englishFirstNamesFemales.begin(),
-                              englishFirstNamesFemales.end());
+    expectedFirstNames.insert(expectedFirstNames.end(), englishFemalesFirstNames.begin(),
+                              englishFemalesFirstNames.end());
 
     if (companyNameElements.size() == 2)
     {

src/modules/internet/Internet.cpp

@@ -52,6 +52,7 @@ const std::map<EmojiType, std::vector<std::string>> emojiTypeToEmojisMapping{
 };
 }
 
+// TODO: add internalization
 std::string Internet::username(std::optional<std::string> firstNameInit, std::optional<std::string> lastNameInit)
 {
     const auto firstName = firstNameInit ? *firstNameInit : Person::firstName();

src/modules/internet/InternetTest.cpp

@@ -7,8 +7,7 @@
 #include "gtest/gtest.h"
 
 #include "../../common/StringHelper.h"
-#include "../person/data/english/EnglishFirstNamesFemales.h"
-#include "../person/data/english/EnglishFirstNamesMales.h"
+#include "../person/data/english/EnglishFirstNames.h"
 #include "../person/data/english/EnglishLastNames.h"
 #include "../string/data/Characters.h"
 #include "../word/data/Adjectives.h"
@@ -102,9 +101,9 @@ class InternetTest : public Test
 
 TEST_F(InternetTest, shouldGenerateUsername)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto username = Internet::username();
 
@@ -127,9 +126,9 @@ TEST_F(InternetTest, shouldGenerateUsernameWithFirstNameProvided)
 
 TEST_F(InternetTest, shouldGenerateUsernameWithLastNameProvided)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto lastName = "Cieslar";
 
@@ -154,9 +153,9 @@ TEST_F(InternetTest, shouldGenerateUsernameWithFullNameProvided)
 
 TEST_F(InternetTest, shouldGenerateEmail)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto email = Internet::email();
 
@@ -197,9 +196,9 @@ TEST_F(InternetTest, shouldGenerateEmailWithFirstName)
 
 TEST_F(InternetTest, shouldGenerateEmailWithLastName)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto lastName = "Howard";
 
@@ -221,9 +220,9 @@ TEST_F(InternetTest, shouldGenerateEmailWithLastName)
 
 TEST_F(InternetTest, shouldGenerateEmailWithFullName)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto firstName = "Cindy";
 
@@ -246,9 +245,9 @@ TEST_F(InternetTest, shouldGenerateEmailWithFullName)
 
 TEST_F(InternetTest, shouldGenerateEmailWithSpecifiedEmailHost)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto emailHost = "example.com";
 
@@ -270,9 +269,9 @@ TEST_F(InternetTest, shouldGenerateEmailWithSpecifiedEmailHost)
 
 TEST_F(InternetTest, shouldGenerateExampleEmail)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto email = Internet::exampleEmail();
 
@@ -313,9 +312,9 @@ TEST_F(InternetTest, shouldGenerateExampleEmailWithFirstName)
 
 TEST_F(InternetTest, shouldGenerateExampleEmailWithLastName)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto lastName = "Wilkinson";
 
@@ -337,9 +336,9 @@ TEST_F(InternetTest, shouldGenerateExampleEmailWithLastName)
 
 TEST_F(InternetTest, shouldGenerateExampleEmailWithFullName)
 {
-    std::vector<std::string> firstNames{englishFirstNamesMales};
+    std::vector<std::string> firstNames{englishMalesFirstNames};
 
-    firstNames.insert(firstNames.end(), englishFirstNamesFemales.begin(), englishFirstNamesFemales.end());
+    firstNames.insert(firstNames.end(), englishFemalesFirstNames.begin(), englishFemalesFirstNames.end());
 
     const auto firstName = "Walter";
 

src/modules/location/Location.cpp

@@ -30,6 +30,7 @@ namespace faker
 {
 namespace
 {
+// TODO: Refactor
 const std::map<Country, std::vector<std::string>> countryToCitiesMapping{{Country::Usa, usaCities},
                                                                          {Country::Russia, russiaCities},
                                                                          {Country::Poland, polandCities},
@@ -124,6 +125,8 @@ std::string Location::streetAddress(Country country)
 
 std::string Location::street(Country country)
 {
+    // TODO: add internalization
+
     const auto& streetFormats = countryToStreetFormatsMapping.at(country);
 
     const auto streetFormat = Helper::arrayElement<std::string>(streetFormats);