Skip to content

Add mk_MK (Macedonian) locale#2339

Open
acikabubo wants to merge 1 commit intojoke2k:masterfrom
acikabubo:add-mk-MK-locale
Open

Add mk_MK (Macedonian) locale#2339
acikabubo wants to merge 1 commit intojoke2k:masterfrom
acikabubo:add-mk-MK-locale

Conversation

@acikabubo
Copy link
Copy Markdown

Summary

  • Adds full mk_MK (Macedonian) locale support with 15 providers covering address, automotive, bank, color, company, currency, date_time, geo, internet, job, lorem, passport, person, phone_number, and SSN (EMBG)
  • All data sourced from authoritative references (Wikipedia, OpenStreetMap, NBRM, official vehicle registration tables)
  • 25 new tests added across all provider test files; all pass

Providers added

Provider Highlights
address 195 countries, all cities, Skopje street names from OSM
automotive XX NNNN YY format, all 34 official regional codes (Wikipedia)
bank MK IBAN country code, 14 real banks (Wikipedia list)
color 40 color names in Macedonian Cyrillic
company Macedonian legal suffixes (АД, ДОО, ДООЕЛ…)
currency Currency names in Macedonian
date_time Month and day names in Macedonian
geo Coordinates bounded to North Macedonia's geographic extent
internet .mk TLD, Cyrillic→ASCII transliteration for usernames
job 72 job titles in Macedonian
lorem 200+ common Macedonian words
passport Macedonian passport number format
person Male/female first/last names with correct gender suffixes
phone_number Mobile (07x) and Skopje landline (02) formats
ssn EMBG (13-digit) with MOD-11 checksum validation

Test plan

  • make lint (flake8, black, isort) — clean
  • mypy — no errors (724 source files)
  • 25 TestMkMk tests — all pass

Adds 15 providers for the mk_MK locale:
- address: cities, streets, regions, postal codes, countries (195 countries)
- automotive: license plates in XX NNNN YY format with all 34 official regional codes
- bank: IBAN with MK country code, 14 real Macedonian banks
- color: 40 color names in Macedonian Cyrillic
- company: company names with Macedonian legal suffixes (АД, ДОО, ДООЕЛ…)
- currency: currency names in Macedonian
- date_time: month and day names in Macedonian
- geo: coordinates bounded to North Macedonia's geographic extent
- internet: emails with .mk TLD, Cyrillic→ASCII transliteration
- job: 72 job titles in Macedonian
- lorem: 200+ common Macedonian words
- passport: Macedonian passport number format
- person: male/female first/last names with gender suffixes
- phone_number: Macedonian mobile and landline formats
- ssn: EMBG (13-digit national ID) with MOD-11 checksum


class Provider(PersonProvider):
"""Person provider for mk_MK locale (Macedonian)."""
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you have an authoritive source for these names?

Copy link
Copy Markdown
Author

@acikabubo acikabubo Mar 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the State Statistical Office page: https://www.stat.gov.mk/Iminja_Preziminja.aspx
. On this page you can find how many people have the given name or surname. Alternatively, this page may also be useful: https://www.behindthename.com/names/usage/macedonian
. If that’s OK, I can update the class docstring with one of these links.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants