Skip to content

Faker: providers U–Z

This reference covers 43 facade names in the U-Z 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

uid generates company names and expressions for test entities.

Orionis typed contract:

def uid() -> str

Actual signature for fr_CH:

fake.uid() -> str

Verified availability: 1 locales. Example locales: fr_CH.

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

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

Orionis typed contract:

def umid() -> str

Actual signature for en_PH:

fake.umid() -> str

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

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

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

Orionis typed contract:

def unionTerritory() -> str

Actual signature for en_IN:

fake.unionTerritory() -> str

Verified availability: 1 locales. Example locales: en_IN.

fake = SampleFactory(locale="en_IN", seed=7).fake
value = fake.unionTerritory()

unixDevice generates fictional filenames, paths and media types; it does not create files on disk.

Orionis typed contract:

def unixDevice(prefix: str | None=...) -> str

Actual signature for en_US:

fake.unixDevice(prefix: str | None = None) -> str
ParameterPurpose
prefixGenerated string prefix.

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.unixDevice()

unixPartition generates fictional filenames, paths and media types; it does not create files on disk.

Orionis typed contract:

def unixPartition(prefix: str | None=...) -> str

Actual signature for en_US:

fake.unixPartition(prefix: str | None = None) -> str
ParameterPurpose
prefixGenerated string prefix.

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.unixPartition()

unixTime generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def unixTime(end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None=..., start_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None=...) -> float

Actual signature for en_US:

fake.unixTime(end_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None, start_datetime: datetime.date | datetime.datetime | datetime.timedelta | str | int | None = None) -> float
ParameterPurpose
end_datetimeEnding datetime interval boundary.
start_datetimeStarting 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.unixTime()

upcA generates product codes and check digits for test catalogs.

Orionis typed contract:

def upcA(upc_ae_mode: bool=..., base: str | None=..., number_system_digit: int | None=...) -> str

Actual signature for en_US:

fake.upcA(upc_ae_mode: bool = False, base: str | None = None, number_system_digit: int | None = None) -> str
ParameterPurpose
upc_ae_modeGenerates UPC-A with a UPC-E equivalent, enabling base and number_system_digit.
baseSix-digit base for UPC-A/UPC-E conversion; unsupported values may generate another base.
number_system_digitUPC number-system digit: 0 or 1.

Verified availability: 107 locales. Example locales: en_US, es_CO, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ, ar_EG.

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

upcE generates product codes and check digits for test catalogs.

Orionis typed contract:

def upcE(base: str | None=..., number_system_digit: int | None=..., safe_mode: bool=...) -> str

Actual signature for en_US:

fake.upcE(base: str | None = None, number_system_digit: int | None = None, safe_mode: bool = True) -> str
ParameterPurpose
baseSix-digit base for UPC-A/UPC-E conversion; unsupported values may generate another base.
number_system_digitUPC number-system digit: 0 or 1.
safe_modeRequires reversible UPC-E to UPC-A conversion and back.

Verified availability: 107 locales. Example locales: en_US, es_CO, am_ET, ar_AA, ar_AE, ar_BH, ar_DZ, ar_EG.

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

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

Orionis typed contract:

def uri(schemes: list[str] | None=..., deep: int | None=...) -> str

Actual signature for en_US:

fake.uri(schemes: List[str] | None = None, deep: int | None = None) -> str
ParameterPurpose
schemesPermitted URL schemes.
deepURI path segment depth.

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.uri()

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

Orionis typed contract:

def uriExtension() -> str

Actual signature for en_US:

fake.uriExtension() -> 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.uriExtension()

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

Orionis typed contract:

def uriPage() -> str

Actual signature for en_US:

fake.uriPage() -> 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.uriPage()

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

Orionis typed contract:

def uriPath(deep: int | None=...) -> str

Actual signature for en_US:

fake.uriPath(deep: int | None = None) -> str
ParameterPurpose
deepURI path segment depth.

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.uriPath()

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

Orionis typed contract:

def url(schemes: list[str] | None=...) -> str

Actual signature for en_US:

fake.url(schemes: List[str] | None = None) -> str
ParameterPurpose
schemesPermitted URL schemes.

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.url()

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

Orionis typed contract:

def userAgent() -> str

Actual signature for en_US:

fake.userAgent() -> 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.userAgent()

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

Orionis typed contract:

def userName() -> str

Actual signature for en_US:

fake.userName() -> 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.userName()

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

Orionis typed contract:

def uuid1() -> str
def uuid1(cast_to: None) -> UUID
def uuid1(cast_to: Callable[[UUID], str]) -> str
def uuid1(cast_to: Callable[[UUID], bytes]) -> bytes

Actual signature for en_US:

fake.uuid1(cast_to: Callable[[uuid.UUID], str] | Callable[[uuid.UUID], bytes] | None = <class 'str'>) -> bytes | str | uuid.UUID
ParameterPurpose
cast_toFinal UUID representation type, such as str or UUID.

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.uuid1()

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

Orionis typed contract:

def uuid4() -> str
def uuid4(cast_to: None) -> UUID
def uuid4(cast_to: Callable[[UUID], str]) -> str
def uuid4(cast_to: Callable[[UUID], bytes]) -> bytes

Actual signature for en_US:

fake.uuid4(cast_to: Callable[[uuid.UUID], str] | Callable[[uuid.UUID], bytes] | None = <class 'str'>) -> bytes | str | uuid.UUID
ParameterPurpose
cast_toFinal UUID representation type, such as str or UUID.

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.uuid4()

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

Orionis typed contract:

def uuid7() -> str
def uuid7(cast_to: None) -> UUID
def uuid7(cast_to: Callable[[UUID], str]) -> str
def uuid7(cast_to: Callable[[UUID], bytes]) -> bytes

Actual signature for en_US:

fake.uuid7(cast_to: Callable[[uuid.UUID], str] | Callable[[uuid.UUID], bytes] | None = <class 'str'>) -> bytes | str | uuid.UUID
ParameterPurpose
cast_toFinal UUID representation type, such as str or UUID.

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.uuid7()

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

Orionis typed contract:

def vatId() -> str

Actual signature for es_ES:

fake.vatId() -> str
ParameterPurpose
prefixGenerated string prefix.

Actual locale variants:

bg_BG, cs_CZ, de, de_AT, de_CH, de_DE and 28 more:

fake.vatId() -> str

el_GR:

fake.vatId(prefix: bool = True) -> str

Verified availability: 35 locales. Example locales: es_ES, bg_BG, cs_CZ, de, de_AT, de_CH, de_DE, dk_DK.

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

vehicleCategory generates vehicle plates and identifiers for examples and fixtures.

Orionis typed contract:

def vehicleCategory() -> str

Actual signature for ru_RU:

fake.vehicleCategory() -> str

Verified availability: 2 locales. Example locales: ru_RU, uk_UA.

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

vehicleCategoryLetter generates vehicle plates and identifiers for examples and fixtures.

Orionis typed contract:

def vehicleCategoryLetter() -> str

Actual signature for bn_BD:

fake.vehicleCategoryLetter() -> str

Verified availability: 1 locales. Example locales: bn_BD.

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

vehicleCategoryNumber generates vehicle plates and identifiers for examples and fixtures.

Orionis typed contract:

def vehicleCategoryNumber() -> str

Actual signature for bn_BD:

fake.vehicleCategoryNumber() -> str

Verified availability: 1 locales. Example locales: bn_BD.

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

vehicleSerialNumber generates vehicle plates and identifiers for examples and fixtures.

Orionis typed contract:

def vehicleSerialNumber() -> str

Actual signature for bn_BD:

fake.vehicleSerialNumber() -> str

Verified availability: 1 locales. Example locales: bn_BD.

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

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

Orionis typed contract:

def viBuildingNumberFormat() -> str

Actual signature for vi_VN:

fake.viBuildingNumberFormat() -> str

Verified availability: 1 locales. Example locales: vi_VN.

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

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

Orionis typed contract:

def village() -> str

Actual signature for az_AZ:

fake.village() -> str

Verified availability: 2 locales. Example locales: az_AZ, hy_AM.

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

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

Orionis typed contract:

def villagePrefix() -> str

Actual signature for hy_AM:

fake.villagePrefix() -> str

Verified availability: 1 locales. Example locales: hy_AM.

fake = SampleFactory(locale="hy_AM", seed=7).fake
value = fake.villagePrefix()

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

Orionis typed contract:

def villageSuffix() -> str

Actual signature for az_AZ:

fake.villageSuffix() -> str

Verified availability: 1 locales. Example locales: az_AZ.

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

vin generates vehicle plates and identifiers for examples and fixtures.

Orionis typed contract:

def vin() -> str

Actual signature for en_US:

fake.vin() -> 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.vin()

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

Orionis typed contract:

def visayasProvince() -> str

Actual signature for en_PH:

fake.visayasProvince() -> str

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

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

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

Orionis typed contract:

def visayasProvinceAddress() -> str

Actual signature for en_PH:

fake.visayasProvinceAddress() -> str

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

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

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

Orionis typed contract:

def visayasProvincePostcode() -> str

Actual signature for en_PH:

fake.visayasProvincePostcode() -> str

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

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

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

Orionis typed contract:

def wilaya() -> str

Actual signature for ar_DZ:

fake.wilaya() -> str

Verified availability: 2 locales. Example locales: ar_DZ, fr_DZ.

fake = SampleFactory(locale="ar_DZ", seed=7).fake
value = fake.wilaya()

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

Orionis typed contract:

def windowsPlatformToken() -> str

Actual signature for en_US:

fake.windowsPlatformToken() -> 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.windowsPlatformToken()

word generates placeholder text for content and forms.

Orionis typed contract:

def word(part_of_speech: str | None=..., ext_word_list: Sequence[str] | None=...) -> str

Actual signature for en_US:

fake.word(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) -> str
ParameterPurpose
part_of_speechVocabulary grammatical category where supported by the locale.
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.word()

words generates placeholder text for content and forms.

Orionis typed contract:

def words(nb: int=..., ext_word_list: list[str] | None=..., part_of_speech: str | None=..., unique: bool=...) -> list[str]

Actual signature for en_US:

fake.words(nb: int = 3, ext_word_list: List[str] | None = None, part_of_speech: str | None = None, unique: bool = False) -> List[str]
ParameterPurpose
nbRequested result count.
ext_word_listAlternative vocabulary or None for native data.
part_of_speechVocabulary grammatical category where supported by the locale.
uniqueRequests nonrepeating selections within this call.

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.words()

Generates XML text and requires xmltodict. Without that dependency it raises faker.exceptions.UnsupportedFeature. Use nb_elements and permitted types to control structure.

Orionis typed contract:

def xml(nb_elements: int=..., variable_nb_elements: bool=..., value_types: list[type] | tuple[type, ...] | None=..., allowed_types: list[type] | tuple[type, ...] | None=...) -> str

Actual signature for en_US:

fake.xml(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) -> str
ParameterPurpose
nb_elementsNumber of elements to generate.
variable_nb_elementsAllows count variation around its target.
value_typesPython types of generated values.
allowed_typesPython types the container may select.

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

The example handles a missing dependency; install Pillow for images or xmltodict for XML in the environment using that provider.

from faker.exceptions import UnsupportedFeature
fake = SampleFactory(locale="en_US", seed=7).fake
try:
value = fake.xml(nb_elements=2)
except UnsupportedFeature:
value = None

year generates dates, times and intervals for temporal fixtures.

Orionis typed contract:

def year() -> str

Actual signature for en_US:

fake.year() -> 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.year()

Generates ZIP archive bytes in memory. Does not write a file; num_files, min_file_size and uncompressed_size must be positive and compatible.

Orionis typed contract:

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

Actual signature for en_US:

fake.zip(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.zip(uncompressed_size=128, min_file_size=64, num_files=1)

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

Orionis typed contract:

def zipcode() -> str

Actual signature for en_US:

fake.zipcode() -> str

Verified availability: 47 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.zipcode()

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

Orionis typed contract:

def zipcodeInArmy() -> int

Actual signature for en_IN:

fake.zipcodeInArmy() -> int

Verified availability: 1 locales. Example locales: en_IN.

fake = SampleFactory(locale="en_IN", seed=7).fake
value = fake.zipcodeInArmy()

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

Orionis typed contract:

def zipcodeInMilitary() -> int

Actual signature for en_IN:

fake.zipcodeInMilitary() -> int

Verified availability: 1 locales. Example locales: en_IN.

fake = SampleFactory(locale="en_IN", seed=7).fake
value = fake.zipcodeInMilitary()

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

Orionis typed contract:

def zipcodeInState(state_abbr: str | None=...) -> str

Actual signature for en_US:

fake.zipcodeInState(state_abbr: str | None = None) -> str
ParameterPurpose
state_abbrState abbreviation restricting localized output.
include_union_territoriesIncludes Indian Union Territories in postal codes.

Actual locale variants:

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

fake.zipcodeInState(state_abbr: str | None = None) -> str

en_IN:

fake.zipcodeInState(state_abbr: str | None = None, include_union_territories: bool = False) -> int

Verified availability: 46 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.zipcodeInState()

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

Orionis typed contract:

def zipcodePlus4() -> str

Actual signature for en_US:

fake.zipcodePlus4() -> str

Verified availability: 45 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.zipcodePlus4()