Name¶

fakernaija.Naija.first_name(self, tribe: str | None = None, gender: str | None = None) → str¶

Generate a random first name with optional parameters.

Parameters:

tribe (str | None, optional) – The tribe from which to generate the name.
gender (str | None, optional) – The gender from which to generate the name.

Returns:

A randomly generated first name.

Return type:

str

Raises:

ValueError – If the specified tribe or gender is not supported.

Note

Tribe options: yoruba, igbo, hausa, edo, fulani, ijaw
Gender options: male, female

Examples

>>> from fakernaija import Naija
>>> naija = Naija()

>>> first_name = naija.first_name()
>>> print(f"Random first name: {first_name}")
Random first name: Nasiru

>>> for _ in range(3):
...     print(naija.first_name())
...
Izuchukwu
Yinka
Muhammadu

>>> first_name_tribe = naija.first_name(tribe="yoruba")
>>> print(f"Random first name: {first_name_tribe}")
Random first name: Opeyemi

>>> female_first_name = naija.first_name(gender="female")
>>> print(f"Random female first name: {female_first_name}")
Random female first name: Somtochi

>>> male_first_name_tribe = naija.first_name(tribe="yoruba", gender="male")
>>> print(f"Random Yoruba male first name: {male_first_name_tribe}")
Random Yoruba male first name: Seyi

fakernaija.Naija.full_name(self, middle_name: bool = False, tribe: str | None = None, gender: str | None = None) → str¶

Generate a random full name with optional parameters.

Parameters:

middle_name (bool, optional) – Whether to include a middle name. Defaults to False.
tribe (str | None, optional) – The tribe from which to generate the name.
gender (str | None, optional) – The gender from which to generate the name.

Returns:

A randomly generated full name.

Return type:

str

Raises:

ValueError – If the specified tribe or gender is not supported.

Note

Tribe options: yoruba, igbo, hausa, edo, fulani, ijaw
Gender options: male, female

Examples

>>> from fakernaija import Naija
>>> naija = Naija()

>>> full_name = naija.full_name()
>>> print(f"Random full name: {full_name}")
Random full name: Ugochi Maduike

>>> for _ in range(3):
...     print(naija.full_name())
...
Ozioma Anyaegbunam
Oluwatosin Lemboye
Osawaru Ikhine

>>> full_name = naija.full_name(middle_name=True)
>>> print(f"Random full name with middle name: {full_name}")
Random full name with middle name: Kosisochukwu Somtochukwu Mbakwe

>>> full_name = naija.full_name(tribe="yoruba")
>>> print(f"Random Yoruba full name: {full_name}")
Random Yoruba full name: Opeyemi Obisesan

>>> full_name = naija.full_name(tribe="yoruba", middle_name=True)
>>> print(f"Random Yoruba full name with middle name: {full_name}")
Random Yoruba full name with middle name: Babajide Olusola Sanwo-olu

>>> full_name = naija.full_name(gender="female")
>>> print(f"Random female full name: {full_name}")
Random female full name: Chisom Nnabude

>>> full_name = naija.full_name(gender="female", middle_name=True)
>>> print(f"Random female full name with middle name: {full_name}")
Random female full name with middle name: Ifeoma Chinecherem Nwankwo

>>> full_name = naija.full_name(tribe="edo", gender="female", middle_name=True)
>>> print(f"Random female full name with middle name from Edo tribe: {full_name}")
Random female full name with middle name from Edo tribe: Osazee Osahon Ogiemwonyi

fakernaija.Naija.last_name(self, tribe: str | None = None) → str¶

Generate a random last name with optional parameter.

Parameters:: tribe (str | None, optional) – The tribe from which to generate the last name.
Returns:: A randomly generated last name.
Return type:: str
Raises:: ValueError – If the specified tribe is not supported.

Note

Tribe options: yoruba, igbo, hausa, edo, fulani, ijaw

Examples

>>> from fakernaija import Naija
>>> naija = Naija()

>>> last_name = naija.last_name()
>>> print(f"Random last name: {last_name}")
Random last name: Okonkwo

>>> for _ in range(3):
...     print(naija.last_name())
...
Bello
Ajiteru
Lawal

>>> last_name_tribe = naija.last_name(tribe="hausa")
>>> print(f"Random Hausa last name: {last_name_tribe}")
Random Hausa last name: Abubakar

fakernaija.Naija.prefix(self, gender: str | None = None, title: str | None = None) → str¶

Generates a random name prefix based on optional parameter.

Parameters:

gender (str | None, optional) – The gender for which to generate the prefix.
title (str | None, optional) – The title type for which to generate the prefix.

Returns:

A randomly generated prefix.

Return type:

str

Raises:

ValueError – If an invalid gender or title is provided.

Note

Gender options: male, female
Title options: traditional, professional

Examples

>>> from fakernaija import Naija
>>> naija = Naija()

>>> name_prefix = naija.prefix()
>>> print(f"Random name prefix: {name_prefix}")
Random name prefix: Prof.

>>> for _ in range(3):
...     print(naija.prefix())
...
Master
Alhaji
Miss

>>> male_prefix = naija.prefix(gender="male")
>>> print(f"Random male name prefix: {male_prefix}")
Random male name prefix: Mr.

>>> female_prefix = naija.prefix(gender="female")
>>> print(f"Random female name prefix: {female_prefix}")
Random female name prefix: Mrs.

>>> professional_prefix = naija.prefix(title="professional")
>>> print(f"Random professional prefix: {professional_prefix}")
Random professional prefix: Dr.

>>> male_traditional_prefix = naija.prefix(gender="male", title="traditional")
>>> print(f"Random male traditional prefix: {male_traditional_prefix}")
Random male traditional prefix: Waziri

>>> female_traditional_prefix = naija.prefix(gender="female", title="traditional")
>>> print(f"Random female traditional prefix: {female_traditional_prefix}")
Random female traditional prefix: Iyalode