def full_name(self,
gender: Optional[Gender] = None,
reverse: bool = False) -> str:
"""Generate a random full name.
:param reverse: Return reversed full name.
:param gender: Gender's enum object.
:return: Full name.
:Example:
Johann Wolfgang.
"""
if gender is None:
gender = get_random_item(Gender, rnd=self.random)
if gender and isinstance(gender, Gender):
gender = gender
else:
raise NonEnumerableError(Gender)
fmt = '{1} {0}' if reverse else '{0} {1}'
return fmt.format(
self.name(gender),
self.surname(gender),
)
def port(self, port_range: PortRange = PortRange.ALL) -> int:
"""Generate random port.
:param port_range: PortRange enum object.
:return: Port number.
:raises NonEnumerableError: if port_range is not in PortRange.
:Example:
8080
"""
if isinstance(port_range, PortRange):
return self.random.randint(*port_range.value)
raise NonEnumerableError(PortRange)
def _validate_enum(self, item: Any, enum: Any) -> Any:
"""Validate enum parameter of method in subclasses of BaseProvider.
:param item: Item of enum object.
:param enum: Enum object.
:return: Value of item.
:raises NonEnumerableError: if ``item`` not in ``enum``.
"""
if item is None:
result = get_random_item(enum, self.random)
elif item and isinstance(item, enum):
result = item
else:
raise NonEnumerableError(enum)
return result.value
def country_iso_code(self, fmt: Optional[CountryCode] = None) -> str:
"""Get a random ISO code of country.
:param fmt: Enum object CountryCode.
:return: ISO Code.
:raises KeyError: if fmt is not supported.
:Example:
DE
"""
if fmt is None:
fmt = CountryCode.get_random_item()
if fmt and fmt in CountryCode:
codes = COUNTRIES_ISO[fmt.value]
return self.random.choice(codes)
else:
raise NonEnumerableError(CountryCode)
def credit_card_number(self, card_type: t.Optional[CardType] = None) -> str:
"""Generate a random credit card number.
:param card_type: Issuing Network. Default is Visa.
:return: Credit card number.
:raises NotImplementedError: if card_type not supported.
:Example:
4455 5299 1152 2450
"""
length = 16
regex = re.compile(r"(\d{4})(\d{4})(\d{4})(\d{4})")
if card_type is None:
card_type = get_random_item(CardType, rnd=self.random)
if card_type == CardType.VISA:
number = self.random.randint(4000, 4999)
elif card_type == CardType.MASTER_CARD:
number = self.random.choice(
[
self.random.randint(2221, 2720),
self.random.randint(5100, 5599),
]
)
elif card_type == CardType.AMERICAN_EXPRESS:
number = self.random.choice([34, 37])
length = 15
regex = re.compile(r"(\d{4})(\d{6})(\d{5})")
else:
raise NonEnumerableError(CardType)
str_num = str(number)
while len(str_num) < length - 1:
str_num += self.random.choice(string.digits)
groups = regex.search( # type: ignore
str_num + luhn_checksum(str_num),
).groups()
card = " ".join(groups)
return card
def full_name(self,
gender: t.Optional[Gender] = None,
reverse: bool = False) -> str:
"""Generate a random full name.
:param reverse: Return reversed full name.
:param gender: Gender's enum object.
:return: Full name.
:Example:
Johann Wolfgang.
"""
if gender is None:
gender = get_random_item(Gender, rnd=self.random)
if gender and isinstance(gender, Gender):
gender = gender
else:
raise NonEnumerableError(Gender)
name = self.name(gender)
surname = self.surname(gender)
return f"{surname} {name}" if reverse else f"{name} {surname}"