Skip to content

Faker: providers Q–T

This reference covers 138 facade names in the Q-T range. The whole catalog contains 675 typed methods (694 signatures including overloads) and 7 backend helpers accessible at runtime, organized alphabetically. Availability was checked against the installed backend’s 110 locales; some methods only exist for specific locales.

Examples generate values in memory. They neither create tables nor insert records. Define this factory once, then use snippets inside its definition(), a seeder or a service/controller as shown in Faker and simulated data.

from orionis.orm import Integer, Model, String
from orionis.orm.factories import Factory
class SampleRecord(Model):
id = Integer().primary().autoIncrement()
value = String(180)
timestamps = False
fillable = ["value"]
class SampleFactory(Factory[SampleRecord]):
model = SampleRecord
def definition(self):
return {"value": self.fake.word()}

Each entry selects a verified compatible locale, presents the typed contract and the backend’s actual defaults. ... in a typed signature means the stub does not specify that default, not a value to pass. Runtime signatures show concrete defaults. Locale variants are distinguished when they differ; examples retain native parameter names while facade methods use camelCase.

Types T and TEnum preserve received value/Enum types; Callable, Iterable, Sequence, Collection, Any, Decimal, UUID and datetime types belong to the provider’s Python contract. Optional permits None and Literal restricts concrete values. Results are not automatically converted to ORM attributes or JSON: apply the appropriate cast/encoder.

Methods ordinarily propagate backend parameter errors (TypeError, ValueError, formatting errors). If a locale does not publish a name, the facade raises AttributeError. image and xml need specific dependencies explained in their entries. See the usage guide for unique and optional; unhashable results can prevent uniqueness checks. No claim is made that every method exists for every locale.

A-D · E-H · I-L · M-P · Q-T · U-Z

Selects several elements with replacement; results may repeat.

Orionis typed contract:

def randomChoices(elements: Collection[T] | OrderedDict[T, float], length: int | None=...) -> Sequence[T]
def randomChoices(*, length: int | None=...) -> Sequence[str]

Actual signature for en_US:

fake.randomChoices(elements: Collection[~T] | collections.OrderedDict[~T, float] = ('a', 'b', 'c'), length: int | None = None) -> Sequence[~T]
ParameterPurpose
elementsValue population; OrderedDict can represent weights.
lengthValue length/size; units depend on this provider.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomChoices()

randomCompanyAcronym generates company names and expressions for test entities.

Orionis typed contract:

def randomCompanyAcronym() -> str

Actual signature for es_ES:

fake.randomCompanyAcronym() -> str

Verified availability: 5 locales. Example locales: es_ES, en_PH, es, fil_PH, tl_PH.

fake = SampleFactory(locale="es_ES", seed=7).fake
value = fake.randomCompanyAcronym()

randomCompanyAdjective generates company names and expressions for test entities.

Orionis typed contract:

def randomCompanyAdjective() -> str

Actual signature for es_ES:

fake.randomCompanyAdjective() -> str

Verified availability: 5 locales. Example locales: es_ES, en_PH, es, fil_PH, tl_PH.

fake = SampleFactory(locale="es_ES", seed=7).fake
value = fake.randomCompanyAdjective()

randomCompanyNounChain generates company names and expressions for test entities.

Orionis typed contract:

def randomCompanyNounChain() -> str

Actual signature for en_PH:

fake.randomCompanyNounChain() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.randomCompanyNounChain()

randomCompanyProduct generates company names and expressions for test entities.

Orionis typed contract:

def randomCompanyProduct() -> str

Actual signature for en_PH:

fake.randomCompanyProduct() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.randomCompanyProduct()

randomDigit returns this localized provider’s simulated value.

Orionis typed contract:

def randomDigit() -> int

Actual signature for en_US:

fake.randomDigit() -> int

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomDigit()

randomDigitAboveTwo returns this localized provider’s simulated value.

Orionis typed contract:

def randomDigitAboveTwo() -> int

Actual signature for en_US:

fake.randomDigitAboveTwo() -> int

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomDigitAboveTwo()

randomDigitNotNull returns this localized provider’s simulated value.

Orionis typed contract:

def randomDigitNotNull() -> int

Actual signature for en_US:

fake.randomDigitNotNull() -> int

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomDigitNotNull()

randomDigitNotNullOrEmpty returns this localized provider’s simulated value.

Orionis typed contract:

def randomDigitNotNullOrEmpty() -> int | str

Actual signature for en_US:

fake.randomDigitNotNullOrEmpty() -> int | str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomDigitNotNullOrEmpty()

randomDigitOrEmpty returns this localized provider’s simulated value.

Orionis typed contract:

def randomDigitOrEmpty() -> int | str

Actual signature for en_US:

fake.randomDigitOrEmpty() -> int | str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomDigitOrEmpty()

Selects an element from the population; OrderedDict supports weights. Omission uses provider defaults.

Orionis typed contract:

def randomElement(elements: Collection[T] | OrderedDict[T, float]) -> T
def randomElement() -> str

Actual signature for en_US:

fake.randomElement(elements: Collection[~T] | collections.OrderedDict[~T, float] = ('a', 'b', 'c')) -> ~T
ParameterPurpose
elementsValue population; OrderedDict can represent weights.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomElement()

Selects elements; unique controls repetition and use_weighting weighting when supported by the population.

Orionis typed contract:

def randomElements(elements: Collection[T] | OrderedDict[T, float], length: int | None=..., unique: bool=..., use_weighting: bool | None=...) -> Sequence[T]
def randomElements(*, length: int | None=..., unique: bool=..., use_weighting: bool | None=...) -> Sequence[str]

Actual signature for en_US:

fake.randomElements(elements: Collection[~T] | collections.OrderedDict[~T, float] = ('a', 'b', 'c'), length: int | None = None, unique: bool = False, use_weighting: bool | None = None) -> Sequence[~T]
ParameterPurpose
elementsValue population; OrderedDict can represent weights.
lengthValue length/size; units depend on this provider.
uniqueRequests nonrepeating selections within this call.
use_weightingEnables weighting where supported.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomElements()

randomGoodServiceAdjective generates company names and expressions for test entities.

Orionis typed contract:

def randomGoodServiceAdjective() -> str

Actual signature for fil_PH:

fake.randomGoodServiceAdjective() -> str

Verified availability: 2 locales. Example locales: fil_PH, tl_PH.

fake = SampleFactory(locale="fil_PH", seed=7).fake
value = fake.randomGoodServiceAdjective()

randomGoodServiceAdjectiveChain generates company names and expressions for test entities.

Orionis typed contract:

def randomGoodServiceAdjectiveChain() -> str

Actual signature for fil_PH:

fake.randomGoodServiceAdjectiveChain() -> str

Verified availability: 2 locales. Example locales: fil_PH, tl_PH.

fake = SampleFactory(locale="fil_PH", seed=7).fake
value = fake.randomGoodServiceAdjectiveChain()

Integer between inclusive min/max bounds using step; useful for bounded quantities.

Orionis typed contract:

def randomInt(min: int=..., max: int=..., step: int=...) -> int

Actual signature for en_US:

fake.randomInt(min: int = 0, max: int = 9999, step: int = 1) -> int
ParameterPurpose
minInclusive lower bound.
maxInclusive upper bound.
stepInteger selection step.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomInt()

randomLetter returns this localized provider’s simulated value.

Orionis typed contract:

def randomLetter() -> str

Actual signature for en_US:

fake.randomLetter() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomLetter()

randomLetters returns this localized provider’s simulated value.

Orionis typed contract:

def randomLetters(length: int=...) -> Sequence[str]

Actual signature for en_US:

fake.randomLetters(length: int = 16) -> Sequence[str]
ParameterPurpose
lengthValue length/size; units depend on this provider.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomLetters()

randomLowercaseLetter returns this localized provider’s simulated value.

Orionis typed contract:

def randomLowercaseLetter() -> str

Actual signature for en_US:

fake.randomLowercaseLetter() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomLowercaseLetter()

randomNameComplements generates company names and expressions for test entities.

Orionis typed contract:

def randomNameComplements() -> str

Actual signature for es_ES:

fake.randomNameComplements() -> str

Verified availability: 2 locales. Example locales: es_ES, es.

fake = SampleFactory(locale="es_ES", seed=7).fake
value = fake.randomNameComplements()

randomNounIshGoodTrait generates company names and expressions for test entities.

Orionis typed contract:

def randomNounIshGoodTrait() -> str

Actual signature for fil_PH:

fake.randomNounIshGoodTrait() -> str

Verified availability: 2 locales. Example locales: fil_PH, tl_PH.

fake = SampleFactory(locale="fil_PH", seed=7).fake
value = fake.randomNounIshGoodTrait()

Integer with requested digit count; fix_len enforces fixed length when enabled.

Orionis typed contract:

def randomNumber(digits: int | None=..., fix_len: bool=...) -> int

Actual signature for en_US:

fake.randomNumber(digits: int | None = None, fix_len: bool = False) -> int
ParameterPurpose
digitsNumber of result digits.
fix_lenRequires exact digit length.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomNumber()

randomObjectName generates auxiliary test values and structures; return shape depends on the method.

Orionis typed contract:

def randomObjectName() -> str

Actual signature for en_PH:

fake.randomObjectName() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.randomObjectName()

randomObjectOfConcern generates company names and expressions for test entities.

Orionis typed contract:

def randomObjectOfConcern() -> str

Actual signature for fil_PH:

fake.randomObjectOfConcern() -> str

Verified availability: 2 locales. Example locales: fil_PH, tl_PH.

fake = SampleFactory(locale="fil_PH", seed=7).fake
value = fake.randomObjectOfConcern()

Samples without replacement; requesting more items than the population fails.

Orionis typed contract:

def randomSample(elements: Collection[T] | OrderedDict[T, float], length: int | None=...) -> Sequence[T]
def randomSample(*, length: int | None=...) -> Sequence[str]

Actual signature for en_US:

fake.randomSample(elements: Collection[~T] | collections.OrderedDict[~T, float] = ('a', 'b', 'c'), length: int | None = None) -> Sequence[~T]
ParameterPurpose
elementsValue population; OrderedDict can represent weights.
lengthValue length/size; units depend on this provider.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomSample()

randomUppercaseLetter returns this localized provider’s simulated value.

Orionis typed contract:

def randomUppercaseLetter() -> str

Actual signature for en_US:

fake.randomUppercaseLetter() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomUppercaseLetter()

randomizeNbElements returns this localized provider’s simulated value.

Orionis typed contract:

def randomizeNbElements(number: int=..., le: bool=..., ge: bool=..., min: int | None=..., max: int | None=...) -> int

Actual signature for en_US:

fake.randomizeNbElements(number: int = 10, le: bool = False, ge: bool = False, min: int | None = None, max: int | None = None) -> int
ParameterPurpose
numberReference count varied by randomizeNbElements.
lePrevents results above number in randomizeNbElements.
gePrevents results below number in randomizeNbElements.
minInclusive lower bound.
maxInclusive upper bound.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.randomizeNbElements()

rcsNumber generates company names and expressions for test entities.

Orionis typed contract:

def rcsNumber(city: str=..., letter: str=..., siren: str=...) -> str

Actual signature for fr_CH:

fake.rcsNumber(city: str = '', letter: str = '', siren: str = '') -> str
ParameterPurpose
cityCity used in the company registry number.
letterLetter used in the simulated company registry number.
sirenSIREN incorporated into the RCS registry number.

Verified availability: 2 locales. Example locales: fr_CH, fr_FR.

fake = SampleFactory(locale="fr_CH", seed=7).fake
value = fake.rcsNumber()

rdNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def rdNumber() -> str

Actual signature for en_NZ:

fake.rdNumber() -> str

Verified availability: 1 locales. Example locales: en_NZ.

fake = SampleFactory(locale="en_NZ", seed=7).fake
value = fake.rdNumber()

realCityName generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def realCityName() -> str

Actual signature for hu_HU:

fake.realCityName() -> str

Verified availability: 1 locales. Example locales: hu_HU.

fake = SampleFactory(locale="hu_HU", seed=7).fake
value = fake.realCityName()

region generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def region() -> str

Actual signature for es_ES:

fake.region() -> str

Verified availability: 8 locales. Example locales: es_ES, el_GR, es, es_CL, fr_FR, pl_PL, ru_RU, uk_UA.

fake = SampleFactory(locale="es_ES", seed=7).fake
value = fake.region()

regionCode generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def regionCode() -> str

Actual signature for es_CL:

fake.regionCode() -> str

Verified availability: 1 locales. Example locales: es_CL.

fake = SampleFactory(locale="es_CL", seed=7).fake
value = fake.regionCode()

regon generates company names and expressions for test entities.

Orionis typed contract:

def regon() -> str

Actual signature for pl_PL:

fake.regon() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.regon()

rfc generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def rfc(natural: bool=...) -> str

Actual signature for es_MX:

fake.rfc(natural: bool = True) -> str
ParameterPurpose
naturalSelects a natural-person rather than legal-entity RFC.

Verified availability: 1 locales. Example locales: es_MX.

fake = SampleFactory(locale="es_MX", seed=7).fake
value = fake.rfc()

rg generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def rg() -> str

Actual signature for pt_BR:

fake.rg() -> str

Verified availability: 1 locales. Example locales: pt_BR.

fake = SampleFactory(locale="pt_BR", seed=7).fake
value = fake.rg()

rgbColor generates colors and representations for interface data.

Orionis typed contract:

def rgbColor() -> str

Actual signature for en_US:

fake.rgbColor() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.rgbColor()

rgbCssColor generates colors and representations for interface data.

Orionis typed contract:

def rgbCssColor() -> str

Actual signature for en_US:

fake.rgbCssColor() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.rgbCssColor()

ripeId generates Internet addresses and formats for test data; generating a string does not open a connection.

Orionis typed contract:

def ripeId() -> str

Actual signature for en_US:

fake.ripeId() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.ripeId()

road generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def road() -> str

Actual signature for ko_KR:

fake.road() -> str

Verified availability: 1 locales. Example locales: ko_KR.

fake = SampleFactory(locale="ko_KR", seed=7).fake
value = fake.road()

roadAddress generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def roadAddress() -> str

Actual signature for ko_KR:

fake.roadAddress() -> str

Verified availability: 1 locales. Example locales: ko_KR.

fake = SampleFactory(locale="ko_KR", seed=7).fake
value = fake.roadAddress()

roadName generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def roadName() -> str

Actual signature for es_CL:

fake.roadName() -> str

Verified availability: 2 locales. Example locales: es_CL, ko_KR.

fake = SampleFactory(locale="es_CL", seed=7).fake
value = fake.roadName()

roadNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def roadNumber() -> str

Actual signature for ko_KR:

fake.roadNumber() -> str

Verified availability: 1 locales. Example locales: ko_KR.

fake = SampleFactory(locale="ko_KR", seed=7).fake
value = fake.roadNumber()

roadSuffix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def roadSuffix() -> str

Actual signature for ko_KR:

fake.roadSuffix() -> str

Verified availability: 1 locales. Example locales: ko_KR.

fake = SampleFactory(locale="ko_KR", seed=7).fake
value = fake.roadSuffix()

romanizedName generates names and identity components for test profiles.

Orionis typed contract:

def romanizedName() -> str

Actual signature for ja_JP:

fake.romanizedName() -> str

Verified availability: 3 locales. Example locales: ja_JP, zh_CN, zh_TW.

fake = SampleFactory(locale="ja_JP", seed=7).fake
value = fake.romanizedName()

romanizedNameFemale generates names and identity components for test profiles.

Orionis typed contract:

def romanizedNameFemale() -> str

Actual signature for ja_JP:

fake.romanizedNameFemale() -> str

Verified availability: 2 locales. Example locales: ja_JP, zh_TW.

fake = SampleFactory(locale="ja_JP", seed=7).fake
value = fake.romanizedNameFemale()

romanizedNameMale generates names and identity components for test profiles.

Orionis typed contract:

def romanizedNameMale() -> str

Actual signature for ja_JP:

fake.romanizedNameMale() -> str

Verified availability: 2 locales. Example locales: ja_JP, zh_TW.

fake = SampleFactory(locale="ja_JP", seed=7).fake
value = fake.romanizedNameMale()

rut generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def rut(min: int=..., max: int=...) -> str

Actual signature for es_CL:

fake.rut(min: int = 10, max: int = 99999999) -> str
ParameterPurpose
minInclusive lower bound.
maxInclusive upper bound.

Verified availability: 1 locales. Example locales: es_CL.

fake = SampleFactory(locale="es_CL", seed=7).fake
value = fake.rut()

rvnr generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def rvnr(birthdate: datetime.date | None=...) -> str

Actual signature for de_DE:

fake.rvnr(birthdate: datetime.date | None = None) -> str
ParameterPurpose
birthdateBirth date used when constructing the identifier.

Verified availability: 2 locales. Example locales: de, de_DE.

fake = SampleFactory(locale="de_DE", seed=7).fake
value = fake.rvnr()

safari generates User-Agent strings and components for simulated clients.

Orionis typed contract:

def safari() -> str

Actual signature for en_US:

fake.safari() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.safari()

safeColorName generates colors and representations for interface data.

Orionis typed contract:

def safeColorName() -> str

Actual signature for en_US:

fake.safeColorName() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.safeColorName()

safeDomainName generates Internet addresses and formats for test data; generating a string does not open a connection.

Orionis typed contract:

def safeDomainName() -> str

Actual signature for en_US:

fake.safeDomainName() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.safeDomainName()

safeEmail generates Internet addresses and formats for test data; generating a string does not open a connection.

Orionis typed contract:

def safeEmail() -> str

Actual signature for en_US:

fake.safeEmail() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.safeEmail()

safeHexColor generates colors and representations for interface data.

Orionis typed contract:

def safeHexColor() -> str

Actual signature for en_US:

fake.safeHexColor() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.safeHexColor()

sbn9 generates book codes for catalogs.

Orionis typed contract:

def sbn9(separator: str=...) -> str

Actual signature for en_US:

fake.sbn9(separator: str = '-') -> str
ParameterPurpose
separatorTextual format separator.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.sbn9()

secondaryAddress generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def secondaryAddress() -> str

Actual signature for en_US:

fake.secondaryAddress() -> str

Verified availability: 64 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_EG.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.secondaryAddress()

sectionNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def sectionNumber() -> str

Actual signature for zh_TW:

fake.sectionNumber() -> str

Verified availability: 2 locales. Example locales: zh_TW, zu_ZA.

fake = SampleFactory(locale="zh_TW", seed=7).fake
value = fake.sectionNumber()

sentence generates placeholder text for content and forms.

Orionis typed contract:

def sentence(nb_words: int=..., variable_nb_words: bool=..., ext_word_list: Sequence[str] | None=...) -> str

Actual signature for en_US:

fake.sentence(nb_words: int = 6, variable_nb_words: bool = True, ext_word_list: Sequence[str] | None = None) -> str
ParameterPurpose
nb_wordsTarget word count.
variable_nb_wordsAllows variation around target word count.
ext_word_listAlternative vocabulary or None for native data.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.sentence()

sentences generates placeholder text for content and forms.

Orionis typed contract:

def sentences(nb: int=..., ext_word_list: Sequence[str] | None=...) -> list[str]

Actual signature for en_US:

fake.sentences(nb: int = 3, ext_word_list: Sequence[str] | None = None) -> List[str]
ParameterPurpose
nbRequested result count.
ext_word_listAlternative vocabulary or None for native data.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.sentences()

serialNumber generates vehicle plates and identifiers for examples and fixtures.

Orionis typed contract:

def serialNumber() -> str

Actual signature for ja_JP:

fake.serialNumber() -> str

Verified availability: 1 locales. Example locales: ja_JP.

fake = SampleFactory(locale="ja_JP", seed=7).fake
value = fake.serialNumber()

servicePhoneNumber generates fictional telephone numbers in local formats.

Orionis typed contract:

def servicePhoneNumber() -> str

Actual signature for ar_AE:

fake.servicePhoneNumber() -> str

Verified availability: 4 locales. Example locales: ar_AE, ar_JO, ar_PS, pt_BR.

fake = SampleFactory(locale="ar_AE", seed=7).fake
value = fake.servicePhoneNumber()

Configures one argument (group, argument, value), or replaces a group with a dict as the second argument despite its native str annotation. Returns None; other argument types raise ValueError.

Helper accessible through dynamic facade dispatch; not declared in _ProviderMethods.

Actual signature for en_US:

fake.setArguments(group: str, argument: str, value: Any | None = None) -> None

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
fake.setArguments("small", "min_value", 1)
fake.setArguments("small", "max_value", 3)
value = fake.parse("{{pyint:small}}")

settlement generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def settlement() -> str

Actual signature for az_AZ:

fake.settlement() -> str

Verified availability: 1 locales. Example locales: az_AZ.

fake = SampleFactory(locale="az_AZ", seed=7).fake
value = fake.settlement()

settlementSuffix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def settlementSuffix() -> str

Actual signature for az_AZ:

fake.settlementSuffix() -> str

Verified availability: 1 locales. Example locales: az_AZ.

fake = SampleFactory(locale="az_AZ", seed=7).fake
value = fake.settlementSuffix()

SHA-1 digest of random data for fixtures; not password hashing.

Orionis typed contract:

def sha1() -> str
def sha1(raw_output: Literal[True]) -> bytes
def sha1(raw_output: Literal[False]) -> str

Actual signature for en_US:

fake.sha1(raw_output: bool = False) -> bytes | str
ParameterPurpose
raw_outputRequests binary/native output rather than usual text.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.sha1()

SHA-256 digest of random data for fixtures; not password hashing.

Orionis typed contract:

def sha256() -> str
def sha256(raw_output: Literal[True]) -> bytes
def sha256(raw_output: Literal[False]) -> str

Actual signature for en_US:

fake.sha256(raw_output: bool = False) -> bytes | str
ParameterPurpose
raw_outputRequests binary/native output rather than usual text.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.sha256()

simpleProfile generates composite profiles for fixtures.

Orionis typed contract:

def simpleProfile(sex: Literal['M', 'F', 'X'] | None=...) -> dict[str, str | datetime.date | Literal['M', 'F', 'X']]

Actual signature for en_US:

fake.simpleProfile(sex: Literal['M', 'F', 'X'] | None = None) -> Dict[str, str | datetime.date | Literal['M', 'F', 'X']]
ParameterPurpose
sexSex selection using supported locale-specific values.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.simpleProfile()

siren generates company names and expressions for test entities.

Orionis typed contract:

def siren() -> str

Actual signature for fr_CH:

fake.siren() -> str

Verified availability: 2 locales. Example locales: fr_CH, fr_FR.

fake = SampleFactory(locale="fr_CH", seed=7).fake
value = fake.siren()

siret generates company names and expressions for test entities.

Orionis typed contract:

def siret(max_sequential_digits: int=...) -> str

Actual signature for fr_CH:

fake.siret(max_sequential_digits: int = 2) -> str
ParameterPurpose
max_sequential_digitsMaximum SIRET sequential digits, from 1 to 4; invalid values normalize to 2.

Verified availability: 2 locales. Example locales: fr_CH, fr_FR.

fake = SampleFactory(locale="fr_CH", seed=7).fake
value = fake.siret()

slug generates Internet addresses and formats for test data; generating a string does not open a connection.

Orionis typed contract:

def slug(value: str | None=...) -> str

Actual signature for en_US:

fake.slug(value: str | None = None) -> str
ParameterPurpose
valueSource text normalized into a slug.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.slug()

smartMobileNumber generates fictional telephone numbers in local formats.

Orionis typed contract:

def smartMobileNumber() -> str

Actual signature for en_PH:

fake.smartMobileNumber() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.smartMobileNumber()

smartMobileNumberPrefix generates fictional telephone numbers in local formats.

Orionis typed contract:

def smartMobileNumberPrefix() -> str

Actual signature for en_PH:

fake.smartMobileNumberPrefix() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.smartMobileNumberPrefix()

snils generates company names and expressions for test entities.

Orionis typed contract:

def snils() -> str

Actual signature for ru_RU:

fake.snils() -> str

Verified availability: 1 locales. Example locales: ru_RU.

fake = SampleFactory(locale="ru_RU", seed=7).fake
value = fake.snils()

spaceObjectName generates auxiliary test values and structures; return shape depends on the method.

Orionis typed contract:

def spaceObjectName() -> str

Actual signature for en_PH:

fake.spaceObjectName() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.spaceObjectName()

specialCode generates fictional telephone numbers in local formats.

Orionis typed contract:

def specialCode() -> str

Actual signature for es_CL:

fake.specialCode() -> str

Verified availability: 1 locales. Example locales: es_CL.

fake = SampleFactory(locale="es_CL", seed=7).fake
value = fake.specialCode()

ssn generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def ssn(taxpayer_identification_number_type: str=...) -> str

Actual signature for en_US:

fake.ssn(taxpayer_identification_number_type: str = 'SSN') -> str
ParameterPurpose
taxpayer_identification_number_typeLocale-specific taxpayer identifier kind; en_US defaults to SSN.
birthdateBirth date used when constructing the identifier.
min_ageMinimum age of the localized identifier holder.
max_ageMaximum age of the localized identifier holder.
artificialSelects the artificial identifier marker where supported by the locale.
dobBirth date used to form the localized identifier.
genderGender selection using supported locale-specific values.
longRequests the long localized identifier variant.
dashIncludes a hyphen in the identifier representation.
birthdayReference birth date for the passport.
area_codeArea code used to form the localized identifier.

Actual locale variants:

en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_EG and 46 more:

fake.ssn(taxpayer_identification_number_type: str = 'SSN') -> str

ar_DZ, az_AZ, bg_BG, bn_BD, cs_CZ, de and 43 more:

fake.ssn() -> str

de_AT:

fake.ssn(birthdate: datetime.date | None = None) -> str

et_EE:

fake.ssn(min_age: int = 16, max_age: int = 90) -> str

fi_FI:

fake.ssn(min_age: int = 0, max_age: int = 105, artificial: bool = False) -> str

hu_HU, no_NO:

fake.ssn(dob: str | None = None, gender: Literal['M', 'F', 'X'] | None = None) -> str

lv_LV:

fake.ssn(min_age: int = 0, max_age: int = 105) -> str

sv_SE:

fake.ssn(min_age: int = 18, max_age: int = 90, long: bool = False, dash: bool = True) -> str

uk_UA:

fake.ssn(birthday: str | None = None, gender: Literal['M', 'F', 'X'] | None = None) -> str

zh_CN:

fake.ssn(min_age: int = 18, max_age: int = 90, gender: Literal['M', 'F', 'X'] | None = None, area_code: str = '') -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.ssn()

sss generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def sss() -> str

Actual signature for en_PH:

fake.sss() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.sss()

standaloneBuildingNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def standaloneBuildingNumber() -> str

Actual signature for en_PH:

fake.standaloneBuildingNumber() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.standaloneBuildingNumber()

startDigit generates fictional telephone numbers in local formats.

Orionis typed contract:

def startDigit() -> str

Actual signature for az_AZ:

fake.startDigit() -> str

Verified availability: 1 locales. Example locales: az_AZ.

fake = SampleFactory(locale="az_AZ", seed=7).fake
value = fake.startDigit()

state generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def state() -> str

Actual signature for en_US:

fake.state() -> str

Verified availability: 72 locales. Example locales: en_US, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_EG, ar_JO.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.state()

stateAbbr generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def stateAbbr(include_territories: bool=..., include_freely_associated_states: bool=...) -> str

Actual signature for en_US:

fake.stateAbbr(include_territories: bool = True, include_freely_associated_states: bool = True) -> str
ParameterPurpose
include_territoriesIncludes US territories in selection.
include_freely_associated_statesIncludes freely associated states in the state selection.

Actual locale variants:

en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_EG and 39 more:

fake.stateAbbr(include_territories: bool = True, include_freely_associated_states: bool = True) -> str

en_AU, es_MX, hy_AM, id_ID, it_IT, pt_BR and 2 more:

fake.stateAbbr() -> str

Verified availability: 53 locales. Example locales: en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_EG, ar_JO, ar_PS.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.stateAbbr()

stateName generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def stateName() -> str

Actual signature for es_ES:

fake.stateName() -> str

Verified availability: 2 locales. Example locales: es_ES, es.

fake = SampleFactory(locale="es_ES", seed=7).fake
value = fake.stateName()

street generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def street() -> str

Actual signature for az_AZ:

fake.street() -> str

Verified availability: 5 locales. Example locales: az_AZ, el_GR, hy_AM, id_ID, vi_VN.

fake = SampleFactory(locale="az_AZ", seed=7).fake
value = fake.street()

streetAddress generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetAddress() -> str

Actual signature for en_US:

fake.streetAddress() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.streetAddress()

streetAddressWithCounty generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetAddressWithCounty() -> str

Actual signature for hu_HU:

fake.streetAddressWithCounty() -> str

Verified availability: 1 locales. Example locales: hu_HU.

fake = SampleFactory(locale="hu_HU", seed=7).fake
value = fake.streetAddressWithCounty()

streetMunicipality generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetMunicipality() -> str

Actual signature for es_AR:

fake.streetMunicipality() -> str

Verified availability: 1 locales. Example locales: es_AR.

fake = SampleFactory(locale="es_AR", seed=7).fake
value = fake.streetMunicipality()

streetName generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetName() -> str

Actual signature for en_US:

fake.streetName() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.streetName()

streetNameAdjectiveFeminine generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetNameAdjectiveFeminine() -> str

Actual signature for pl_PL:

fake.streetNameAdjectiveFeminine() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.streetNameAdjectiveFeminine()

streetNameSuffix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetNameSuffix() -> str

Actual signature for zh_TW:

fake.streetNameSuffix() -> str

Verified availability: 1 locales. Example locales: zh_TW.

fake = SampleFactory(locale="zh_TW", seed=7).fake
value = fake.streetNameSuffix()

streetNameUniversal generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetNameUniversal() -> str

Actual signature for pl_PL:

fake.streetNameUniversal() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.streetNameUniversal()

streetPrefix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefix() -> str

Actual signature for es_CO:

fake.streetPrefix() -> str

Verified availability: 24 locales. Example locales: es_CO, es_ES, ar_DZ, el_GR, en_MS, es, es_AR, es_CL.

fake = SampleFactory(locale="es_CO", seed=7).fake
value = fake.streetPrefix()

streetPrefixFeminine generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefixFeminine() -> str

Actual signature for pl_PL:

fake.streetPrefixFeminine() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.streetPrefixFeminine()

streetPrefixFeminineShort generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefixFeminineShort() -> str

Actual signature for pl_PL:

fake.streetPrefixFeminineShort() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.streetPrefixFeminineShort()

streetPrefixLong generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefixLong() -> str

Actual signature for el_GR:

fake.streetPrefixLong() -> str

Verified availability: 2 locales. Example locales: el_GR, id_ID.

fake = SampleFactory(locale="el_GR", seed=7).fake
value = fake.streetPrefixLong()

streetPrefixMasculine generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefixMasculine() -> str

Actual signature for pl_PL:

fake.streetPrefixMasculine() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.streetPrefixMasculine()

streetPrefixMasculineShort generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefixMasculineShort() -> str

Actual signature for pl_PL:

fake.streetPrefixMasculineShort() -> str

Verified availability: 1 locales. Example locales: pl_PL.

fake = SampleFactory(locale="pl_PL", seed=7).fake
value = fake.streetPrefixMasculineShort()

streetPrefixShort generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetPrefixShort() -> str

Actual signature for el_GR:

fake.streetPrefixShort() -> str

Verified availability: 3 locales. Example locales: el_GR, id_ID, pl_PL.

fake = SampleFactory(locale="el_GR", seed=7).fake
value = fake.streetPrefixShort()

streetProcer generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetProcer() -> str

Actual signature for es_AR:

fake.streetProcer() -> str

Verified availability: 1 locales. Example locales: es_AR.

fake = SampleFactory(locale="es_AR", seed=7).fake
value = fake.streetProcer()

streetProvince generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetProvince() -> str

Actual signature for es_AR:

fake.streetProvince() -> str

Verified availability: 1 locales. Example locales: es_AR.

fake = SampleFactory(locale="es_AR", seed=7).fake
value = fake.streetProvince()

streetSuffix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetSuffix() -> str

Actual signature for en_US:

fake.streetSuffix() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.streetSuffix()

streetSuffixLong generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetSuffixLong() -> str

Actual signature for cs_CZ:

fake.streetSuffixLong() -> str

Verified availability: 5 locales. Example locales: cs_CZ, de, de_AT, de_DE, sk_SK.

fake = SampleFactory(locale="cs_CZ", seed=7).fake
value = fake.streetSuffixLong()

streetSuffixShort generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetSuffixShort() -> str

Actual signature for cs_CZ:

fake.streetSuffixShort() -> str

Verified availability: 5 locales. Example locales: cs_CZ, de, de_AT, de_DE, sk_SK.

fake = SampleFactory(locale="cs_CZ", seed=7).fake
value = fake.streetSuffixShort()

streetTitle generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def streetTitle() -> str

Actual signature for he_IL:

fake.streetTitle() -> str

Verified availability: 4 locales. Example locales: he_IL, ka_GE, ru_RU, uk_UA.

fake = SampleFactory(locale="he_IL", seed=7).fake
value = fake.streetTitle()

subStreet generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subStreet() -> str

Actual signature for vi_VN:

fake.subStreet() -> str

Verified availability: 1 locales. Example locales: vi_VN.

fake = SampleFactory(locale="vi_VN", seed=7).fake
value = fake.subStreet()

subStreetPrefix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subStreetPrefix() -> str

Actual signature for vi_VN:

fake.subStreetPrefix() -> str

Verified availability: 1 locales. Example locales: vi_VN.

fake = SampleFactory(locale="vi_VN", seed=7).fake
value = fake.subStreetPrefix()

subdivisionBlockNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subdivisionBlockNumber() -> str

Actual signature for en_PH:

fake.subdivisionBlockNumber() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.subdivisionBlockNumber()

subdivisionLotNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subdivisionLotNumber() -> str

Actual signature for en_PH:

fake.subdivisionLotNumber() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.subdivisionLotNumber()

subdivisionName generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subdivisionName() -> str

Actual signature for en_PH:

fake.subdivisionName() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.subdivisionName()

subdivisionNameSuffix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subdivisionNameSuffix() -> str

Actual signature for en_PH:

fake.subdivisionNameSuffix() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.subdivisionNameSuffix()

subdivisionUnitNumber generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def subdivisionUnitNumber() -> str

Actual signature for en_PH:

fake.subdivisionUnitNumber() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.subdivisionUnitNumber()

suffix generates names and identity components for test profiles.

Orionis typed contract:

def suffix() -> str

Actual signature for en_US:

fake.suffix() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.suffix()

suffixFemale generates names and identity components for test profiles.

Orionis typed contract:

def suffixFemale() -> str

Actual signature for en_US:

fake.suffixFemale() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.suffixFemale()

suffixMale generates names and identity components for test profiles.

Orionis typed contract:

def suffixMale() -> str

Actual signature for en_US:

fake.suffixMale() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.suffixMale()

suffixNonbinary generates names and identity components for test profiles.

Orionis typed contract:

def suffixNonbinary() -> str

Actual signature for en_US:

fake.suffixNonbinary() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.suffixNonbinary()

sunMobileNumber generates fictional telephone numbers in local formats.

Orionis typed contract:

def sunMobileNumber() -> str

Actual signature for en_PH:

fake.sunMobileNumber() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.sunMobileNumber()

sunMobileNumberPrefix generates fictional telephone numbers in local formats.

Orionis typed contract:

def sunMobileNumberPrefix() -> str

Actual signature for en_PH:

fake.sunMobileNumberPrefix() -> str

Verified availability: 3 locales. Example locales: en_PH, fil_PH, tl_PH.

fake = SampleFactory(locale="en_PH", seed=7).fake
value = fake.sunMobileNumberPrefix()

swift generates fictional banking identifiers; formatting does not represent operational accounts.

Orionis typed contract:

def swift(length: int | None=..., primary: bool=..., use_dataset: bool=...) -> str

Actual signature for en_US:

fake.swift(length: int | None = None, primary: bool = False, use_dataset: bool = False) -> str
ParameterPurpose
lengthValue length/size; units depend on this provider.
primaryFor 11-character SWIFT selects the primary office with XXX suffix.
use_datasetUses local SWIFT dataset codes when available, otherwise random components.

Actual locale variants:

en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ and 103 more:

fake.swift(length: int | None = None, primary: bool = False, use_dataset: bool = False) -> str

bn_BD:

fake.swift(length: int | None = None, primary: bool = False, use_dataset: bool = True) -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.swift()

swift11 generates fictional banking identifiers; formatting does not represent operational accounts.

Orionis typed contract:

def swift11(primary: bool=..., use_dataset: bool=...) -> str

Actual signature for en_US:

fake.swift11(primary: bool = False, use_dataset: bool = False) -> str
ParameterPurpose
primaryFor 11-character SWIFT selects the primary office with XXX suffix.
use_datasetUses local SWIFT dataset codes when available, otherwise random components.

Actual locale variants:

en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ and 103 more:

fake.swift11(primary: bool = False, use_dataset: bool = False) -> str

bn_BD:

fake.swift11(primary: bool = False, use_dataset: bool = True) -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.swift11()

swift8 generates fictional banking identifiers; formatting does not represent operational accounts.

Orionis typed contract:

def swift8(use_dataset: bool=...) -> str

Actual signature for en_US:

fake.swift8(use_dataset: bool = False) -> str
ParameterPurpose
use_datasetUses local SWIFT dataset codes when available, otherwise random components.

Actual locale variants:

en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ and 103 more:

fake.swift8(use_dataset: bool = False) -> str

bn_BD:

fake.swift8(use_dataset: bool = True) -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.swift8()

tambon generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def tambon() -> str

Actual signature for th_TH:

fake.tambon() -> str

Verified availability: 2 locales. Example locales: th, th_TH.

fake = SampleFactory(locale="th_TH", seed=7).fake
value = fake.tambon()

Generates TAR archive bytes in memory with configurable size/count/compression. Does not write to disk.

Orionis typed contract:

def tar(uncompressed_size: int=..., num_files: int=..., min_file_size: int=..., compression: str | None=...) -> bytes

Actual signature for en_US:

fake.tar(uncompressed_size: int = 65536, num_files: int = 1, min_file_size: int = 4096, compression: str | None = None) -> bytes
ParameterPurpose
uncompressed_sizeTotal uncompressed size in bytes.
num_filesNumber of files in the archive.
min_file_sizeMinimum bytes per file.
compressionNative compression algorithm or None.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.tar(uncompressed_size=128, min_file_size=64, num_files=1)

teReoEnding generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def teReoEnding() -> str

Actual signature for en_NZ:

fake.teReoEnding() -> str

Verified availability: 1 locales. Example locales: en_NZ.

fake = SampleFactory(locale="en_NZ", seed=7).fake
value = fake.teReoEnding()

teReoFirst generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def teReoFirst() -> str

Actual signature for en_NZ:

fake.teReoFirst() -> str

Verified availability: 1 locales. Example locales: en_NZ.

fake = SampleFactory(locale="en_NZ", seed=7).fake
value = fake.teReoFirst()

teReoPart generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def teReoPart() -> str

Actual signature for en_NZ:

fake.teReoPart() -> str

Verified availability: 1 locales. Example locales: en_NZ.

fake = SampleFactory(locale="en_NZ", seed=7).fake
value = fake.teReoPart()

telephoneNumber generates fictional telephone numbers in local formats.

Orionis typed contract:

def telephoneNumber() -> str

Actual signature for ar_AE:

fake.telephoneNumber() -> str

Verified availability: 5 locales. Example locales: ar_AE, ar_DZ, ar_JO, ar_PS, fr_DZ.

fake = SampleFactory(locale="ar_AE", seed=7).fake
value = fake.telephoneNumber()

telephoneProviderCode generates fictional telephone numbers in local formats.

Orionis typed contract:

def telephoneProviderCode() -> str

Actual signature for ar_AE:

fake.telephoneProviderCode() -> str

Verified availability: 1 locales. Example locales: ar_AE.

fake = SampleFactory(locale="ar_AE", seed=7).fake
value = fake.telephoneProviderCode()

text generates placeholder text for content and forms.

Orionis typed contract:

def text(max_nb_chars: int=..., ext_word_list: Sequence[str] | None=...) -> str

Actual signature for en_US:

fake.text(max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) -> str
ParameterPurpose
max_nb_charsMaximum requested text character count.
ext_word_listAlternative vocabulary or None for native data.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.text(max_nb_chars=80)

texts generates placeholder text for content and forms.

Orionis typed contract:

def texts(nb_texts: int=..., max_nb_chars: int=..., ext_word_list: Sequence[str] | None=...) -> list[str]

Actual signature for en_US:

fake.texts(nb_texts: int = 3, max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) -> List[str]
ParameterPurpose
nb_textsNumber of texts to return.
max_nb_charsMaximum requested text character count.
ext_word_listAlternative vocabulary or None for native data.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.texts(nb_texts=2, max_nb_chars=80)

time generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def time(pattern: str=..., end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None=...) -> str

Actual signature for en_US:

fake.time(pattern: str = '%H:%M:%S', end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None) -> str
ParameterPurpose
patternProvider-supported formatting pattern.
end_datetimeEnding datetime interval boundary.
thai_digitUses Thai digits in provider output.

Actual locale variants:

en_US, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ and 102 more:

fake.time(pattern: str = '%H:%M:%S', end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None) -> str

th, th_TH:

fake.time(pattern: str = '%H:%M:%S', end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None, thai_digit: bool = False) -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.time()

timeDelta generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def timeDelta(end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None=...) -> datetime.timedelta

Actual signature for en_US:

fake.timeDelta(end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None) -> datetime.timedelta
ParameterPurpose
end_datetimeEnding datetime interval boundary.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.timeDelta()

timeObject generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def timeObject(end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None=...) -> datetime.time

Actual signature for en_US:

fake.timeObject(end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None) -> datetime.time
ParameterPurpose
end_datetimeEnding datetime interval boundary.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.timeObject()

Generates an iterator of (datetime, value) pairs. The example consumes it with list and uses precision in seconds to bound point count.

Orionis typed contract:

def timeSeries(start_date: datetime.date | datetime.datetime | datetime.timedelta | str | int=..., end_date: datetime.date | datetime.datetime | datetime.timedelta | str | int=..., precision: float | None=..., distrib: Callable[[datetime.datetime], float] | None=..., tzinfo: datetime.tzinfo | None=...) -> Iterator[tuple[datetime.datetime, Any]]

Actual signature for en_US:

fake.timeSeries(start_date: datetime.date | datetime.datetime | datetime.timedelta | str | int = '-30d', end_date: datetime.date | datetime.datetime | datetime.timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime.datetime], float] | None = None, tzinfo: datetime.tzinfo | None = None) -> Iterator[Tuple[datetime.datetime, Any]]
ParameterPurpose
start_dateStart boundary: date/time, relative interval or provider-supported format.
end_dateEnd date/time boundary or relative interval.
precisionTime-series point interval in seconds.
distribCallable computing a value for each datetime.
tzinfoTimezone for generated datetime; None uses native behavior.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = list(fake.timeSeries(start_date="-2d", end_date="now", precision=86400))

timezone generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def timezone() -> str

Actual signature for en_US:

fake.timezone() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.timezone()

tin generates fictional administrative or tax identifiers; format depends on country.

Orionis typed contract:

def tin() -> str

Actual signature for el_GR:

fake.tin() -> str

Verified availability: 1 locales. Example locales: el_GR.

fake = SampleFactory(locale="el_GR", seed=7).fake
value = fake.tin()

tld generates Internet addresses and formats for test data; generating a string does not open a connection.

Orionis typed contract:

def tld() -> str

Actual signature for en_US:

fake.tld() -> str

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.tld()

tollNumber generates fictional telephone numbers in local formats.

Orionis typed contract:

def tollNumber() -> str

Actual signature for ar_AE:

fake.tollNumber() -> str

Verified availability: 2 locales. Example locales: ar_AE, ar_PS.

fake = SampleFactory(locale="ar_AE", seed=7).fake
value = fake.tollNumber()

town generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def town() -> str

Actual signature for bn_BD:

fake.town() -> str

Verified availability: 4 locales. Example locales: bn_BD, en_BD, ja_JP, ko_KR.

fake = SampleFactory(locale="bn_BD", seed=7).fake
value = fake.town()

townSuffix generates addresses and geographic subdivisions for test forms, deliveries and profiles.

Orionis typed contract:

def townSuffix() -> str

Actual signature for ko_KR:

fake.townSuffix() -> str

Verified availability: 1 locales. Example locales: ko_KR.

fake = SampleFactory(locale="ko_KR", seed=7).fake
value = fake.townSuffix()

traditionalMonthName generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def traditionalMonthName() -> str

Actual signature for ja_JP:

fake.traditionalMonthName() -> str

Verified availability: 1 locales. Example locales: ja_JP.

fake = SampleFactory(locale="ja_JP", seed=7).fake
value = fake.traditionalMonthName()

tsv generates auxiliary test values and structures; return shape depends on the method.

Orionis typed contract:

def tsv(header: Sequence[str] | None=..., data_columns: tuple[str, str]=..., num_rows: int=..., include_row_ids: bool=...) -> str

Actual signature for en_US:

fake.tsv(header: Sequence[str] | None = None, data_columns: Tuple[str, str] = ('{{name}}', '{{address}}'), num_rows: int = 10, include_row_ids: bool = False) -> str
ParameterPurpose
headerColumn headings or None to omit them.
data_columnsStructure, column or generator-token definition.
num_rowsNumber of serialized data rows.
include_row_idsAdds a sequential row identifier.

Verified availability: 110 locales. Example locales: en_US, es_CO, es_ES, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ.

fake = SampleFactory(locale="en_US", seed=7).fake
value = fake.tsv(num_rows=2)