Locales

The Mimesis supports multiple locales. This means that you can generate data in different languages and for different countries.

The default locale for all providers is English (United States) (Locale.EN).

You have to import Locale object first, like this:

from mimesis.locales import Locale

Now you can specify a locale when creating providers and they will return data that is appropriate for the language or country associated with that locale:

from mimesis import Address
from mimesis.locales import Locale

de = Address(locale=Locale.DE)
ru = Address(locale=Locale.RU)

de.region()
# Output: 'Brandenburg'

ru.federal_subject()
# Output: 'Алтайский край'

de.address()
# Output: 'Mainzer Landstraße 912'

ru.address()
# Output: 'ул. Пехотная 125'

See the table below for more details.

Overriding locale

Sometimes you need only some data from other locale and creating an instance for such cases is not really good, so it’s better just temporarily override current locale for provider’s instance:

from mimesis import Person
from mimesis.locales import Locale

person = Person(locale=Locale.EN)
person.full_name()
# Output: 'Ozie Melton'

with person.override_locale(Locale.RU):
    person.full_name()

# Output: 'Симона Богданова'

person.full_name()
# Output: 'Waldo Foster'

You can also use it with Generic():

from mimesis import Generic
from mimesis.locales import Locale

generic = Generic(locale=Locale.EN)
generic.text.word()
# Output: 'anyone'

with generic.text.override_locale(Locale.FR):
    generic.text.word()

# Output: 'mieux'

generic.text.word()
# Output: 'responsibilities'

Supported locales

Mimesis currently includes support for 35 different locales:

Code	Associated attribute	Name	Native Name
cs	Locale.CS	Czech	Česky
da	Locale.DA	Danish	Dansk
de	Locale.DE	German	Deutsch
de-at	Locale.DE_AT	Austrian german	Deutsch
de-ch	Locale.DE_CH	Swiss german	Deutsch
el	Locale.EL	Greek	Ελληνικά
en	Locale.EN	English	English
en-au	Locale.EN_AU	Australian English	English
en-ca	LocALE.EN_CA	Canadian English	English
en-gb	Locale.EN_GB	British English	English
es	Locale.ES	Spanish	Español
es-mx	Locale.ES_MX	Mexican Spanish	Español
et	Locale.ET	Estonian	Eesti
fa	Locale.FA	Farsi	فارسی
fi	Locale.FI	Finnish	Suomi
fr	Locale.FR	French	Français
hr	Locale.HR	Croatian	Hrvatski
hu	Locale.HU	Hungarian	Magyar
is	Locale.IS	Icelandic	Íslenska
it	Locale.IT	Italian	Italiano
ja	Locale.JA	Japanese	日本語
kk	Locale.KK	Kazakh	Қазақша
ko	Locale.KO	Korean	한국어
nl	Locale.NL	Dutch	Nederlands
nl-be	Locale.NL_BE	Belgium Dutch	Nederlands
no	Locale.NO	Norwegian	Norsk
pl	Locale.PL	Polish	Polski
pt	Locale.PT	Portuguese	Português
pt-br	Locale.PT_BR	Brazilian Portuguese	Português Brasileiro
ru	Locale.RU	Russian	Русский
sk	Locale.SK	Slovak	Slovensky
sv	Locale.SV	Swedish	Svenska
tr	Locale.TR	Turkish	Türkçe
uk	Locale.UK	Ukrainian	Українська
zh	Locale.ZH	Chinese	汉语