diff options
Diffstat (limited to 'venv/lib/python3.11/site-packages/faker/providers/address/ko_KR')
2 files changed, 605 insertions, 0 deletions
diff --git a/venv/lib/python3.11/site-packages/faker/providers/address/ko_KR/__init__.py b/venv/lib/python3.11/site-packages/faker/providers/address/ko_KR/__init__.py new file mode 100644 index 0000000..33af0b8 --- /dev/null +++ b/venv/lib/python3.11/site-packages/faker/providers/address/ko_KR/__init__.py @@ -0,0 +1,605 @@ +import string + +from .. import Provider as AddressProvider + +ALPHABET = string.ascii_uppercase + + +class Provider(AddressProvider): + """ + Korean Address Provider + ======================= + + Korea has two address and postal code system. + + Address: + - Address based on land parcel numbers + (지번 주소, OLD, but someone use consistently) + - Address based on road names and building numbers (도로명 주소, NEW) + + :meth:`land_address` generate Address based on land parcel numbers and + :meth:`road_address` generate Address based on road names and building + numbers. + + Postal code: + - Old postal code (6-digit, OLD and dead) + - New postal code (5-digit, New) + + :meth:`old_postal_code` and :meth:`postcode` generate old 6-digit code + and :meth:`postal_code` generate newer 5-digit code. + + Reference: + - `Official Confirmation Prividing that Old and New Addresses are Identical`__ + (warn: cert error) + + __ https://www.juso.go.kr/addridentity/AddrIdentityHelp.htm + + """ + + building_suffixes = ( + "빌라", + "아파트", + "연립", + "마을", + "타운", + "타워", + ) + road_suffixes = ("로", "길", "거리", "가") + town_suffixes = ("동", "읍", "면", "리", "마을") + postcode_formats = ("###-###",) + new_postal_code_formats = ("#####",) + metropolitan_cities = ( + "서울특별시", + "부산광역시", + "대구광역시", + "인천광역시", + "광주광역시", + "대전광역시", + "울산광역시", + "세종특별자치시", + ) + provinces = ( + "경기도", + "강원도", + "충청북도", + "충청남도", + "전라북도", + "전라남도", + "경상북도", + "경상남도", + "제주특별자치도", + ) + cities = ( + "파주시", + "수원시", + "수원시 권선구", + "수원시 팔달구", + "수원시 영통구", + "성남시", + "성남시 수정구", + "성남시 중원구", + "화성시", + "성남시 분당구", + "안양시", + "안양시 만안구", + "안양시 동안구", + "부천시", + "부천시 원미구", + "부천시 소사구", + "부천시 오정구", + "광명시", + "평택시", + "이천시", + "동두천시", + "안산시", + "안산시 상록구", + "안산시 단원구", + "안성시", + "고양시", + "고양시 덕양구", + "고양시 일산동구", + "고양시 일산서구", + "과천시", + "구리시", + "남양주시", + "오산시", + "시흥시", + "군포시", + "의왕시", + "하남시", + "김포시", + "용인시", + "용인시 처인구", + "용인시 기흥구", + "용인시 수지구", + "연천군", + "가평군", + "양평군", + "광주시", + "포천시", + "양주시", + "수원시 장안구", + "의정부시", + "여주시", + "춘천시", + "원주시", + "강릉시", + "동해시", + "태백시", + "속초시", + "삼척시", + "홍천군", + "횡성군", + "영월군", + "평창군", + "정선군", + "철원군", + "화천군", + "양구군", + "인제군", + "고성군", + "양양군", + "천안시 동남구", + "천안시 서북구", + "공주시", + "보령시", + "아산시", + "서산시", + "논산시", + "계룡시", + "당진시", + "금산군", + "부여군", + "서천군", + "청양군", + "홍성군", + "예산군", + "태안군", + "청주시 상당구", + "청주시 서원구", + "청주시 흥덕구", + "청주시 청원구", + "충주시", + "제천시", + "보은군", + "옥천군", + "영동군", + "증평군", + "진천군", + "괴산군", + "음성군", + "단양군", + ) + road_names = ( + "압구정", + "도산대", + "학동", + "봉은사", + "테헤란", + "역삼", + "논현", + "언주", + "강남대", + "양재천", + "삼성", + "영동대", + "개포", + "선릉", + "반포대", + "서초중앙", + "서초대", + "잠실", + "석촌호수", + "백제고분", + "가락", + "오금", + ) + boroughs = ( + "종로구", + "중구", + "용산구", + "성동구", + "광진구", + "동대문구", + "중랑구", + "성북구", + "강북구", + "도봉구", + "노원구", + "은평구", + "서대문구", + "마포구", + "양천구", + "강서구", + "구로구", + "금천구", + "영등포구", + "동작구", + "관악구", + "서초구", + "강남구", + "송파구", + "강동구", + "동구", + "서구", + "남구", + "북구", + ) + countries = ( + "가나", + "가봉", + "가이아나", + "감비아", + "과테말라", + "그레나다", + "그리스", + "기니", + "기니비사우", + "나미비아", + "나우루", + "나이지리아", + "남수단", + "남아프리카 공화국", + "네덜란드 왕국", + "네팔", + "노르웨이", + "뉴질랜드", + "니제르", + "니카라과", + "대한민국", + "덴마크", + "도미니카 공화국", + "도미니카 연방", + "독일", + "동티모르", + "라오스", + "라이베리아", + "라트비아", + "러시아", + "레바논", + "레소토", + "루마니아", + "룩셈부르크", + "르완다", + "리비아", + "리투아니아", + "리히텐슈타인", + "마다가스카르", + "마셜 제도", + "북마케도니아 공화국", + "말라위", + "말레이시아", + "말리", + "멕시코", + "모나코", + "모로코", + "모리셔스", + "모리타니", + "모잠비크", + "몬테네그로", + "몰도바", + "몰디브", + "몰타", + "몽골", + "미국", + "미얀마", + "미크로네시아 연방", + "바누아투", + "바레인", + "바베이도스", + "바하마", + "방글라데시", + "베냉", + "베네수엘라", + "베트남", + "벨기에", + "벨라루스", + "벨리즈", + "보스니아 헤르체고비나", + "보츠와나", + "볼리비아", + "부룬디", + "부르키나파소", + "부탄", + "불가리아", + "브라질", + "브루나이", + "사모아", + "사우디아라비아", + "산마리노", + "상투메 프린시페", + "세네갈", + "세르비아", + "세이셸", + "세인트루시아", + "세인트빈센트 그레나딘", + "세인트키츠 네비스", + "소말리아", + "솔로몬 제도", + "수단", + "수리남", + "스리랑카", + "스와질란드", + "스웨덴", + "스위스", + "스페인", + "슬로바키아", + "슬로베니아", + "시리아", + "시에라리온 공화국", + "싱가포르", + "아랍에미리트", + "아르메니아", + "아르헨티나", + "아이슬란드", + "아이티", + "아일랜드", + "아제르바이잔", + "아프가니스탄", + "안도라", + "알바니아", + "알제리", + "앙골라", + "앤티가 바부다", + "에리트레아", + "에스토니아", + "에콰도르", + "에티오피아", + "엘살바도르", + "영국", + "예멘", + "오만", + "오스트레일리아", + "오스트리아", + "온두라스", + "요르단", + "우간다", + "우루과이", + "우즈베키스탄", + "우크라이나", + "이라크", + "이란", + "이스라엘", + "이집트", + "이탈리아", + "인도네시아", + "일본", + "자메이카", + "잠비아", + "적도 기니", + "조선민주주의인민공화국", + "조지아", + "중앙아프리카 공화국", + "중화인민공화국", + "지부티", + "짐바브웨", + "차드", + "체코", + "칠레", + "카메룬", + "카보베르데", + "카자흐스탄", + "카타르", + "캄보디아", + "캐나다", + "케냐", + "코모로", + "코스타리카", + "코트디부아르", + "콜롬비아", + "콩고 공화국", + "콩고 민주 공화국", + "쿠바", + "쿠웨이트", + "크로아티아", + "키르기스스탄", + "키리바시", + "키프로스", + "타이", + "타지키스탄", + "탄자니아", + "터키", + "토고", + "통가", + "투르크메니스탄", + "투발루", + "튀니지", + "트리니다드 토바고", + "파나마", + "파라과이", + "파키스탄", + "파푸아 뉴기니", + "팔라우", + "페루", + "포르투갈", + "폴란드", + "프랑스", + "피지", + "핀란드", + "필리핀", + "헝가리", + ) + building_dongs = ( + "가", + "나", + "다", + "라", + "마", + "바", + "##", + "###", + ) + tuple(ALPHABET) + land_numbers = ( + "###", + "###-#", + "###-##", + ) + road_numbers = ( + "#", + "##", + "###", + ) + + town_formats = ( + "{{first_name}}{{last_name}}{{town_suffix}}", + "{{first_name}}{{last_name}}{{last_name}}{{town_suffix}}", + ) + building_name_formats = ( + "{{first_name}}{{last_name}}{{building_suffix}}", + "{{first_name}}{{last_name}}{{last_name}}{{building_suffix}}", + ) + address_detail_formats = ( + "{{building_name}}", + "{{building_name}} ###호", + "{{building_name}} {{building_dong}}동 ###호", + ) + road_formats = ( + "{{road_name}}{{road_suffix}}", + "{{road_name}}{{road_number}}{{road_suffix}}", + ) + road_address_formats = ( + "{{metropolitan_city}} {{borough}} {{road}}", + "{{province}} {{city}} {{road}}", + "{{metropolitan_city}} {{borough}} {{road}} ({{town}})", + "{{province}} {{city}} {{road}} ({{town}})", + ) + land_address_formats = ( + "{{metropolitan_city}} {{borough}} {{town}} {{land_number}}", + "{{province}} {{city}} {{town}} {{land_number}}", + ) + + # Keep backward compatibility + city_suffixes = ("시",) + street_suffixes = road_suffixes + street_name_formats = ("{{road_name}}",) + street_address_formats = road_address_formats + address_formats = road_address_formats + + def land_number(self) -> str: + """ + :example: 507 + """ + return self.bothify(self.random_element(self.land_numbers)) + + def land_address(self) -> str: + """ + :example: 세종특별자치시 어진동 507 + """ + pattern: str = self.random_element(self.land_address_formats) + return self.generator.parse(pattern) + + def road_number(self) -> str: + """ + :example: 24 + """ + return self.bothify(self.random_element(self.road_numbers)) + + def road_address(self) -> str: + """ + :example: 세종특별자치시 도움5로 19 (어진동) + """ + pattern: str = self.random_element(self.road_address_formats) + return self.generator.parse(pattern) + + def address_detail(self) -> str: + """ + :example: 가나아파트 가동 102호 + """ + pattern: str = self.bothify(self.random_element(self.address_detail_formats)) + return self.generator.parse(pattern) + + def road(self) -> str: + """ + :example: 도움5로 + """ + pattern: str = self.random_element(self.road_formats) + return self.generator.parse(pattern) + + def road_name(self) -> str: + """ + :example: 압구정 + """ + return self.random_element(self.road_names) + + def road_suffix(self) -> str: + """ + :example: 길 + """ + return self.random_element(self.road_suffixes) + + def metropolitan_city(self) -> str: + """ + :example: 서울특별시 + """ + return self.random_element(self.metropolitan_cities) + + def administrative_unit(self) -> str: + """ + :example: 경기도 + """ + return self.random_element(self.provinces) + + province = administrative_unit + + def city(self) -> str: + """ + :example: 고양시 + """ + pattern: str = self.random_element(self.cities) + return self.generator.parse(pattern) + + def borough(self) -> str: + """ + :example: 중구 + """ + return self.random_element(self.boroughs) + + def town(self) -> str: + """ + :example: 가나동 + """ + pattern: str = self.random_element(self.town_formats) + return self.generator.parse(pattern) + + def town_suffix(self) -> str: + """ + :example: 동 + """ + return self.random_element(self.town_suffixes) + + def building_name(self) -> str: + """ + :example: 김구아파트 + """ + pattern: str = self.random_element(self.building_name_formats) + return self.generator.parse(pattern) + + def building_suffix(self) -> str: + """ + :example: 아파트 + """ + return self.random_element(self.building_suffixes) + + def building_dong(self) -> str: + """ + :example: 가 + """ + return self.bothify(self.random_element(self.building_dongs)) + + def old_postal_code(self) -> str: + """ + :example: 123-456 + """ + return self.bothify(self.random_element(self.postcode_formats)) + + def postcode(self) -> str: + """ + :example: 12345 + """ + return self.bothify(self.random_element(self.new_postal_code_formats)) + + def postal_code(self) -> str: + """ + :example: 12345 + """ + return self.postcode() diff --git a/venv/lib/python3.11/site-packages/faker/providers/address/ko_KR/__pycache__/__init__.cpython-311.pyc b/venv/lib/python3.11/site-packages/faker/providers/address/ko_KR/__pycache__/__init__.cpython-311.pyc Binary files differnew file mode 100644 index 0000000..eef5fc4 --- /dev/null +++ b/venv/lib/python3.11/site-packages/faker/providers/address/ko_KR/__pycache__/__init__.cpython-311.pyc |